FAQ: Módulos PrestaShop en cPanel - Instalación y problemas

¿Qué son los módulos en PrestaShop y por qué son importantes?

Los módulos en PrestaShop son como aplicaciones o extensiones que añaden funcionalidades específicas a tu tienda online. Piensa en ellos como los "ladrillos" que construyen la experiencia de tus clientes: desde sistemas de pago (PayPal, Stripe), hasta herramientas de envío, SEO, marketing, o personalización del diseño. Sin módulos, tu PrestaShop sería una tienda básica y limitada.

Cuando trabajas con un hosting que usa cPanel, gestionar estos módulos se vuelve mucho más sencillo. cPanel te permite acceder directamente a los archivos de tu tienda, subir módulos manualmente, y solucionar problemas de compatibilidad o permisos. Esta guía de PrestaShop módulos FAQ está diseñada para resolver las dudas más comunes que tienen los usuarios, especialmente aquellos que no son expertos técnicos.

¿Cómo instalar módulos PrestaShop desde cPanel?

Instalar módulos PrestaShop cPanel puede hacerse de varias formas, pero la más fiable (especialmente si el módulo no aparece en el marketplace oficial) es mediante la subida manual a través de cPanel. Sigue estos pasos:

Descarga el módulo desde una fuente confiable. Normalmente viene en formato .zip o .tar.gz.
Accede a cPanel: Abre tu navegador y escribe tudominio.com/cpanel o tudominio.com:2083. Inicia sesión con tus credenciales de hosting.
Busca el Administrador de Archivos: Dentro de cPanel, haz clic en el icono de "Administrador de Archivos" (File Manager).
Navega a la carpeta de PrestaShop: Ve a public_html (o la carpeta donde hayas instalado PrestaShop, a veces es tienda o prestashop).
Localiza la carpeta de módulos: Dentro de la raíz de PrestaShop, busca la carpeta llamada modules.
Sube el archivo comprimido: Arriba a la izquierda, haz clic en "Subir" y selecciona el archivo .zip del módulo. Espera a que termine.
Extrae el contenido: Una vez subido, verás el archivo .zip en la lista. Haz clic derecho sobre él y selecciona "Extraer". Se creará una carpeta con el nombre del módulo.
Verifica los permisos: A veces los archivos extraídos tienen permisos incorrectos. Selecciona la carpeta del módulo, haz clic derecho > "Cambiar permisos" y ajústalos a 755 para las carpetas y 644 para los archivos (esto es estándar en PrestaShop).
Activa el módulo en el panel de administración: Ve a tu backoffice de PrestaShop (normalmente tudominio.com/admin), luego a "Módulos" > "Gestor de módulos". Busca el módulo recién subido y haz clic en "Instalar".

[TIP] Si el módulo no aparece después de subirlo, limpia la caché de PrestaShop desde "Parámetros avanzados" > "Rendimiento" > "Limpiar caché".

Preguntas frecuentes sobre módulos en PrestaShop con cPanel

1. ¿Por qué algunos módulos no se instalan correctamente desde el backoffice?

Esto suele pasar por límites de subida de archivos en el servidor. cPanel permite ajustar esto fácilmente.

Solución: Accede a cPanel > "Seleccionar versión de PHP" (o "MultiPHP Manager"). Busca la opción upload_max_filesize y post_max_size y cámbialas a un valor mayor (por ejemplo, 64M o 128M). Luego, repite la instalación.

2. ¿Puedo instalar módulos de pago sin afectar mi tienda?

Sí, pero siempre es recomendable hacer una copia de seguridad primero. En cPanel, usa la herramienta "Copias de seguridad" para respaldar toda la carpeta public_html y la base de datos. Así, si algo sale mal, puedes restaurar todo en minutos.

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

Antes de descargar, revisa la descripción del módulo. Busca la frase "Compatibilidad: PrestaShop 1.6, 1.7, 8.x". Si no está claro, contacta al desarrollador. En cPanel, puedes verificar tu versión de PrestaShop yendo a "Parámetros avanzados" > "Información" en el backoffice.

4. ¿Qué hago si un módulo da error después de instalarlo?

Primero, desactívalo desde el backoffice (Módulos > Gestor de módulos, busca el módulo y haz clic en "Desinstalar"). Si el error persiste (por ejemplo, la tienda deja de cargar), accede a cPanel y elimina la carpeta del módulo dentro de public_html/modules. Luego, limpia la caché de PrestaShop.

[WARNING] No elimines módulos que vienen por defecto con PrestaShop (como "ps_mainmenu" o "ps_imageslider") a menos que estés seguro, ya que algunos son necesarios para el funcionamiento básico.

