FAQ: Instalar módulos en PrestaShop desde cPanel | SysAdmin

Introducción: ¿Por qué instalar módulos manualmente en PrestaShop?

Si tienes una tienda online con PrestaShop, sabrás que los módulos son el alma de la personalización. Añaden funcionalidades como pasarelas de pago, envíos, SEO o integración con redes sociales. Sin embargo, no siempre es posible instalarlos directamente desde el backoffice de PrestaShop, ya sea por restricciones de permisos, límites de tamaño de archivo o porque el módulo es de pago y viene en un archivo ZIP.

Aquí es donde entra en juego cPanel, el panel de control de hosting más popular. Desde cPanel puedes instalar módulo PrestaShop cPanel de forma segura y sin complicaciones. En este artículo, resolveremos las preguntas más frecuentes sobre este proceso, paso a paso, para que cualquier usuario, incluso sin experiencia técnica, pueda hacerlo sin miedo.

[INFO] Este artículo está enfocado en cPanel, pero si tu hosting usa Syspanel (antes llamado HestiaCP), el acceso se realiza por el puerto 2106 (ejemplo: https://tudominio.com:2106). El proceso es similar, pero la interfaz varía ligeramente.

¿Qué necesito antes de empezar?

Antes de lanzarte a subir módulo PrestaShop manual, asegúrate de tener lo siguiente:

Acceso a cPanel de tu hosting (usuario y contraseña).
El archivo del módulo en formato .zip o .tar.gz (descargado de una fuente confiable).
Conocer la ruta de instalación de PrestaShop (normalmente public_html o una subcarpeta como tienda).
Credenciales de FTP o acceso al Administrador de archivos de cPanel.
Recomendación: Haz una copia de seguridad de tu tienda antes de instalar cualquier módulo.

[WARNING] No descargues módulos de sitios no oficiales. Siempre usa el marketplace de PrestaShop o el desarrollador original. Los módulos pirata pueden contener malware y comprometer tu tienda.

Preguntas frecuentes sobre instalación de módulos desde cPanel

1. ¿Puedo instalar un módulo directamente desde el backoffice de PrestaShop?

Sí, es la forma más sencilla. Ve a Módulos > Gestor de módulos > Subir un módulo. Seleccionas el archivo ZIP y lo instalas. Pero a veces falla por:

Límite de tamaño de subida en PHP (por defecto suele ser 2MB o 8MB).
Permisos de escritura insuficientes en la carpeta modules.
El módulo es muy pesado (ejemplo: más de 20MB).

Cuando esto ocurre, la solución es instalar módulo PrestaShop cPanel manualmente.

2. ¿Cómo subir un módulo a PrestaShop desde cPanel paso a paso?

Aquí tienes una guía visual y detallada:

Paso 1: Accede a cPanel

Abre tu navegador y escribe: https://tudominio.com/cpanel (o la URL que te haya dado tu hosting).
Inicia sesión con tu usuario y contraseña.

Paso 2: Abre el Administrador de archivos

Busca el icono Administrador de archivos (File Manager). Normalmente está en la sección "Archivos".
Selecciona la carpeta raíz de tu sitio. Si PrestaShop está instalado directamente en tu dominio, elige public_html. Si está en una subcarpeta (ejemplo: public_html/tienda), navega hasta ella.

Paso 3: Localiza la carpeta `modules`

Dentro de la carpeta de PrestaShop, busca la carpeta llamada modules.
Esta es la carpeta donde se almacenan todos los módulos de tu tienda.

Paso 4: Sube el archivo ZIP del módulo

Haz clic en Subir (Upload) en la barra superior.
Selecciona el archivo .zip de tu módulo desde tu computadora.
Espera a que termine la subida (verás una barra de progreso).

[TIP] Si el archivo es muy grande (más de 100MB), es mejor subirlo por FTP (FileZilla) o usar la opción "Subir archivos grandes" que algunos hosting ofrecen.

Paso 5: Extrae el archivo ZIP

Una vez subido, verás el archivo en la lista. Haz clic derecho sobre él y selecciona Extraer (Extract).
Confirma la extracción. Se creará una carpeta con el nombre del módulo (ejemplo: micodigo).
Opcional: Puedes eliminar el archivo ZIP después de extraerlo para mantener ordenada la carpeta.

Paso 6: Verifica permisos de la carpeta

Para que PrestaShop pueda leer el módulo, la carpeta debe tener permisos 755 (o 0755). Si no, haz clic derecho sobre la carpeta del módulo, selecciona Cambiar permisos y escribe 755.
Los archivos dentro deben tener permisos 644.

Paso 7: Instala el módulo desde el backoffice

Ahora ve al backoffice de tu tienda (ejemplo: tudominio.com/adminXXXX).
Ve a Módulos > Gestor de módulos.
Busca el módulo recién subido (puede aparecer en la lista de módulos no instalados).
Haz clic en Instalar. Si todo está correcto, se activará.

[INFO] Si no ves el módulo, revisa que la carpeta esté en la ruta correcta y que los permisos sean los adecuados. También puedes forzar la recarga del caché de módulos desde Parámetros de la tienda > Rendimiento > Forzar compilación.

3. ¿Qué hago si el módulo no aparece después de subirlo?

Este es un problema común. Causas posibles y soluciones:

Caché de PrestaShop: Limpia la caché desde Parámetros de la tienda > Rendimiento y desactiva la caché temporalmente.
Permisos incorrectos: Asegúrate de que la carpeta del módulo tenga permisos 755 y los archivos 644.
Nombre de carpeta incorrecto: La carpeta debe tener exactamente el nombre que espera el módulo (normalmente coincide con el nombre del archivo ZIP). Si lo renombras, no funcionará.
Versión incompatible: El módulo puede ser para una versión de PrestaShop diferente. Verifica los requisitos en la documentación del módulo.
Falta de dependencias: Algunos módulos requieren otros módulos o librerías. Lee la documentación.

4. ¿Puedo instalar un módulo desde cPanel sin usar el Administrador de archivos?

Sí, también puedes usar FTP (File Transfer Protocol) con un cliente como FileZilla. Los pasos son similares:

Conéctate a tu servidor FTP (los datos los encuentras en cPanel, sección "Cuentas FTP").
Navega a la carpeta modules de PrestaShop.
Arrastra la carpeta del módulo (ya extraída) desde tu PC.
Verifica permisos (755 para carpetas, 644 para archivos).
Luego instala desde el backoffice.

El método con Administrador de archivos es más visual y no requiere software adicional.

5. ¿Qué precauciones debo tomar antes de instalar un módulo manualmente?

Copia de seguridad: Siempre haz una copia de seguridad de tu base de datos y archivos. Desde cPanel puedes usar "Copias de seguridad" o "JetBackup".
Entorno de pruebas: Si es posible, prueba el módulo en un entorno de desarrollo o staging antes de instalarlo en producción.
Lee reseñas: Si el módulo es de pago, verifica que tenga buenas valoraciones y soporte activo.
Actualizaciones: Asegúrate de que el módulo sea compatible con tu versión de PrestaShop (1.6, 1.7, 8.x, etc.).

[WARNING] Algunos módulos pueden modificar archivos core de PrestaShop. Si luego los actualizas, esos cambios se perderán. Prefiere módulos que usen override o hooks.

6. ¿Cómo desinstalar un módulo instalado manualmente?

Si el módulo no te gusta o da problemas:

Desde el backoffice, ve a Módulos > Gestor de módulos y haz clic en Desinstalar (si está activo).
Luego, desde cPanel, elimina la carpeta del módulo en modules (Administrador de archivos o FTP).
Opcional: Si el módulo creó tablas en la base de datos, deberías eliminarlas manualmente (consulta la documentación). Algunos módulos tienen un botón de "Eliminar" que lo hace automáticamente.

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

Errores comunes y cómo solucionarlos:

Error 500: Generalmente por conflictos de PHP. Revisa los logs de error en cPanel (sección "Errores" o "Registros de errores"). Puede ser por incompatibilidad de versión de PHP.
Página en blanco: Activa el modo depuración de PrestaShop: en el archivo /config/defines.inc.php, cambia _PS_MODE_DEV_ a true. Así verás el error exacto.
El módulo no se activa: Puede faltar algún requisito (ejemplo: extensión PHP como curl o mbstring). Contacta a tu hosting para activarlas.
Problemas de CSS/JS: A veces los módulos no cargan sus recursos. Limpia la caché y fuerza la compilación desde el backoffice.

8. ¿Es seguro instalar módulos desde cPanel?

Sí, siempre que:

El módulo provenga de una fuente confiable (marketplace oficial, desarrollador conocido).
No modifiques archivos core sin saber lo que haces.
Mantengas tu PrestaShop y módulos actualizados.
Uses contraseñas seguras en cPanel y FTP.

cPanel es una herramienta segura por sí misma, pero el riesgo está en el contenido que subes.

9. ¿Qué alternativas hay a cPanel para instalar módulos?

Además de cPanel y FTP, puedes usar:

Syspanel (HestiaCP): Acceso por puerto 2106, interfaz similar pero más minimalista.
SSH (acceso por consola): Si tienes conocimientos avanzados, puedes descomprimir archivos con comandos como unzip modulo.zip.
Instalador automático de módulos: Algunos hosting ofrecen un instalador de módulos PrestaShop desde el panel (como Softaculous), pero no siempre incluye módulos de terceros.

10. ¿Puedo instalar un módulo desde cPanel si mi PrestaShop está en un subdominio?

Sí, el proceso es el mismo. Solo asegúrate de navegar a la carpeta correcta dentro del subdominio (ejemplo: public_html/subdominio). La estructura de carpetas es idéntica.

Consejos finales para una instalación exitosa

Siempre lee la documentación del módulo: Cada desarrollador puede tener instrucciones específicas.
Prueba en un entorno de desarrollo: Si tu hosting lo permite, crea una subcarpeta o subdominio para pruebas.
Actualiza tu PrestaShop: Las versiones antiguas pueden tener vulnerabilidades. Mantén tu tienda al día.
Usa un módulo de seguridad: Como "Security" de PrestaShop, que te alerta de cambios en archivos.

[TIP] Si tienes dudas, contacta al soporte de tu hosting. Muchos ofrecen ayuda gratuita para instalar módulos desde cPanel.

Conclusión

Instalar un módulo manualmente desde cPanel es una habilidad esencial para cualquier dueño de tienda PrestaShop. Aunque el backoffice es más cómodo, cuando falla, subir módulo PrestaShop manual a través del Administrador de archivos o FTP es la solución más fiable.

Recuerda siempre verificar la compatibilidad, hacer copias de seguridad y mantener permisos correctos. Con esta guía de FAQ PrestaShop cPanel, podrás resolver las dudas más comunes y realizar la instalación sin estrés.

Si te surge alguna otra pregunta, no dudes en consultar la documentación oficial de PrestaShop o preguntar en foros especializados. ¡Buena suerte con tu tienda online!