Cómo instalar módulos en PrestaShop manualmente

¿Cansado de depender del market oficial o de tener problemas con la descarga automática de módulos en tu tienda PrestaShop? Instalar módulos manualmente es una habilidad esencial que te dará control total sobre tu tienda online. Ya sea para añadir un plugin de pago, un constructor de páginas o una herramienta de SEO, saber cómo hacerlo paso a paso te ahorrará dolores de cabeza. En esta guía extensa y súper detallada, te explicaré todo lo que necesitas saber para instalar módulos PrestaShop manualmente, incluso si no tienes experiencia técnica.

Vamos a desglosar el proceso en partes muy claras, desde la preparación hasta la solución de los errores más comunes. Al final de este artículo, serás capaz de añadir módulo PrestaShop sin depender de nadie.

¿Qué es un módulo de PrestaShop y por qué instalarlo manualmente?

Un módulo en PrestaShop es como una aplicación para tu móvil, pero para tu tienda online. Añade funciones nuevas: desde mejorar la velocidad, añadir un chat en vivo, hasta conectar con pasarelas de pago.

¿Por qué instalarlo manualmente? Hay varias razones:

• Control total: Tú decides qué versión y de qué fuente.
• Solución de problemas: Si la instalación automática falla, la manual es tu plan B.
• Módulos personalizados: Si un desarrollador te crea un módulo a medida, te lo enviará en un archivo ZIP.
• Sin dependencia del market: Algunos módulos no están en el market oficial de PrestaShop.

[INFO] Instalar manualmente no es más difícil que subir una foto a tu galería. Solo necesitas un archivo ZIP y acceso a tu panel de administración.

Requisitos previos antes de empezar

Antes de lanzarte a instalar módulos PrestaShop, asegúrate de tener todo listo:

Lo que necesitas:

1. Archivo del módulo: Debe ser un archivo .zip que contenga la carpeta del módulo. No lo descomprimas.
2. Acceso al panel de administración de PrestaShop: Las credenciales de tu tienda (usuario y contraseña de administrador).
3. Acceso al servidor (opcional pero útil): Si tienes acceso a tu hosting, por ejemplo, a través de un panel como cPanel o Syspanel (recuerda, el puerto es el 2106), podrás subir archivos directamente. Esto es útil si el panel de administración falla.
4. Permisos de escritura: El servidor debe permitir que PrestaShop escriba en la carpeta /modules. Si no, tendrás que ajustar permisos (más adelante te explico).

[WARNING] Nunca descargues módulos de sitios piratas o dudosos. Pueden contener malware que robe datos de tus clientes. Siempre usa fuentes oficiales o de desarrolladores de confianza.

Método 1: Instalación manual desde el panel de administración (el más fácil)

Este es el método que usamos el 90% de las veces. Es rápido y no requiere tocar archivos del servidor.

Paso 1: Accede a la sección de módulos

1. Inicia sesión en tu panel de administración de PrestaShop (normalmente tudominio.com/adminXXXX).
2. En el menú lateral izquierdo, busca Módulos y haz clic en Módulos y servicios.
3. Verás una lista de módulos instalados. Arriba a la derecha, hay un botón azul que dice Subir un módulo. ¡Ese es!

Paso 2: Sube el archivo ZIP

1. Haz clic en Subir un módulo.
2. Se abrirá una ventana. Arrastra el archivo .zip del módulo que descargaste, o haz clic en el área para seleccionarlo desde tu computadora.
3. Espera unos segundos mientras PrestaShop lo procesa. Verás una barra de progreso.

Paso 3: Instala el módulo

• Una vez subido, el módulo aparecerá en la lista. Busca su nombre.
• A la derecha, verás un botón Instalar. Haz clic.
• PrestaShop te preguntará si quieres instalar el módulo. Dale a Sí o Continuar.
• Dependiendo del módulo, puede pedirte configurar algunos ajustes básicos. Si es así, sigue las instrucciones en pantalla.

Paso 4: ¡Listo!

• Verás un mensaje de éxito. El módulo ahora está activo y listo para usar.
• Normalmente aparecerá un nuevo elemento en el menú izquierdo con el nombre del módulo o en la configuración de módulos.

[TIP] Si el módulo no aparece después de subirlo, verifica que el archivo ZIP no esté dañado o que no tenga una estructura incorrecta (debe contener una carpeta con el nombre del módulo y dentro los archivos PHP).

Método 2: Instalación manual subiendo archivos por FTP o panel de hosting (más técnico)

Este método es útil cuando el panel de administración no te permite subir módulos (por error de tamaño, permisos, etc.). También es la forma de instalar módulos PrestaShop manualmente cuando el módulo viene en una carpeta descomprimida.

Paso 1: Prepara el módulo

1. Descomprime el archivo .zip en tu computadora. Verás una carpeta con el nombre del módulo (ej: micodigo).
2. Asegúrate de que la carpeta contenga archivos como index.php, micodigo.php, etc.

Paso 2: Conéctate a tu servidor

• Usa un cliente FTP como FileZilla, o accede al administrador de archivos de tu hosting.
• Si usas Syspanel (puerto 2106), inicia sesión y busca la opción "Administrador de archivos" o "FTP".

