Cómo Solucionar el Error de Módulos que No Se Pueden Instalar en PrestaShop Paso a Paso

Introducción al Problema de Instalación de Módulos

Uno de los dolores de cabeza más frecuentes para los administradores de tiendas online es intentar subir un módulo nuevo al backoffice y encontrarse con un error repentino. Este fallo impide ampliar las funcionalidades del e-commerce, afectando directamente a las operaciones diarias. Afortunadamente, tiene solución si se identifican las causas raíz correctamente.

Causas Principales del Error

Existen diversos motivos por los cuales PrestaShop bloquea la instalación de un archivo comprimido (.zip):

• Límite de tamaño de subida en PHP: El archivo del módulo supera el tamaño máximo permitido por el servidor.
• Falta de permisos en carpetas: El directorio /modules/ no tiene los permisos de escritura adecuados.
• Tiempo de espera agotado (Timeout): El servidor tarda demasiado en descomprimir el archivo y cancela el proceso.
• Incompatibilidad de versión: El módulo no es compatible con la versión actual de PrestaShop o de PHP.

Método 1: Aumentar los Límites de PHP en el Servidor

Para solucionar problemas relacionados con el tamaño de archivos o tiempos de espera, debes modificar los parámetros de configuración de PHP en tu archivo php.ini o desde cPanel:

1. Accede al panel de control de tu hosting (cPanel, Plesk, etc.).
2. Busca la herramienta Seleccionar versión de PHP o MultiPHP INI Editor.
3. Modifica los siguientes valores recomendados:
   upload_max_filesize = 64M
post_max_size = 64M
max_execution_time = 300
memory_limit = 256M
4. Guarda los cambios y vuelve a intentar la instalación en PrestaShop.

Método 2: Corrección de Permisos de Archivos vía FTP

Si el servidor no puede descomprimir el módulo por falta de privilegios, debes ajustar los permisos mediante un cliente FTP como FileZilla:

1. Conéctate a tu servidor mediante FTP.
2. Navega hasta la raíz de tu instalación de PrestaShop.
3. Localiza la carpeta modules.
4. Haz clic derecho sobre ella y selecciona Permisos de archivo (o CHMOD).
5. Establece el valor numérico en 755 (asegúrate de marcar aplicar a subdirectorios y archivos).
6. Repite el proceso si es necesario y reintenta la subida del módulo.

Método 3: Instalación Manual por FTP (Alternativa Definitiva)

Si el backoffice sigue dando errores, puedes instalar el módulo manualmente:

1. Descomprime el archivo .zip del módulo en tu ordenador.
2. Sube la carpeta resultante mediante FTP dentro del directorio /tu_raiz_prestashop/modules/.
3. Entra a tu panel de administración de PrestaShop.
4. Dirígete a Módulos > Gestor de módulos.
5. Busca el módulo en la lista y haz clic en Instalar.