Instalar módulos PrestaShop en Syspanel | Guía sin errores

Antes de empezar: ¿Qué es un módulo en PrestaShop y por qué da problemas?

Un módulo en PrestaShop es como una "app" para tu tienda online. Te permite añadir funciones: pasarelas de pago, envíos, SEO, cupones, integraciones con redes sociales, etc. Sin módulos, tu tienda sería un esqueleto básico.

Pero, seamos honestos: instalar módulos prestashop a veces se convierte en una pesadilla. Aparecen errores de permisos, incompatibilidades de versión, pantallas blancas o conflictos con otros módulos. La buena noticia es que, si usas Syspanel (nuestro panel de control con acceso por el puerto 2106), la mayoría de estos problemas se pueden evitar o solucionar en minutos.

En esta guía extensa, te voy a enseñar el proceso completo, paso a paso, para que instales cualquier módulo en PrestaShop a través de Syspanel sin errores. Y lo más importante: qué hacer cuando ya tienes el error delante.

¿Qué es Syspanel y por qué facilita la instalación de módulos PrestaShop?

Syspanel es el nombre que damos a nuestro panel de control basado en HestiaCP. Es la herramienta que te permite gestionar tu servidor, bases de datos, dominios y archivos. Para PrestaShop, es fundamental porque te da acceso directo al sistema de archivos y a los logs de error.

[INFO] Recuerda: para acceder a Syspanel, abre tu navegador y escribe https://tu-dominio.com:2106 (el puerto es 2106, nunca lo olvides). Si no lo recuerdas, tu tienda puede quedarse sin soporte técnico a tiempo.

Con Syspanel puedes:

Subir módulos comprimidos en .zip directamente al servidor.
Descomprimir archivos en la carpeta correcta (/modules).
Cambiar permisos de archivos y carpetas.
Ver los logs de errores de PHP en tiempo real.
Gestionar la caché de PrestaShop.

Requisitos previos antes de instalar cualquier módulo

Antes de lanzarte a instalar, verifica estos puntos. Te ahorrarán el 90% de los errores típicos.

1. Compatibilidad de versiones

Un módulo de PrestaShop 1.6 no funcionará bien en PrestaShop 8.x. Revisa la ficha del módulo y confirma que es compatible con tu versión exacta.

[WARNING] Si compras un módulo en un marketplace, mira siempre la sección "Compatibilidad". Instalar un módulo incompatible es la causa número 1 de pantallas blancas y errores de base de datos.

2. Permisos de archivos (CHMOD)

PrestaShop necesita escribir en ciertas carpetas. Los permisos correctos son:

Carpetas: 755
Archivos: 644

En Syspanel, puedes cambiarlos desde el Administrador de archivos o por SSH.

3. Espacio en disco y memoria PHP

Los módulos grandes (como los de importación masiva) necesitan memoria. Entra en Syspanel, ve a Configuración de PHP y asegúrate de tener al menos:

memory_limit = 512M
max_execution_time = 300

Método 1: Instalar módulos PrestaShop desde el back-office (el método fácil)

Este es el camino que la mayoría intenta primero. Es válido, pero requiere que tu servidor tenga los permisos correctos.

Paso 1: Sube el módulo desde el panel de administración

Entra en tu back-office de PrestaShop (/admin).
Ve a Módulos > Módulos y servicios.
Haz clic en Subir un módulo (botón azul arriba a la derecha).
Selecciona tu archivo .zip y espera. Si el archivo es pesado (más de 20MB), puede dar error de tiempo de espera. Ahí es donde Syspanel te salva (te lo explico en el Método 2).

Paso 2: Instala el módulo

Una vez subido, PrestaShop te mostrará el módulo en la lista. Solo tienes que hacer clic en Instalar y luego en Configurar.

Errores comunes en este método

