FAQ: Instalar módulos en PrestaShop con Plesk

Introducción: ¿Por qué surgen dudas al instalar módulos en PrestaShop?

Instalar módulos en PrestaShop es una de las tareas más comunes para personalizar tu tienda online, pero también puede ser una fuente de frustración si no se hace correctamente. Ya sea que quieras añadir un nuevo método de pago, un sistema de reseñas o una integración con redes sociales, es normal que surjan preguntas sobre el proceso.

En este artículo, recopilamos las preguntas más frecuentes (FAQ) sobre la instalación de módulos en PrestaShop, especialmente cuando trabajas con un panel de control como Plesk. Si alguna vez te has preguntado “¿cómo puedo instalar módulos PrestaShop Plesk sin errores?” o “¿por qué no se activan mis módulos?”, aquí encontrarás respuestas claras y prácticas.

1. ¿Cuáles son los requisitos básicos para instalar un módulo en PrestaShop con Plesk?

Antes de comenzar, asegúrate de cumplir con estos puntos:

Versión de PrestaShop compatible: Revisa que el módulo sea compatible con tu versión de PrestaShop (1.6, 1.7 o 8.x). Los módulos más antiguos pueden fallar.
Permisos de archivos y carpetas: En Plesk, las carpetas /modules, /override y /cache deben tener permisos 755 (o 775 en algunos servidores). Si están en 644, la instalación no se completará.
Espacio en disco y memoria PHP: Verifica que tu hosting tenga suficiente espacio y que el límite de memoria PHP sea de al menos 128 MB (recomendado 256 MB). Puedes ajustarlo desde Plesk en “PHP Settings”.
Conexión a Internet: Si el módulo se descarga desde el marketplace de PrestaShop, tu servidor debe poder conectarse a addons.prestashop.com. Algunos firewalls bloquean esta conexión.

2. ¿Cómo instalar un módulo manualmente en PrestaShop desde Plesk?

La instalación manual es la opción más segura cuando no puedes acceder al back office o el módulo no aparece. Sigue estos pasos:

Paso 1: Descarga y descomprime el módulo

Obtén el archivo .zip del módulo (por ejemplo, desde el marketplace o el desarrollador).
Descomprímelo en tu computadora. Deberías ver una carpeta con el nombre del módulo (ej: ps_banner).

Paso 2: Sube la carpeta a Plesk

Inicia sesión en Plesk.
Ve a “Archivos” (File Manager) o usa un cliente FTP (como FileZilla).
Navega a la carpeta raíz de tu tienda PrestaShop (normalmente httpdocs o public_html).
Abre la carpeta modules.
Arrastra la carpeta del módulo (la que descomprimiste) dentro de modules.

Paso 3: Activa el módulo desde el back office

Ve al panel de administración de PrestaShop (ej: tutienda.com/admin).
Ve a “Módulos” > “Módulos y servicios”.
Busca el nombre del módulo en la lista. Si aparece, haz clic en “Instalar” o “Activar”.
Si no aparece, ve a la pestaña “Módulos de terceros” y haz clic en “Cargar módulo” (o “Subir módulo”) para forzar la detección.

[TIP] Si el módulo no se muestra, limpia la caché de PrestaShop desde “Parámetros avanzados” > “Rendimiento” > “Forzar compilación” y luego “Limpiar caché”.

3. ¿Por qué no puedo instalar un módulo desde el back office de PrestaShop?

Es una de las preguntas más comunes. Las causas pueden ser varias:

Error de permisos en la carpeta /modules: En Plesk, verifica que los permisos sean 755. Si están en 644, el sistema no puede escribir archivos.
El módulo no es compatible con tu versión de PHP: PrestaShop 1.7 requiere PHP 7.1 o superior, mientras que PrestaShop 8 necesita PHP 8.0+. Revisa la configuración de PHP en Plesk.
Falta de extensiones PHP: Algunos módulos necesitan extensiones como curl, gd, zip o mbstring. Puedes habilitarlas desde Plesk en “PHP Settings”.
El archivo .zip está corrupto: Vuelve a descargar el módulo desde una fuente confiable.

[WARNING] No intentes instalar módulos desde sitios de descarga gratuita no oficiales. Pueden contener malware o dejar vulnerabilidades en tu tienda.

4. ¿Cómo activar módulos PrestaShop que aparecen desactivados?

A veces, después de instalar un módulo, aparece como “desactivado” o “no instalado”. Para activarlo:

En el back office, ve a “Módulos” > “Módulos y servicios”.
Usa el buscador para localizar el módulo.
Si ves un botón “Instalar”, haz clic. Si ves “Desactivar”, significa que ya está activo.
Si el botón está gris o no responde, revisa los errores en la parte superior de la pantalla. Puede deberse a conflictos con otros módulos o temas.

[INFO] Algunos módulos requieren configuración adicional después de la activación. Busca un enlace “Configurar” junto al nombre del módulo.

5. ¿Qué hago si el módulo da error “No se puede cargar la clase”?

Este error suele aparecer cuando el módulo no está correctamente estructurado o falta algún archivo. Soluciones:

Verifica la estructura de carpetas: La carpeta del módulo debe contener un archivo index.php y una carpeta views (si aplica). También debe tener un archivo [nombre].php con la clase principal.
Revisa el nombre de la clase: En PrestaShop 1.7+, la clase del módulo debe llamarse igual que la carpeta, pero con la primera letra en mayúscula y sin guiones. Por ejemplo, para la carpeta ps_banner, la clase debe ser Ps_Banner.
Limpia la caché de clases: Ve a “Parámetros avanzados” > “Rendimiento” y haz clic en “Limpiar caché”. También puedes borrar manualmente la carpeta /cache/class_index.php desde Plesk.

