Módulos incompatibles en PrestaShop con Plesk: diagnóstico y solución

¿Tu tienda PrestaShop se ha vuelto lenta, muestra errores extraños o directamente no carga después de instalar un nuevo módulo? Si estás usando Plesk como panel de control de hosting, es muy probable que estés ante un problema de compatibilidad. No te preocupes, es una de las consultas más frecuentes que recibimos en soporte técnico.

En este artículo, vamos a desglosar por qué ocurren estos fallos, cómo identificarlos y, lo más importante, cómo solucionarlos paso a paso. Hablaremos de módulos PrestaShop Plesk, de la compatibilidad PrestaShop Plesk y de los típicos errores módulos PrestaShop. Al final, encontrarás una sección de preguntas frecuentes (FAQ) para resolver las dudas más comunes.

Vamos a ello.

¿Por qué surgen problemas de compatibilidad entre PrestaShop y Plesk?

Plesk es un panel de control muy potente y usado en servidores dedicados y VPS. Sin embargo, su configuración por defecto puede chocar con los requisitos técnicos de algunos módulos de PrestaShop. Los principales causantes son:

1. Versiones de PHP desactualizadas o incorrectas

PrestaShop 1.7 y 8.x requieren PHP 7.4 o superior (idealmente PHP 8.0 o 8.1). Pero muchos módulos, sobre todo los antiguos o de terceros, pueden necesitar versiones específicas. Si en Plesk tienes configurado PHP 7.2 o inferior, muchos módulos PrestaShop Plesk dejarán de funcionar o mostrarán errores.

[WARNING] No mezcles versiones de PHP. Si tu PrestaShop corre con PHP 8.0, todos los módulos deben ser compatibles con esa versión. Un solo módulo desactualizado puede romper toda la tienda.

2. Limitaciones de memoria y ejecución

Plesk suele tener límites de memoria PHP (memory_limit) y tiempo máximo de ejecución (max_execution_time) bastante restrictivos para entornos compartidos. Al instalar un módulo pesado (por ejemplo, un constructor de páginas o un módulo de importación masiva), estos límites se sobrepasan y obtienes errores como "500 Internal Server Error" o "Allowed memory size exhausted".

3. Permisos de archivos y propietarios

Plesk gestiona los sitios web bajo usuarios del sistema. Si al instalar un módulo se crean archivos con propietarios incorrectos (por ejemplo, root en lugar del usuario del sitio), PrestaShop no podrá leerlos ni escribirlos. Esto provoca errores de permisos y fallos en la activación del módulo.

4. Extensiones PHP faltantes o incompatibles

Muchos módulos necesitan extensiones específicas de PHP: curl, gd, mbstring, zip, intl, etc. En Plesk, a veces estas extensiones no están habilitadas por defecto. Si tu módulo requiere imagick y solo tienes gd, te dará un error de dependencia.

Síntomas típicos de errores de módulos en PrestaShop con Plesk

Antes de solucionar, aprende a reconocer los síntomas. Esto te ahorrará horas de búsqueda.

Error 500 o pantalla blanca al activar un módulo

Es el más común. Ocurre justo después de hacer clic en "Activar" o "Instalar". El módulo genera un error fatal de PHP que PrestaShop no puede capturar.

Mensaje "No se puede cargar el módulo" o "Clase no encontrada"

Aparece en la lista de módulos. Indica que el archivo principal del módulo (el que tiene la clase) no se encuentra o no se puede leer. Casi siempre es por permisos incorrectos.

Errores de memoria en el log de PHP

Revisa el archivo error_log de tu servidor. Si ves líneas como PHP Fatal error: Allowed memory size of 134217728 bytes exhausted, es que el módulo necesita más memoria de la que Plesk permite.

El módulo se instala pero no funciona correctamente

Puede que se active, pero las funciones no respondan: no envía emails, no procesa pagos, no muestra imágenes. Esto suele deberse a extensiones PHP faltantes o a conflictos con otros módulos.

Cómo diagnosticar el problema paso a paso

Sigue esta guía para identificar la causa raíz. No saltes pasos.

1. Activa el modo debug de PrestaShop

Esto te mostrará los errores PHP en lugar de la pantalla blanca.

Accede por FTP o al gestor de archivos de Plesk.
Abre el archivo /config/defines.inc.php.
Busca la línea: define('_PS_MODE_DEV_', false);
Cámbiala a: define('_PS_MODE_DEV_', true);
Guarda el archivo.

Ahora, al recargar la página del módulo, verás el error real (por ejemplo, "Class 'ZipArchive' not found").

[TIP] Después de diagnosticar, vuelve a poner false para evitar mostrar información sensible a los visitantes.

2. Revisa la versión de PHP en Plesk

En Plesk, ve a "Sitios web y dominios" > selecciona tu dominio > "Configuración de PHP".
Allí verás la versión de PHP actual. Asegúrate de que sea compatible con tu PrestaShop y con el módulo.

Si tienes varias versiones, puedes cambiarla desde el mismo menú.

3. Comprueba los límites de PHP

En la misma pantalla de configuración de PHP, busca:

memory_limit: debe ser al menos 256M (recomendado 512M).
max_execution_time: al menos 120 segundos.
upload_max_filesize: al menos 64M.
post_max_size: al menos 64M.

