Instalar un módulo PrestaShop parece simple en teoría. En la práctica, entre los módulos descargados desde el addon store, los comprados en marketplaces de terceros, los desarrollados internamente y las restricciones específicas del multitienda, se topa rápidamente con casos particulares. Esta guía cubre los tres métodos de instalación válidos en 2026, los errores más frecuentes y las buenas prácticas para no romper una tienda en producción.
Antes de empezar: haga una copia de seguridad de su tienda
Esta etapa no es negociable. Antes de añadir cualquier módulo a una tienda en producción, debe disponer de una copia de seguridad fresca de la base de datos y de los archivos. Si usa un hosting serio (o2switch, OVH, Cloudways, SiteGround), una copia de seguridad diaria automática ya está activa — verifique que sea reciente y restaurable.
Lo ideal es probar en un entorno de pre-producción idéntico al de producción, y luego replicar la instalación. Si no tiene staging, una exportación rápida vía la herramienta integrada de PrestaShop es mejor que nada.
Método 1: instalación vía el back-office
Es el método más común y seguro. Funciona para todos los módulos entregados como archivo ZIP — vengan del addon store oficial, de un marketplace de terceros o de un desarrollador independiente.
- Conéctese al back-office PrestaShop
- Vaya a Módulos → Gestor de módulos
- Haga clic en Subir un módulo (arriba a la derecha)
- Arrastre su archivo ZIP a la zona de carga, o haga clic para seleccionarlo
- Espere el mensaje de confirmación
- Haga clic en Configurar para acceder a los parámetros del módulo
Si la subida falla con un mensaje de error de tamaño, sus directivas PHP son demasiado restrictivas. Hay que aumentar upload_max_filesize, post_max_size y memory_limit en su php.ini o vía un archivo .htaccess en la raíz de PrestaShop. Valores razonables: 64M para los dos primeros, 256M para la memoria.
Caso particular: módulo bloqueado por PrestaShop Marketplace
Si compró su módulo en addons.prestashop.com, el ZIP a veces está protegido por una firma que exige una conexión a su cuenta PrestaShop. En ese caso, la instalación pasa obligatoriamente por Módulos → Selección y el botón de instalación asociado a su compra. Es voluntario — PrestaShop impide así la redistribución no autorizada.
Método 2: instalación por FTP
Este método es útil en dos casos: su archivo ZIP es demasiado grande para los límites PHP de su hosting, o instala varios módulos a la vez y quiere ir más rápido.
- Descomprima el ZIP del módulo en su equipo
- Debe obtener una carpeta con el nombre del módulo (por ejemplo
monmodule/) - Suba esta carpeta a
/modules/en la raíz de su PrestaShop vía FTP o SFTP - Vuelva a Módulos → Gestor de módulos
- Busque el módulo en la lista y haga clic en Instalar
Atención: no descomprima un ZIP que ya contenga /modules/monmodule/ en la raíz de su PrestaShop — corre el riesgo de sobrescribir archivos existentes. Verifique siempre la estructura del ZIP antes de extraer.
Alternativa: Explorer FTP directamente en el back-office
Si usa Explorer FTP, puede subir sus archivos de módulos directamente desde el back-office, sin cliente FTP externo. Práctico cuando trabaja en movilidad o no tiene acceso a FileZilla.
Método 3: instalación vía Composer (PrestaShop 9)
Este método solo concierne a los módulos modernos desarrollados según los estándares Symfony — por ahora, principalmente los módulos oficiales y algunos módulos de desarrolladores. Composer descarga automáticamente el módulo y sus dependencias PHP.
cd /ruta/hacia/prestashop
composer require prestashop/module-nameLuego lo activa vía el back-office como un módulo clásico. La documentación oficial de PrestaShop lista los módulos compatibles con Composer. Para los módulos de terceros (marketplaces, desarrolladores independientes), el método 1 sigue siendo la norma.
Configurar un módulo después de la instalación
Una vez instalado, un módulo permanece desactivado hasta que lo haya configurado. Haga clic en Configurar al lado del nombre del módulo para acceder a sus parámetros.
Los módulos serios proporcionan una página de configuración clara con los parámetros esenciales. Los módulos amateurs le dejan solo frente a un archivo config.xml a editar — es una señal de alerta.
Muchos módulos también necesitan activar uno o varios hooks. Un hook es una ubicación en la página donde el módulo va a inyectar su contenido. Por ejemplo, un módulo de slider debe engancharse al hook displayHome para aparecer en la página de inicio. Verifique en Módulos → Posiciones que los hooks esperados están activados.
Probar en entorno de staging
En una tienda con mucho tráfico, nunca instalación directa en producción. La secuencia a respetar:
- Duplicar la tienda en pre-producción (mismas versiones PrestaShop, PHP, MySQL)
- Instalar el módulo en staging
- Probar durante 24 a 48 horas los flujos críticos: añadir al carrito, checkout completo, pago, multitienda si aplica
- Verificar los logs (Symfony, Apache, PHP) — un módulo puede funcionar en superficie pero generar errores silenciosos en segundo plano
- Si todo está en verde, replicar la instalación en producción fuera de horas pico
Los errores más frecuentes y sus soluciones
«El módulo no aparece en la lista»
Tres causas posibles: el ZIP se descomprimió en la carpeta equivocada (verifique que esté en /modules/nombredelmodulo/), los permisos de archivos son incorrectos (los archivos PHP deben estar en 644 y las carpetas en 755), o la caché del back-office es obsoleta. Para vaciar la caché, vaya a Parámetros avanzados → Rendimiento y haga clic en Vaciar caché.
«Error 500 después de la activación»
El módulo es probablemente incompatible con su versión de PrestaShop o de PHP. Desactívelo eliminando la carpeta del módulo vía FTP, luego verifique las versiones en su ficha de producto. La compatibilidad PrestaShop 1.7 vs 8 es la fuente número uno de incompatibilidad.
«El módulo funciona pero no se muestra»
Hook no activado. Vaya a Módulos → Posiciones, busque su módulo en la lista y verifique los hooks enganchados. Si nada está marcado, engánchelo a los hooks recomendados por su documentación.
«Conflicto con otro módulo»
Síntoma típico: un módulo funciona solo, pero se rompe cuando activa un segundo. La resolución pasa por los logs Symfony (en var/logs/) y por la desactivación alternada para identificar al culpable. Los conflictos más frecuentes implican módulos que modifican los mismos hooks o las mismas plantillas.
Buenas prácticas después de la instalación
Una vez su módulo instalado y configurado, dos reflejos:
- Documentar — guarde un archivo listando los módulos instalados, sus versiones, sus licencias. En caso de migración o de soporte, gana horas.
- Actualizar regularmente — la mayoría de las fallas de seguridad PrestaShop documentadas provienen de módulos de terceros obsoletos. Active las notificaciones de actualización en Módulos → Notificaciones.
¿Y después?
Para ir más lejos, explore nuestro catálogo de módulos PrestaShop 8 por categoría: SEO, checkout, marketing y más. Cada módulo DataFirefly se entrega con una documentación de instalación detallada y soporte técnico en español, francés e inglés.