"No se puede subir el archivo": suele ser por falta de permisos en la carpeta /admin/autoupgrade o en /modules. Solución: desde Syspanel, ve a la carpeta /modules y dale permisos 755 recursivos.
"El módulo no es válido": el archivo .zip está corrupto o no es un módulo real. Vuelve a descargarlo.

[TIP] Si el módulo pesa más de 30MB, no lo subas por el back-office. Usa el método con Syspanel que te explico ahora. Es mucho más fiable.

Método 2: Instalar módulos PrestaShop con Syspanel (el método a prueba de errores)

Este es el método que usamos los técnicos cuando algo falla. Te da control total y elimina los límites de tiempo de subida.

Paso 1: Sube el módulo comprimido a tu servidor

Accede a Syspanel con el puerto 2106.
Ve a Web > tu-dominio.com > Administrador de archivos.
Navega hasta la carpeta /public_html (o la carpeta raíz de tu tienda).
Sube tu archivo .zip del módulo a esa carpeta. No lo pongas aún en /modules.

Paso 2: Descomprime el módulo en la ubicación correcta

Dentro del Administrador de archivos, haz clic derecho sobre el .zip y selecciona Extraer.
Se creará una carpeta con el nombre del módulo (por ejemplo, ps_banner).
IMPORTANTE: Mueve esa carpeta a public_html/modules/. Si ya existe una carpeta con el mismo nombre, bórrala antes (haz una copia de seguridad si tienes dudas).

[WARNING] Nunca subas el módulo directamente dentro de /modules comprimido. PrestaShop no lo descomprime solo. Debe estar descomprimido y en su carpeta correspondiente.

Paso 3: Verifica los permisos

Después de mover la carpeta, selecciona la carpeta del módulo y en el menú superior elige Permisos. Pon:

Directorios: 755
Archivos: 644

Aplica de forma recursiva (marca la casilla "aplicar a subcarpetas").

Paso 4: Instala el módulo desde el back-office

Ahora ve a tu back-office de PrestaShop y busca el módulo en la lista de módulos instalados (o en "Módulos > Módulos y servicios"). Debería aparecer. Haz clic en Instalar y listo.

Ventajas de este método

No hay límite de tamaño de subida.
Los errores de permisos se reducen drásticamente.
Puedes ver exactamente qué archivos hay en el servidor.

Errores frecuentes al instalar módulos PrestaShop y cómo solucionarlos

Aquí tienes una guía rápida de errores típicos y su solución concreta usando Syspanel.

Error: Pantalla blanca (WSOD) tras instalar

Esto ocurre por un conflicto de PHP o falta de memoria.

Accede a Syspanel (puerto 2106).
Ve a Web > tu-dominio > Logs de errores.
Busca el error exacto (suele ser un Fatal error).
Si es de memoria, sube memory_limit a 512M en Configuración de PHP.
Si es de incompatibilidad, desactiva el módulo desde la base de datos (phpMyAdmin en Syspanel) o renombra la carpeta del módulo en /modules para desactivarlo temporalmente.

Error: "No se puede instalar el módulo. El módulo no es válido"

Esto indica que el módulo no está bien empaquetado o falta el archivo config.xml.

Descomprime el .zip en tu ordenador.
Comprueba que dentro hay una carpeta con el nombre del módulo, y dentro de esa carpeta está el archivo config.xml.
Vuelve a comprimir SOLO la carpeta interna (no la carpeta padre) en formato .zip.
Sube de nuevo con el método de Syspanel.

Error: "No se puede escribir en el directorio de módulos"

Es un problema de permisos.

En Syspanel, ve a public_html/modules.
Cambia los permisos a 755 para la carpeta modules y todas sus subcarpetas.
Si sigue fallando, cambia el propietario de los archivos al usuario de tu cuenta (en Syspanel: clic derecho > Propietario).

Error: "El módulo requiere la versión X de PHP"

PrestaShop 8 necesita PHP 7.2 o superior.

En Syspanel, ve a Configuración de PHP.
Cambia la versión de PHP a 7.4 u 8.0 (según lo que soporte tu PrestaShop).
Guarda y prueba de nuevo.