Si son más bajos, auméntalos.

4. Verifica los permisos de los archivos del módulo

Conéctate por FTP o al gestor de archivos de Plesk.
Ve a la carpeta /modules/nombre-del-modulo.
Todos los archivos deben pertenecer al usuario del sitio (normalmente www-data o el nombre de usuario de Plesk).
Los permisos de carpetas deben ser 755 y los de archivos 644.

Si ves archivos con propietario root o permisos 777, cámbialos.

Soluciones prácticas para problemas de compatibilidad

Aquí tienes las soluciones más efectivas, ordenadas de menor a mayor complejidad.

Solución 1: Ajustar la configuración de PHP en Plesk

Esta es la primera acción y resuelve el 80% de los casos.

Accede a "Sitios web y dominios" > tu dominio > "Configuración de PHP".
Cambia la versión de PHP a 8.0 o 8.1 (si tu PrestaShop lo soporta).
Aumenta memory_limit a 512M y max_execution_time a 180.
Habilita todas las extensiones que aparecen en la lista: curl, gd, mbstring, zip, intl, openssl, pdo_mysql.
Guarda los cambios y reinicia el servicio PHP desde el mismo panel (o espera unos segundos).

Solución 2: Forzar la compatibilidad del módulo

Algunos módulos no están actualizados para PrestaShop 8.x. Puedes forzarlos, pero con cuidado.

Ve a "Módulos" > "Módulos y servicios" en el back office de PrestaShop.
Busca el módulo problemático.
Haz clic en el botón "Configurar" o en el icono de engranaje.
Si no aparece, intenta esta solución técnica:

Accede a la base de datos de PrestaShop (por ejemplo, con phpMyAdmin en Plesk).
Busca la tabla ps_module (el prefijo puede variar).
Localiza el módulo por su nombre y cambia el valor de version a una compatible con tu PrestaShop (por ejemplo, 8.0.0).
Luego, en la tabla ps_module_shop, asegúrate de que esté activo.

[WARNING] Forzar la compatibilidad puede causar errores ocultos. Úsalo solo como último recurso y tras hacer backup.

Solución 3: Reinstalar el módulo manualmente

A veces, la instalación automática falla por permisos. Hazlo manual.

Descarga el módulo desde la fuente oficial (por ejemplo, Addons de PrestaShop).
Descomprímelo en tu ordenador.
Sube la carpeta del módulo a /modules/ mediante FTP.
Ve al back office > "Módulos" > "Módulos y servicios".
Haz clic en "Instalar" junto al nombre del módulo (debería aparecer ahora).

Solución 4: Usar un entorno de hosting optimizado

Si los problemas persisten, considera migrar a un hosting especializado en PrestaShop o ajustar Plesk a nivel de servidor. Por ejemplo, si usas Syspanel (antes HestiaCP), recuerda que el puerto de acceso es el 2106 y suele ofrecer configuraciones más flexibles para tiendas.

Preguntas Frecuentes (FAQ)

¿Puedo usar cualquier módulo de PrestaShop con Plesk?

Sí, siempre que el módulo sea compatible con la versión de PrestaShop y de PHP que tengas. Plesk no bloquea módulos, pero su configuración por defecto puede ser restrictiva.

¿Cómo sé si un módulo es compatible con mi versión de PHP?

Revisa la ficha del módulo en la tienda de PrestaShop Addons. Busca "Requisitos" o "Compatibilidad". Si no aparece, contacta al desarrollador.

¿Por qué después de actualizar PrestaShop algunos módulos dejaron de funcionar?

Las actualizaciones de PrestaShop suelen cambiar funciones internas. Los módulos antiguos pueden no estar adaptados. La solución es actualizar los módulos o contactar al desarrollador.

¿Qué hago si el módulo da error "Class not found"?

Es un problema de permisos o de archivos faltantes. Revisa que la carpeta del módulo esté completa y con permisos correctos (755 carpetas, 644 archivos).

¿Plesk tiene alguna herramienta para diagnosticar problemas de módulos?

Sí, en Plesk puedes usar el "Monitor de errores" (en "Herramientas y ajustes") y los logs de PHP (en "Sitios web y dominios" > "Logs"). También puedes instalar módulos de terceros como "PrestaShop Troubleshooter".

Conclusión

Los problemas de compatibilidad PrestaShop Plesk son frustrantes, pero casi siempre tienen solución. La clave está en diagnosticar correctamente: revisar la versión de PHP, los límites de memoria y los permisos de archivos. Ajustando estos parámetros, la mayoría de los errores módulos PrestaShop desaparecen.

Si después de seguir esta guía el problema persiste, no dudes en contactar a tu proveedor de hosting o al soporte de Plesk. Y recuerda: antes de instalar cualquier módulo, haz siempre una copia de seguridad completa de tu tienda y base de datos.

[TIP] Mantén tu PrestaShop y todos los módulos siempre actualizados. La mayoría de los problemas de compatibilidad se solucionan con las últimas versiones.

Esperamos que este artículo te haya sido de ayuda. Si tienes más dudas, déjalas en los comentarios o consulta nuestra sección de FAQs. ¡Buena suerte con tu tienda!