Errores al instalar módulos en PrestaShop | FAQ y soluciones

¿Te ha pasado alguna vez que intentas instalar un módulo en tu tienda PrestaShop y, de repente, aparece un mensaje de error que no entiendes? Tranquilo, no eres el único. Los errores módulos PrestaShop son una de las consultas más frecuentes en soporte técnico. Instalar módulos es una tarea habitual para ampliar funciones, pero a veces surgen fallos que pueden desanimar incluso al más experimentado.

En esta guía, vamos a desglosar los problemas más comunes al instalar módulos PrestaShop, desde errores de permisos hasta conflictos de compatibilidad. Te explicaré, paso a paso, cómo solucionar errores PrestaShop para que puedas seguir personalizando tu tienda sin dolores de cabeza. Además, al final encontrarás una sección FAQ PrestaShop módulos con respuestas rápidas a las dudas más habituales.

Error de permisos de archivos y carpetas

Uno de los errores módulos PrestaShop más comunes al subir un módulo es el mensaje: "No se puede escribir en el directorio" o "Permiso denegado". Esto sucede porque el servidor web no tiene los permisos adecuados para crear o modificar archivos.

¿Por qué ocurre?

Cuando instalas un módulo, PrestaShop necesita descomprimir archivos y copiarlos en la carpeta /modules. Si el usuario del servidor web (por ejemplo, www-data en Apache) no tiene permisos de escritura, la instalación falla.

Cómo solucionarlo

Accede a tu panel de control. Si usas Syspanel, recuerda que el puerto de acceso es el 2106.
Localiza el gestor de archivos o usa un cliente FTP (como FileZilla).
Navega hasta la carpeta raíz de tu PrestaShop, normalmente public_html o www.
Busca la carpeta /modules y haz clic derecho > Propiedades (o Permisos).
Cambia los permisos a 755 para directorios y 644 para archivos. Si ves que sigue fallando, prueba temporalmente con 777 (aunque no es recomendable dejarlo así por seguridad).
También verifica la carpeta /cache y /config, a veces necesitan permisos de escritura.

[WARNING] No dejes los permisos en 777 permanentemente. Después de instalar el módulo, vuelve a establecer 755 para carpetas y 644 para archivos.

Error de límite de memoria PHP

Otro clásico cuando intentas instalar módulos PrestaShop es el mensaje: "Fatal error: Allowed memory size exhausted". Esto indica que el script ha superado el límite de memoria permitido por PHP.

¿Por qué ocurre?

Los módulos, especialmente los que incluyen muchas funciones o imágenes, consumen bastante memoria. Si tu servidor tiene un límite bajo (por ejemplo, 32 MB o 64 MB), la instalación se interrumpe.

Cómo solucionarlo

Accede a Syspanel (puerto 2106) o a tu panel de hosting.
Busca la opción PHP Settings o Configuración de PHP.
Aumenta el valor de memory_limit a 256 MB o incluso 512 MB. También puedes subir upload_max_filesize y post_max_size a 64 MB para evitar problemas al subir módulos pesados.
Guarda los cambios y reinicia el servicio web (Apache/Nginx) desde el panel.
Si no tienes acceso a la configuración global, puedes crear un archivo php.ini en la raíz de tu PrestaShop con estas líneas:
```
memory_limit = 256M
upload_max_filesize = 64M
post_max_size = 64M
```

[TIP] Algunos módulos muy grandes (como los de importación masiva) pueden necesitar hasta 512 MB. Si tu hosting no lo permite, considera actualizar tu plan.

Error de compatibilidad de versiones

¿Has descargado un módulo y al subirlo te sale "Este módulo no es compatible con tu versión de PrestaShop"? Es uno de los errores módulos PrestaShop más frustrantes, pero tiene solución.

¿Por qué ocurre?

Cada módulo está desarrollado para una versión específica de PrestaShop (1.6, 1.7, 8.x). Si intentas instalar un módulo de PS 1.6 en PS 1.7, las funciones internas han cambiado y el código no funciona.

Cómo solucionarlo

