Instalar módulos PrestaShop manualmente vía FTP

¿Por qué instalar módulos manualmente en PrestaShop?

A veces, el método más rápido no es el más fiable. Instalar módulos desde el backoffice de PrestaShop es cómodo, pero puede fallar por límites de tamaño de archivo en el servidor, problemas de conexión o restricciones de seguridad. Cuando eso ocurre, instalar módulos PrestaShop FTP es la solución definitiva.

El método manual mediante FTP te da control total sobre el proceso. Además, es ideal si trabajas con módulos personalizados, versiones modificadas o si tu hosting tiene configuraciones restrictivas. No necesitas ser un experto técnico; solo sigue estos pasos con cuidado.

[INFO] Este tutorial está pensado para PrestaShop 1.7 y versiones posteriores, aunque el proceso es similar en versiones anteriores.

Requisitos previos antes de empezar

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

Un cliente FTP: FileZilla (gratuito y muy recomendado) o Cyberduck.
Los datos de conexión FTP: Servidor (normalmente tu dominio), usuario, contraseña y puerto (casi siempre 21).
El módulo en formato .zip: Descárgalo desde una fuente confiable (Addons de PrestaShop, desarrollador oficial, etc.).
Acceso al panel de control de tu hosting (cPanel, Plesk, Syspanel, etc.) por si necesitas ajustar permisos.