5. ¿Es seguro usar módulos de terceros descargados de internet?

Depende de la fuente. Siempre prefiere el marketplace oficial de PrestaShop o desarrolladores reconocidos. Si descargas de sitios no oficiales, puedes exponer tu tienda a malware o vulnerabilidades. En cPanel, puedes escanear la carpeta modules con la herramienta "Virus Scanner" (si tu hosting la ofrece) o usar un plugin de seguridad.

6. ¿Cómo actualizar un módulo manualmente desde cPanel?

Descarga la nueva versión del módulo.
En cPanel, ve a public_html/modules y renombra la carpeta del módulo antiguo (por ejemplo, añade "_old" al final). Esto es por si necesitas volver atrás.
Sube y extrae el nuevo archivo .zip en la misma ubicación.
Ve al backoffice y verifica que el módulo aparezca con la nueva versión. Si no, reinstálalo.

7. ¿Puedo tener demasiados módulos instalados? ¿Afecta el rendimiento?

Sí. Cada módulo consume recursos del servidor y puede ralentizar tu tienda. Lo ideal es tener solo los módulos esenciales. Para revisar el consumo, en cPanel puedes usar "Estadísticas del sitio" o "Monitor de recursos". Si notas lentitud, desinstala módulos que no uses.

8. ¿Qué hago si el módulo requiere modificar archivos del núcleo de PrestaShop?

Evita a toda costa modificar archivos del núcleo (como classes/ o controllers/), porque las actualizaciones de PrestaShop los sobrescribirán. En su lugar, busca un módulo que use overrides (sobrescrituras) o contrata a un desarrollador. Si es inevitable, haz una copia de seguridad completa desde cPanel antes de tocar nada.

9. ¿Cómo solucionar el error "No se puede escribir en el directorio de módulos"?

Esto indica que los permisos de la carpeta modules están mal configurados. En cPanel:

Ve a public_html/modules.
Selecciona la carpeta y haz clic derecho > "Cambiar permisos".
Asegúrate de que esté en 755 (o 777 temporalmente para instalación, pero luego vuelve a 755).

10. ¿Puedo instalar módulos si mi hosting usa Syspanel en lugar de cPanel?

Sí, aunque el proceso es diferente. Si tu hosting usa Syspanel (anteriormente conocido como HestiaCP), el acceso se realiza por el puerto 2106 (ejemplo: tudominio.com:2106). Dentro de Syspanel, busca la opción "Administrador de archivos" y sigue los mismos pasos que con cPanel para subir y extraer módulos. La estructura de carpetas es similar.

[INFO] Si tu hosting usa Syspanel, recuerda que el puerto por defecto para el panel de control es el 2106, no el 2083 como en cPanel.

Errores comunes al instalar módulos PrestaShop y cómo solucionarlos desde cPanel

Error: "El archivo no es un módulo válido"

Causa: El archivo .zip está corrupto o no es compatible.
Solución: Descarga nuevamente el módulo desde la fuente oficial. Verifica que el archivo se haya subido completo (compara el tamaño en cPanel con el original).

Error: "No se puede conectar a la base de datos"

Causa: El módulo intenta crear tablas en la base de datos pero no tiene permisos.
Solución: En cPanel, ve a "Bases de datos MySQL" y asegúrate de que el usuario de la base de datos tenga todos los privilegios. Luego, reinstala el módulo.

Error: "La página se queda en blanco después de instalar un módulo"

Causa: Conflicto de PHP o error fatal en el código del módulo.
Solución: Accede a cPanel > "Registros de errores" y busca el archivo error_log en la raíz de PrestaShop. Allí verás el error exacto. Temporalmente, desactiva el módulo eliminando su carpeta desde public_html/modules.

Consejos finales para gestionar módulos PrestaShop con cPanel

Mantén todo actualizado: Tanto PrestaShop como los módulos y el propio cPanel (a través de tu hosting). Las actualizaciones corrigen vulnerabilidades.
Usa un entorno de pruebas: Si tu hosting lo permite, crea una subcarpeta (ej. public_html/test) e instala una copia de tu tienda para probar módulos nuevos antes de ponerlos en producción.
Documenta los cambios: Lleva un registro de qué módulos instalas y cuándo. Esto te ayudará a resolver problemas futuros.

Recuerda que la clave para una tienda exitosa es tener solo los módulos que realmente necesitas y mantenerlos optimizados. Con esta guía de PrestaShop módulos FAQ y el poder de cPanel, estarás listo para gestionar cualquier módulo que tu negocio requiera. ¡No dudes en consultar a tu proveedor de hosting si tienes dudas específicas sobre la configuración de tu servidor!