Verifica la versión de tu tienda: Ve a Parámetros avanzados > Información y anota la versión exacta.
Descarga la versión correcta: Vuelve al sitio donde compraste o descargaste el módulo y busca la versión compatible con tu PrestaShop.
Forzar instalación (con cuidado): Si no encuentras una versión actualizada, puedes editar el archivo config.xml dentro del módulo. Busca la línea <version> y cámbiala por una compatible. Pero esto puede romper la tienda, así que hazlo solo si sabes lo que haces y tienes un backup.
Usa un emulador de versión: Algunos módulos permiten instalar un parche de compatibilidad. Consulta la documentación del desarrollador.

[INFO] Siempre es mejor contactar al desarrollador del módulo para pedir una actualización. Forzar la instalación puede causar errores inesperados.

Error de conflicto con otros módulos

A veces, después de instalar módulos PrestaShop, la tienda se vuelve lenta o aparecen errores en el front-end. Esto suele deberse a conflictos entre módulos.

¿Por qué ocurre?

Dos módulos pueden intentar modificar la misma función o hook (gancho) de PrestaShop. Por ejemplo, un módulo de SEO y otro de caché pueden pelear por el mismo espacio.

Cómo solucionarlo

Desactiva todos los módulos: Ve a Módulos > Gestor de módulos y desactiva todos excepto el que acabas de instalar.
Reactiva uno por uno: Activa cada módulo de uno en uno y revisa si el error vuelve a aparecer. Cuando lo haga, sabrás cuál es el conflicto.
Busca alternativas: Si encuentras el módulo conflictivo, busca una actualización o un módulo similar que sea compatible.
Ajusta el orden de carga: En algunos casos, puedes cambiar el orden en que se ejecutan los hooks editando el archivo override.php (solo para avanzados).

[WARNING] No elimines módulos importantes como "PrestaShop Cleaner" o "Cache" sin antes verificar que no son esenciales para el funcionamiento.

Error al subir el módulo por el panel de administración

Otro fallo común: subes el archivo .zip del módulo, pero PrestaShop no lo reconoce o muestra "Error al subir el archivo".

¿Por qué ocurre?

Puede deberse a un tamaño de archivo demasiado grande, un formato incorrecto o problemas con la conexión FTP temporal.

Cómo solucionarlo

Comprueba el tamaño: Ve a Parámetros avanzados > Rendimiento y asegúrate de que el límite de subida sea suficiente. Si no, ajústalo como explicamos antes.
Sube manualmente por FTP: Si el panel falla, usa FileZilla para subir el módulo directamente a la carpeta /modules. Descomprime el .zip localmente y sube la carpeta entera.
Verifica el nombre: El módulo debe tener un nombre único y sin caracteres especiales (solo letras y números). Evita espacios.
Limpia la caché de PrestaShop: Ve a Parámetros avanzados > Rendimiento > Limpiar caché. A veces una caché corrupta impide la instalación.

[TIP] Si el módulo no aparece después de subirlo manualmente, ve a Módulos > Gestor de módulos y haz clic en "Buscar módulos". PrestaShop escaneará la carpeta y lo detectará.

Error de base de datos durante la instalación

Cuando un módulo intenta crear tablas o modificar la base de datos, puede aparecer un error SQL como "Table 'ps_module' already exists" o "SQL syntax error".

¿Por qué ocurre?

El módulo intenta ejecutar consultas SQL que ya han sido aplicadas (por ejemplo, si reinstalaste el mismo módulo) o que tienen errores de sintaxis.

Cómo solucionarlo

Haz una copia de seguridad: Antes de tocar la base de datos, exporta un backup desde phpMyAdmin o Syspanel.
Revisa las tablas: Con phpMyAdmin, busca tablas con prefijo ps_ (o el que uses) relacionadas con el módulo. Si existen, bórralas (con cuidado).
Reinstala el módulo: Desinstala el módulo desde el panel, luego vuelve a instalarlo. Esto suele regenerar las tablas correctamente.
Repara la base de datos: En phpMyAdmin, selecciona todas las tablas y elige "Reparar tabla". A veces corrige errores menores.

[WARNING] No borres tablas de otros módulos o de PrestaShop core. Solo elimina las que pertenezcan al módulo problemático.