Paso 3: Sube la carpeta del módulo

1. Navega hasta la carpeta raíz de tu tienda PrestaShop. Normalmente se llama public_html o www.
2. Dentro, busca la carpeta modules (está en el mismo nivel que img, themes, etc.).
3. Arrastra la carpeta del módulo (la que descomprimiste) desde tu computadora a la carpeta modules del servidor.
4. Espera a que se complete la subida.

Paso 4: Instala desde el panel de administración

1. Vuelve a tu panel de administración de PrestaShop.
2. Ve a Módulos > Módulos y servicios.
3. Busca el módulo en la lista (debería aparecer automáticamente). Si no, haz clic en el botón Actualizar (icono de flecha circular) arriba a la derecha.
4. Haz clic en Instalar y sigue los pasos.

[WARNING] Asegúrate de que los permisos de la carpeta del módulo sean 755 (lectura y ejecución) y los archivos 644. Si no, PrestaShop no podrá leerlos. En Syspanel o cPanel puedes cambiar permisos fácilmente.

Solución de problemas comunes al instalar módulos PrestaShop manualmente

A veces las cosas no salen a la primera. No te preocupes, aquí tienes los errores más frecuentes y cómo solucionarlos.

Error 1: "No se puede cargar el módulo" o "El archivo no es válido"

• Causa: El ZIP está corrupto o no es un módulo válido.
• Solución: Descarga el módulo de nuevo desde la fuente oficial. Verifica que el archivo termine en .zip y no en .rar o .tar.gz.

Error 2: "Error al subir el archivo: tamaño máximo excedido"

• Causa: El archivo ZIP pesa más de lo que permite tu servidor (generalmente 2MB, 8MB o 20MB).
• Solución:
  • Usa el Método 2 (subir por FTP) para evitar el límite de subida del panel.
  • O aumenta el límite de subida editando el archivo php.ini (consulta a tu hosting).

Error 3: "El módulo no aparece en la lista después de subirlo por FTP"

• Causa: La carpeta se subió en el lugar incorrecto o tiene un nombre distinto.
• Solución: Verifica que la carpeta esté dentro de /modules. El nombre debe coincidir exactamente con el nombre del módulo (por ejemplo, ps_googleanalytics).

Error 4: "Error de permisos" o "No se puede escribir en la carpeta"

• Causa: El servidor no permite que PrestaShop modifique archivos.
• Solución: Cambia los permisos de la carpeta modules a 755 (o 777 temporalmente, pero luego vuelve a 755 por seguridad). En Syspanel, selecciona la carpeta y elige "Cambiar permisos".

[INFO] Si después de todo no funciona, revisa el log de errores de PrestaShop. Ve a Parámetros avanzados > Logs y busca mensajes relacionados con el módulo.

Preguntas frecuentes (FAQ) sobre instalación manual

¿Puedo instalar un módulo sin descomprimirlo?

Sí, el método 1 (subir ZIP) es el más común. No lo descomprimas, PrestaShop lo hace por ti.

¿Qué hago si el módulo me pide una clave de licencia?

Algunos módulos de pago requieren una clave. Normalmente la recibes por correo al comprarlo. Introdúcela en la configuración del módulo después de instalarlo.

¿Cómo desinstalo un módulo instalado manualmente?

Ve a Módulos > Módulos y servicios, busca el módulo, haz clic en el botón de engranaje y selecciona Desinstalar. Luego puedes eliminarlo borrando su carpeta en /modules por FTP.

¿Es seguro instalar módulos manualmente?

Sí, siempre que confíes en la fuente. Los módulos del market oficial o de desarrolladores reconocidos son seguros. Evita sitios de descarga gratuita no oficiales.

¿Puedo instalar un módulo en PrestaShop 1.6, 1.7 o 8.x?

Sí, pero verifica la compatibilidad. Los módulos de PrestaShop 1.6 no funcionan en 1.7 o 8.x. Busca la versión adecuada para tu tienda. En la descripción del módulo suele indicarlo.

Consejos finales para gestionar tus módulos

• Haz copias de seguridad: Antes de instalar cualquier módulo, especialmente si es grande o crítico, respalda tu base de datos y archivos. Así, si algo sale mal, puedes restaurar.
• Actualiza tus módulos: Los módulos obsoletos pueden tener fallos de seguridad. Revisa periódicamente si hay nuevas versiones.
• No satures tu tienda: Instala solo los módulos que realmente necesites. Demasiados módulos ralentizan tu tienda y pueden generar conflictos.
• Prueba en un entorno de desarrollo: Si tienes una copia de tu tienda en local o en un subdominio, pruébalo allí primero.

Ahora ya sabes cómo instalar módulos en PrestaShop manualmente como un profesional. Ya sea usando el práctico botón de subir ZIP o yendo directo al servidor por FTP, tienes el control total para añadir módulo PrestaShop cuando quieras. Recuerda siempre verificar la fuente y seguir los pasos con calma. Si te surge alguna duda, vuelve a esta guía o consulta la documentación oficial de PrestaShop.

¡A darle vida a tu tienda con nuevos módulos!