Cómo instalar módulos en PrestaShop manualmente vía FTP

Instalar un módulo en PrestaShop de forma manual puede parecer complicado al principio, pero con esta guía paso a paso lo harás en minutos. A veces, el propio mercado de PrestaShop o el instalador automático no funcionan correctamente, o necesitas un módulo que no está disponible directamente desde el backoffice. Ahí es donde entra el método manual, usando FTP (File Transfer Protocol).

Aquí te explicaré todo lo que necesitas saber para instalar módulos en PrestaShop manualmente, desde qué herramientas necesitas hasta cómo solucionar los problemas más comunes. Al final, tendrás un proceso claro y repetible.

¿Qué necesitas para instalar módulos manualmente?

Antes de empezar, asegúrate de tener a mano lo siguiente:

Archivo del módulo: Normalmente en formato .zip o .tar.gz. Lo obtienes del desarrollador o de una tienda de módulos.
Cliente FTP: Un programa para conectar con tu servidor. Los más populares son FileZilla (gratuito y muy recomendado), Cyberduck o WinSCP.
Datos de acceso a tu hosting: Necesitarás la dirección del servidor (por ejemplo, ftp.tudominio.com), el nombre de usuario y la contraseña FTP. Si usas un panel de control como cPanel, Plesk o Syspanel (accesible por el puerto 2106), puedes crear un usuario FTP desde allí.
Acceso al backoffice de PrestaShop: Para la parte final de la instalación y configuración.

[INFO] Si no tienes los datos FTP, contacta con tu proveedor de hosting. En Syspanel, puedes gestionar los usuarios FTP desde la sección "Cuentas FTP" tras iniciar sesión en el puerto 2106.

Paso 1: Prepara el módulo para la instalación

No todos los archivos que descargas están listos para subir directamente. Sigue estos pasos:

Descomprime el archivo: Si el módulo viene en .zip o .tar.gz, extráelo en tu ordenador. Busca una carpeta que contenga un archivo principal llamado nombre_del_modulo.php y una carpeta views, controllers u otras.
Verifica la estructura: La carpeta principal del módulo debe tener el mismo nombre que el módulo (por ejemplo, ps_banner). Dentro, debe haber un archivo nombre_del_modulo.php (el controlador principal) y otros archivos como logo.png, config.xml, etc. Nunca subas el .zip entero.
Renombra si es necesario: A veces el módulo viene en una carpeta con un nombre genérico como modulo-nuevo. Asegúrate de que coincida con el nombre técnico del módulo (lo puedes ver en el archivo config.xml).

[WARNING] No modifiques el contenido de los archivos del módulo a menos que sepas exactamente lo que haces. Cualquier cambio puede romper su funcionamiento.

Paso 2: Conéctate a tu servidor vía FTP

Aquí es donde muchos se pierden, pero es sencillo. Sigue estos pasos:

Abre tu cliente FTP (FileZilla, por ejemplo).
Introduce los datos de conexión:
- Servidor: ftp.tudominio.com o la IP que te haya dado tu hosting.
- Nombre de usuario: El que creaste en tu panel de control.
- Contraseña: La que asignaste.
- Puerto: Normalmente es el 21 (FTP estándar). Si usas SFTP (más seguro), suele ser el 22.
Conecta: Haz clic en "Conexión rápida" o el botón correspondiente. Verás dos paneles: el izquierdo es tu ordenador local, el derecho es el servidor remoto.

[TIP] Si no recuerdas tus datos FTP, inicia sesión en Syspanel (puerto 2106) y ve a "Cuentas FTP" para ver o crear un nuevo usuario.

Paso 3: Localiza la carpeta de módulos en tu servidor

En el panel derecho (servidor remoto), navega hasta la carpeta donde está instalado PrestaShop. Normalmente es algo como public_html, htdocs o www. Dentro, busca la carpeta:

/modules

Esta es la carpeta donde PrestaShop almacena todos los módulos instalados. No la confundas con la carpeta themes o override.

[INFO] Si tu PrestaShop está en una subcarpeta (por ejemplo, public_html/tienda), la ruta sería public_html/tienda/modules.

Paso 4: Sube la carpeta del módulo al servidor

Ahora viene la acción principal:

En el panel izquierdo (tu ordenador), localiza la carpeta del módulo que descomprimiste.
Arrástrala directamente al panel derecho, dentro de la carpeta /modules del servidor.
Espera a que termine la transferencia. Dependiendo del tamaño del módulo, puede tardar unos segundos o minutos. Verás el progreso en la parte inferior de FileZilla.

[WARNING] Asegúrate de que la carpeta no se suba como un archivo .zip. Debe ser una carpeta completa. Si ves que solo subes un archivo .zip, descomprímelo primero en tu ordenador.

Paso 5: Verifica los permisos de archivos (opcional pero recomendado)

A veces, los archivos del módulo necesitan permisos específicos para funcionar bien. Aunque PrestaShop suele manejarlo automáticamente, es bueno comprobarlo:

Carpetas: Deben tener permisos 755 (lectura, escritura y ejecución para el propietario; lectura y ejecución para otros).
Archivos: Deben tener permisos 644 (lectura y escritura para el propietario; solo lectura para otros).

En FileZilla, puedes hacer clic derecho sobre la carpeta del módulo, seleccionar "Permisos de archivo" y ajustarlos. Si no sabes, déjalo como está; la mayoría de los módulos funcionan con los permisos por defecto.

