Introducción
Uno de los problemas más frustrantes a los que se enfrentan los administradores de tiendas online es cuando intentan instalar, actualizar o desinstalar un complemento y se encuentran con el molesto error de módulo que no se puede cargar en PrestaShop. Este fallo interrumpe la gestión del sitio y puede dejar tu backoffice inestable. En este artículo te explicamos por qué ocurre y cómo solucionarlo paso a paso.
Causas Principales del Error en Módulos de PrestaShop
Este problema suele estar relacionado con limitaciones del servidor, archivos corruptos o problemas de permisos. Las causas más comunes son:
- Límite de tamaño de subida superado (
upload_max_filesizeopost_max_sizemuy bajos en PHP). - Permisos incorrectos en la carpeta
/modules/del servidor. - Falta de memoria RAM asignada al script de PHP (
memory_limit). - Descarga incompleta o corrupta del archivo ZIP del módulo.
Método 1: Aumentar los límites de PHP en el servidor
La causa más frecuente es que el archivo ZIP del módulo supere el límite permitido por tu servidor. Para solucionarlo, debes editar el archivo php.ini o ajustarlo desde el panel de tu hosting (cPanel o Plesk):
- Accede al panel de control de tu hosting y busca la opción Seleccionar versión de PHP o MultiPHP INI Editor.
- Modifica los siguientes valores recomendados para PrestaShop:
upload_max_filesize = 64Mpost_max_size = 64Mmax_execution_time = 300memory_limit = 256M - Guarda los cambios y vuelve a intentar subir el módulo desde el panel de administración de PrestaShop.
Método 2: Corregir los permisos de archivos y carpetas vía FTP
Si los permisos de escritura en tu servidor son incorrectos, PrestaShop no podrá descomprimir el módulo correctamente:
- Conéctate a tu servidor utilizando un cliente FTP (como FileZilla).
- Navega hasta la raíz de tu instalación de PrestaShop.
- Haz clic derecho sobre la carpeta
modulesy selecciona Permisos de archivo (ochmod). - Asegúrate de que los permisos estén establecidos en
755para carpetas y644para los archivos internos, marcando la opción de aplicar a todos los subdirectorios.
Método 3: Instalación manual del módulo por FTP
Si el instalador automático sigue fallando, puedes subir el módulo directamente al servidor:
- Descomprime el archivo
.zipdel módulo en tu ordenador. - Conéctate por FTP a tu tienda y sube la carpeta descomprimida al directorio
/modules/de tu PrestaShop. - Entra a tu backoffice, ve a Módulos > Gestor de módulos.
- Busca el módulo recién subido en la lista y haz clic en Instalar.