Error de JavaScript o CSS después de instalar

¿La tienda se ve rara o los botones no funcionan después de activar un módulo? Esto indica un conflicto de recursos estáticos.

¿Por qué ocurre?

El módulo carga sus propios archivos JS y CSS que pueden chocar con los de la plantilla o de otros módulos.

Cómo solucionarlo

Limpia la caché de assets: Ve a Parámetros avanzados > Rendimiento y marca "Forzar compilación" en las opciones de Smarty. Luego, limpia la caché.
Desactiva el modo CCS/JS combinado: Temporalmente, desmarca "Combinar archivos CSS" y "Combinar archivos JavaScript" en la misma página. Esto ayuda a identificar qué archivo causa el error.
Usa las herramientas de desarrollador: En Chrome, pulsa F12 y ve a la consola. Los errores de JavaScript aparecerán en rojo. Copia el mensaje y búscalo en Google.
Contacta al desarrollador: Si el error persiste, el módulo puede tener un bug. Reporta el problema con la versión de tu PrestaShop y plantilla.

[INFO] A veces, simplemente cambiar el orden de carga de los módulos en Módulos > Posiciones puede solucionar el conflicto.

FAQ PrestaShop módulos

Aquí tienes respuestas rápidas a las preguntas más frecuentes sobre errores módulos PrestaShop.

¿Por qué mi módulo no aparece en la lista después de subirlo?

Asegúrate de haberlo subido a la carpeta /modules correcta. Luego, ve a Módulos > Gestor de módulos y haz clic en "Buscar módulos". Si sigue sin aparecer, verifica que el nombre de la carpeta coincida con el del módulo.

¿Puedo instalar un módulo de PrestaShop 1.6 en la versión 1.7?

No es recomendable. Los módulos de 1.6 no son compatibles con 1.7 debido a cambios en el núcleo. Busca una versión actualizada o un módulo alternativo.

¿Cómo sé si un módulo es seguro?

Descarga módulos solo de fuentes oficiales (Addons de PrestaShop) o de desarrolladores de confianza. Revisa las reseñas y la fecha de actualización. Un módulo sin actualizar desde hace 2 años es un riesgo de seguridad.

¿Qué hago si el módulo rompe mi tienda?

Activa el modo de mantenimiento en Parámetros avanzados > Mantenimiento. Luego, desinstala el módulo desde la base de datos (borrando las tablas) o restaurando un backup. Siempre ten un backup reciente.

¿El error "500 Internal Server Error" al instalar un módulo tiene solución?

Sí, suele deberse a un error de PHP. Revisa los logs de error en tu panel (Syspanel) o en la carpeta /var/log. Aumenta el límite de memoria o desactiva módulos conflictivos.

¿Puedo instalar módulos desde la línea de comandos?

Sí, si tienes acceso SSH. Navega a la raíz de PrestaShop y usa:

php bin/console prestashop:module install nombre_del_modulo

Esto evita errores de tiempo de subida o memoria.

Consejos finales para evitar errores al instalar módulos

Para terminar, aquí van algunos consejos prácticos que te ahorrarán muchos quebraderos de cabeza:

Siempre haz un backup antes de instalar un módulo nuevo. Puedes hacerlo desde Syspanel (puerto 2106) o con herramientas como PrestaShop Backup.
Actualiza PrestaShop a la última versión estable. Los módulos más recientes suelen ser compatibles con las versiones más actuales.
Prueba en un entorno de desarrollo si tienes uno. Así evitas romper la tienda en producción.
Lee la documentación del módulo antes de instalarlo. Muchos errores se evitan siguiendo los pasos del desarrollador.
Mantén los módulos actualizados. Las actualizaciones corrigen bugs y vulnerabilidades.

Recuerda que los errores módulos PrestaShop son normales, especialmente si tu tienda tiene muchas personalizaciones. Con paciencia y siguiendo estos pasos, podrás solucionar errores PrestaShop sin necesidad de ser un experto. Si el problema persiste, no dudes en contactar a tu proveedor de hosting o al desarrollador del módulo.

Espero que esta guía te haya sido útil. ¡Ahora ya puedes instalar módulos con confianza!