[TIP] En Syspanel, también puedes ajustar permisos desde el administrador de archivos, pero FTP es más rápido para esto.

Paso 6: Instala el módulo desde el backoffice de PrestaShop

Una vez que los archivos están en el servidor, ve a tu panel de administración de PrestaShop:

Inicia sesión en tu backoffice (normalmente tudominio.com/adminXXXXXX).
Ve al menú "Módulos" > "Gestor de módulos" (en versiones recientes) o "Módulos y servicios" (en versiones antiguas).
Busca el módulo: En la lista de módulos, debería aparecer el que acabas de subir. Puede que esté desactivado o no aparezca inmediatamente. Si no lo ves, haz clic en el botón "Buscar módulos" (ícono de lupa) o escribe parte del nombre.
Instálalo: Una vez que lo encuentres, verás un botón "Instalar". Haz clic en él.
Configura: Después de la instalación, el módulo te redirigirá a su página de configuración. Ajusta las opciones según tus necesidades (por ejemplo, activar o desactivar funciones, establecer anchos, colores, etc.).

[INFO] Si el módulo no aparece en la lista, es posible que la carpeta no se haya subido correctamente o que el nombre de la carpeta no coincida con el nombre técnico del módulo. Vuelve al paso 4 y verifica.

Paso 7: Prueba el módulo en tu tienda

No des por terminado el proceso sin comprobar que todo funciona:

Ve a tu tienda en el frontend (la parte pública).
Busca el módulo: Dependiendo del tipo, puede aparecer como un bloque en la barra lateral, un banner, un formulario de contacto, etc.
Realiza una prueba: Por ejemplo, si es un módulo de chat, envía un mensaje; si es un módulo de reseñas, deja una reseña.
Revisa si hay errores: Si ves algún mensaje de error o el módulo no se muestra, vuelve al backoffice y revisa la configuración.

[WARNING] Si el módulo no funciona, desinstálalo desde el gestor de módulos y vuelve a instalarlo. Si sigue sin funcionar, contacta al desarrollador del módulo.

Solución de problemas comunes (FAQ)

Aquí tienes las preguntas más frecuentes que resuelven dudas de otros usuarios:

¿Por qué no veo el módulo en el gestor después de subirlo?

Causa: La carpeta del módulo tiene un nombre incorrecto o no está en la ubicación correcta.
Solución: Verifica que la carpeta esté dentro de /modules y que el nombre coincida exactamente con el nombre técnico del módulo (por ejemplo, ps_banner y no banner-modulo).

¿Qué hago si el módulo da error "No se puede instalar el módulo"?

Causa: Puede ser un problema de permisos o de compatibilidad con la versión de PrestaShop.
Solución: Comprueba los permisos de la carpeta (755) y los archivos (644). También revisa si el módulo es compatible con tu versión de PrestaShop (por ejemplo, 1.7 vs 8.x).

¿Es necesario usar FTP? ¿No puedo subirlo desde el backoffice?

Respuesta: Sí, puedes subir módulos desde el backoffice usando la opción "Subir un módulo" en el gestor. Pero si eso falla (por ejemplo, por límite de tamaño de archivo), el método manual con FTP es la solución.

¿Cómo sé si el módulo se ha instalado correctamente?

Respuesta: En el gestor de módulos, aparecerá como "Instalado" y normalmente verás un mensaje de éxito. Además, en el frontend de la tienda, deberías ver sus efectos (por ejemplo, un nuevo bloque o funcionalidad).

¿Puedo instalar módulos de pago manualmente?

Respuesta: Sí, siempre que tengas el archivo del módulo (normalmente protegido con licencia). El proceso es el mismo. Luego, desde la configuración del módulo, deberás ingresar la clave de licencia que te proporcionó el vendedor.

¿Qué hago si el módulo no aparece en la tienda después de instalarlo?

Causa: El módulo puede estar desactivado en la configuración o necesita ser colocado en una posición específica (por ejemplo, en un hook).
Solución: Ve a "Módulos" > "Posiciones" y busca el módulo. Asígnale una posición (por ejemplo, "displayHome" para la página principal) y guárdalo.

[TIP] Si después de todo el módulo sigue sin funcionar, revisa los logs de errores de PrestaShop en "Parámetros avanzados" > "Logs" para ver mensajes específicos.

Ventajas de instalar módulos manualmente

Aunque el método automático es más cómodo, la instalación manual tiene sus beneficios:

Control total: Sabes exactamente qué archivos se suben y dónde.
Solución de problemas: Si algo falla, puedes depurar fácilmente revisando los archivos.
Módulos personalizados: Puedes instalar módulos que no están en el marketplace oficial.
Sin límites de tamaño: No te preocupes por el límite de subida de archivos del servidor (a menudo 2 MB o 8 MB).

Conclusión

Instalar módulos en PrestaShop manualmente es una habilidad esencial para cualquier administrador de tienda. Con estos pasos, puedes hacerlo sin depender de sistemas automáticos. Recuerda siempre verificar la compatibilidad del módulo con tu versión de PrestaShop y mantener copias de seguridad de tu tienda antes de hacer cambios importantes.

Si te encuentras con algún problema, no dudes en consultar la documentación del módulo o contactar con el soporte técnico. Y si usas Syspanel (puerto 2106), recuerda que puedes gestionar fácilmente tus cuentas FTP desde allí.

¡Ahora ya estás listo para instalar cualquier módulo que necesites!