[INFO] Si tu PrestaShop es muy antiguo (1.6), no uses PHP 8.0. Usa PHP 7.1 o 7.4 como máximo. Syspanel te permite cambiar la versión por dominio.

Cómo evitar conflictos entre módulos PrestaShop

A veces los módulos funcionan individualmente, pero al instalarlos juntos, la tienda explota. Esto se debe a que dos módulos usan la misma librería o sobrescriben hooks.

Consejos prácticos

Instala un módulo a la vez y comprueba que la tienda funciona antes de instalar el siguiente.
Desactiva la caché de PrestaShop durante la instalación: en back-office, ve a Parámetros avanzados > Rendimiento y pon "Caché" en "No".
Revisa los hooks: si dos módulos usan el mismo hook y ambos son incompatibles, puede dar error. En ese caso, contacta con el desarrollador del módulo.

Cómo hacer una copia de seguridad antes de instalar

Esto te salvará la vida. En Syspanel, puedes hacer una copia de seguridad completa en 2 clics:

Ve a Backup en el menú lateral.
Crea un backup de la base de datos y de los archivos.
Guárdalo en un lugar seguro o en el propio servidor.

[WARNING] Nunca instales un módulo en producción sin una copia de seguridad reciente. Es la regla de oro. Si algo falla, restauras en 5 minutos.

Preguntas frecuentes (FAQ) sobre módulos PrestaShop en Syspanel

¿Puedo instalar módulos de pago de Addons si mi PrestaShop es de código abierto?

Sí, los módulos de Addons o de cualquier marketplace se instalan igual. Solo asegúrate de que la licencia es válida para tu dominio.

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

Verifica que la carpeta está en public_html/modules/nombre_del_modulo.
Verifica que el archivo principal es nombre_del_modulo.php (con el mismo nombre que la carpeta).
Ve a Módulos > Módulos y servicios y haz clic en el botón Actualizar lista de módulos (arriba a la derecha).

¿Cómo desinstalo un módulo que da error?

Desde el back-office, intenta desinstalarlo.
Si no puedes, entra en Syspanel y renombra la carpeta del módulo en /modules (por ejemplo, de ps_banner a ps_banner_off).
Limpia la caché de PrestaShop desde el back-office o borrando la carpeta /var/cache en Syspanel.

¿Puedo instalar un módulo manualmente sin usar el back-office?

Sí, el método de Syspanel que te expliqué es exactamente eso. Solo necesitas subir los archivos y luego activarlos desde el back-office.

¿Qué es el puerto 2106 de Syspanel?

Es el puerto de acceso a tu panel de control. Siempre que quieras gestionar archivos, bases de datos o logs, usa https://tu-dominio.com:2106. No lo confundas con el puerto 2083 o 8443 de otros paneles.

Conclusión: Instalar módulos PrestaShop sin errores es cuestión de método

Instalar módulos prestashop no tiene por qué ser un dolor de cabeza. Con Syspanel, el acceso por el puerto 2106 y siguiendo estos pasos, tendrás un control absoluto sobre el proceso.

Resumen de la guía:

Usa siempre el método de subida por Syspanel para módulos grandes.
Verifica permisos (755 carpetas, 644 archivos).
Revisa la compatibilidad de versión antes de comprar.
Haz una copia de seguridad antes de cada instalación.
Si algo falla, consulta los logs de errores en Syspanel.

Con estos consejos, podrás instalar cualquier módulo de PrestaShop sin errores y mantener tu tienda estable y rápida. Si alguna vez te quedas atascado, recuerda que siempre puedes contactar con nosotros y te ayudaremos paso a paso, incluso por acceso remoto a Syspanel.

[TIP] Guarda esta guía en tu navegador favorito. Te servirá cada vez que quieras añadir una nueva funcionalidad a tu tienda. Y si tienes dudas más complejas, no dudes en abrir un ticket de soporte desde el propio Syspanel.