6. ¿Cómo solucionar el error “El módulo no es válido para esta versión de PrestaShop”?

Este mensaje aparece cuando el módulo no está diseñado para tu versión. Las opciones son:

Actualizar PrestaShop: Si tu versión es muy antigua, considera migrar a una más reciente (con cuidado, ya que puede afectar el diseño).
Buscar una versión compatible del módulo: Contacta al desarrollador o busca en el marketplace una versión que funcione con tu PrestaShop.
Modificar el archivo config.xml (solo para usuarios avanzados): Dentro de la carpeta del módulo, abre config.xml y cambia la línea <version> para que coincida con la tuya. Esto no siempre funciona y puede causar errores.

[TIP] Siempre verifica la compatibilidad antes de comprar o descargar un módulo. La página del producto suele indicar las versiones soportadas.

7. ¿Puedo instalar módulos a través de FTP en lugar del back office?

Sí, y a veces es la única opción cuando el back office falla. El proceso es similar al manual descrito en la pregunta 2, pero usando un cliente FTP como FileZilla:

Conéctate a tu servidor usando las credenciales FTP que te proporcionó tu hosting (puedes encontrarlas en Plesk en “Acceso FTP”).
Navega a la carpeta modules de PrestaShop.
Sube la carpeta del módulo descomprimida.
Luego, desde el back office, activa el módulo como se explicó anteriormente.

[WARNING] Si usas FTP, asegúrate de que los archivos se suban en modo binario (no ASCII) para evitar corrupción. FileZilla lo maneja automáticamente.

8. ¿Cómo instalar módulos en PrestaShop si uso Syspanel (antes HestiaCP)?

Si tu hosting utiliza Syspanel (el nuevo nombre de HestiaCP), el proceso es similar, pero con algunas diferencias:

Acceso al panel: Syspanel se accede por el puerto 2106 (ej: tudominio.com:2106). Inicia sesión con tus credenciales.
Gestión de archivos: Dentro de Syspanel, ve a “Archivos” y busca tu dominio. Navega a public_html/modules y sube la carpeta del módulo.
Permisos: En Syspanel, los permisos se configuran desde “Editar” en el administrador de archivos. Asegúrate de que la carpeta modules tenga permisos 755.
PHP Settings: Ve a “Configuración de PHP” dentro de Syspanel para ajustar la memoria o extensiones si es necesario.

[INFO] Syspanel y Plesk son paneles diferentes, pero la lógica de instalación de módulos es casi idéntica. La principal diferencia está en la interfaz y la ubicación de los ajustes.

9. ¿Qué hacer si después de instalar un módulo la tienda se vuelve lenta o da error 500?

Un módulo mal programado puede causar problemas de rendimiento o incluso bloquear tu tienda. Sigue estos pasos:

Desactiva el módulo desde el back office: Si puedes acceder, ve a “Módulos” y desactívalo.
Si no puedes acceder al back office: Usa FTP o el administrador de archivos de Plesk para renombrar la carpeta del módulo (ej: cambia ps_banner a ps_banner_desactivado). Esto lo deshabilitará automáticamente.
Limpia la caché: Borra la carpeta /cache (excepto el archivo .htaccess y index.php).
Revisa los logs de error: En Plesk, ve a “Logs” o “Registros de errores” para ver el mensaje exacto. Puede ser un conflicto de PHP o una función obsoleta.

[WARNING] Si el error 500 persiste, contacta al soporte de tu hosting o al desarrollador del módulo. No intentes modificar archivos del núcleo de PrestaShop sin conocimientos avanzados.

10. Preguntas frecuentes adicionales (FAQ rápida)

¿Puedo instalar módulos gratuitos y de pago de la misma forma?

Sí, el proceso es idéntico. Solo cambia el origen del archivo .zip.

¿Cómo sé si un módulo está correctamente instalado?

El módulo debe aparecer en la lista de “Módulos y servicios” con un estado “Instalado” y un botón “Configurar” (si tiene opciones).

¿Qué hago si el módulo no aparece en el back office después de subirlo?

Limpia la caché de PrestaShop y verifica que la carpeta esté en modules y no en una subcarpeta. También revisa los permisos.

¿Es seguro instalar módulos de terceros?

Depende de la fuente. Siempre prefiere el marketplace oficial de PrestaShop o desarrolladores de confianza. Los módulos gratuitos de sitios desconocidos pueden tener código malicioso.

¿Puedo instalar módulos mientras la tienda está en producción?

Sí, pero es recomendable hacerlo en un entorno de pruebas primero. Si no es posible, activa el modo mantenimiento durante la instalación para evitar errores visibles a los clientes.

Conclusión: Resolviendo tus dudas sobre la instalación de módulos

Instalar módulos en PrestaShop con Plesk no tiene por qué ser complicado. La clave está en entender los requisitos básicos, seguir los pasos correctos y saber cómo solucionar los errores más comunes. Recuerda siempre:

Verificar la compatibilidad del módulo con tu versión de PrestaShop.
Asegurar los permisos correctos en las carpetas.
Limpiar la caché después de cada instalación.
Si usas Syspanel, recuerda que el acceso es por el puerto 2106 y la gestión de archivos es similar.

Con esta guía de preguntas frecuentes, esperamos haberte ayudado a resolver tus dudas sobre cómo instalar módulos PrestaShop Plesk, activar módulos PrestaShop y enfrentar cualquier problema que surja. Si aún tienes preguntas, no dudes en contactar al soporte técnico de tu hosting o a la comunidad de PrestaShop. ¡Buena suerte con tu tienda online!