Si tu hosting usa Syspanel (antes conocido como HestiaCP), recuerda que el acceso al panel se realiza a través del puerto 2106 (ejemplo: https://tudominio.com:2106). Allí podrás gestionar archivos y bases de datos si es necesario.

Paso 1: Conectar por FTP a tu servidor

Abre tu cliente FTP e introduce los datos de conexión:

Servidor: tudominio.com o la IP que te haya proporcionado tu hosting.
Usuario: El nombre de usuario FTP (suele ser el mismo que el de tu cuenta de hosting).
Contraseña: La que configuraste para FTP.
Puerto: 21 (a menos que tu hosting indique otro).

Haz clic en "Conexión rápida" y, si todo está bien, verás una lista de carpetas en el lado derecho (servidor) y tus archivos locales a la izquierda.

[WARNING] Si la conexión falla, verifica que tu hosting permita conexiones FTP externas. Algunos paneles como Syspanel requieren activar el servicio FTP desde el apartado "Servicios" (puerto 21 por defecto).

Paso 2: Localizar la carpeta de módulos en PrestaShop

Una vez conectado, navega hasta la raíz de tu instalación de PrestaShop. Normalmente es algo como /public_html/ o /www/. Dentro, busca la carpeta:

/modules

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

Paso 3: Subir el módulo descomprimido

Aquí viene el paso clave para instalar módulos PrestaShop FTP correctamente:

Descomprime el archivo .zip del módulo en tu ordenador. Verás una carpeta con el nombre técnico del módulo (ejemplo: ps_banner, productcomments, etc.).
Arrastra esa carpeta desde tu computadora (lado izquierdo) a la carpeta /modules del servidor (lado derecho).
Espera a que termine la transferencia. FileZilla te mostrará una barra de progreso.

[TIP] Si el módulo pesa mucho (más de 50 MB), la subida puede tardar. No cierres el cliente FTP hasta que termine.

Paso 4: Verificar permisos de la carpeta

PrestaShop necesita que la carpeta del módulo tenga permisos de lectura y escritura para funcionar correctamente. Generalmente, los permisos correctos son 755 para carpetas y 644 para archivos.

En FileZilla:

Haz clic derecho sobre la carpeta del módulo recién subida.
Selecciona "Permisos de archivo" (o "File permissions").
Marca 755 (o escribe 755 en el campo numérico).
Aplica también a subcarpetas y archivos (marca la opción "Recurse into subdirectories").

[WARNING] Si ves errores como "No se puede escribir en la carpeta" al activar el módulo, repite este paso. En Syspanel, puedes ajustar permisos desde el gestor de archivos integrado (en el puerto 2106).

Paso 5: Activar el módulo desde el backoffice

Ahora que el módulo está físicamente en el servidor, ve al panel de administración de PrestaShop:

Inicia sesión en tu backoffice (ejemplo: tudominio.com/adminXXXXXX).
Ve a Módulos > Gestor de módulos.
En la lista de módulos, busca el que acabas de subir. Si no aparece, usa el buscador con el nombre técnico.
Haz clic en Instalar (o "Activar" si ya aparece pero desactivado).
Sigue las instrucciones del módulo (configuración de API, ajustes de visualización, etc.).

[INFO] Si el módulo no aparece, refresca la página o limpia la caché de PrestaShop desde Parámetros avanzados > Rendimiento > Forzar compilación y luego Limpiar caché.

Solución de problemas comunes (FAQ)

¿Por qué mi módulo no aparece en el backoffice tras subirlo por FTP?

Causas posibles:

La carpeta del módulo tiene un nombre incorrecto (debe coincidir exactamente con el nombre técnico del módulo).
El módulo no está en la carpeta /modules correcta (revisa la ruta).
Faltan archivos esenciales (como index.php o el archivo principal del módulo).

Recomendación: Vuelve a descargar el módulo desde la fuente original y repite el proceso.

¿Puedo instalar un módulo desde un .zip sin descomprimirlo?

No. El método FTP requiere subir la carpeta descomprimida. Si subes el .zip, PrestaShop no lo reconocerá.

¿Qué hago si el módulo da error de "permisos insuficientes"?

Ajusta los permisos a 755 como se explicó en el Paso 4. Si el error persiste, contacta con tu hosting. En Syspanel, puedes verificar desde el panel (puerto 2106) que el usuario FTP tenga permisos de escritura en la carpeta /modules.

¿Es seguro instalar módulos manualmente?

Sí, siempre que descargues el módulo de fuentes oficiales (Addons de PrestaShop, GitHub del desarrollador, etc.). Los módulos de dudosa procedencia pueden contener código malicioso.

Ventajas de instalar módulos PrestaShop FTP frente al método automático

Sin límite de tamaño: El backoffice a veces rechaza archivos grandes (>2MB). FTP no tiene ese límite.
Mayor control: Puedes ver exactamente qué archivos se suben y dónde.
Ideal para desarrolladores: Permite sobrescribir archivos de módulos ya instalados sin depender del instalador.
Funciona en entornos restrictivos: Algunos hostings bloquean la subida por backoffice, pero FTP suele estar disponible.

Consejos finales para una instalación exitosa

Haz una copia de seguridad de tu tienda antes de instalar cualquier módulo nuevo. Incluye archivos y base de datos.
Prueba el módulo en un entorno de desarrollo si es posible, sobre todo si es crítico para tu tienda.
Actualiza los módulos manualmente siguiendo el mismo proceso: descarga la nueva versión, sube la carpeta sobrescribiendo la anterior y vuelve a activar.
Mantén PrestaShop actualizado para evitar conflictos de compatibilidad.

[TIP] Si tu hosting usa Syspanel, recuerda que el acceso al gestor de archivos web está disponible en el puerto 2106. Allí también puedes subir y descomprimir archivos .zip directamente, lo que puede ser más rápido que FTP para algunos usuarios.

Conclusión

Instalar módulos PrestaShop FTP es una habilidad esencial para cualquier administrador de tiendas online. Aunque el método automático es más cómodo, el manual te saca de apuros cuando falla el primero. Con estos pasos detallados, podrás hacerlo sin estrés y con total confianza.

Recuerda siempre verificar los permisos, usar fuentes confiables y mantener tu PrestaShop actualizado. Si tienes dudas, consulta la documentación oficial de PrestaShop o contacta con el soporte de tu hosting.

¡Ahora ya puedes manejar cualquier módulo que tu tienda necesite, sin depender de límites técnicos!