Módulos PrestaShop en cPanel | Dudas y soluciones

Introducción: ¿Por qué surgen dudas con los módulos de PrestaShop en cPanel?

Si tienes una tienda online con PrestaShop y utilizas cPanel como panel de control de tu hosting, es muy probable que hayas tenido alguna duda sobre la instalación, actualización o configuración de módulos. Los módulos son el corazón de tu tienda: añaden funcionalidades como pasarelas de pago, envíos, SEO o integraciones con redes sociales. Sin embargo, al gestionarlos desde cPanel, pueden surgir preguntas técnicas que, sin una guía clara, parecen un laberinto.

En este artículo, resolveremos las dudas más comunes sobre módulos de PrestaShop en cPanel. Explicaremos paso a paso cómo instalarlos, solucionar errores típicos, gestionar permisos y evitar problemas de rendimiento. Todo con un lenguaje sencillo, sin tecnicismos innecesarios, pensado para que cualquier persona, aunque no sea experta en hosting, pueda seguir las instrucciones.

[INFO] Si usas Syspanel (antes conocido como HestiaCP), recuerda que el puerto de acceso es el 2106. Aunque el artículo se centra en cPanel, muchos conceptos son similares.

## 1. Dudas frecuentes sobre la instalación de módulos en PrestaShop desde cPanel

### 1.1. ¿Cómo subir un módulo manualmente a través de cPanel?

Una de las preguntas más habituales es: "He descargado un módulo en ZIP, ¿cómo lo instalo sin usar el backoffice de PrestaShop?" La respuesta es sencilla: a veces el backoffice falla por límites de tamaño de archivo o restricciones del servidor. En esos casos, cPanel es tu aliado.

Pasos para instalar un módulo manualmente:

Accede a cPanel: usa tu usuario y contraseña de hosting. Normalmente la URL es tudominio.com/cpanel o tudominio.com:2083.
Busca el gestor de archivos (File Manager): suele estar en la sección "Archivos".
Navega hasta la carpeta de módulos de PrestaShop: la ruta típica es public_html/modules/. Si tu tienda está en una subcarpeta, ajusta la ruta (ej: public_html/tienda/modules/).
Sube el archivo ZIP: arrastra el archivo desde tu ordenador o usa la opción "Subir". No lo descomprimas aún.
Extrae el contenido: selecciona el ZIP y haz clic en "Extraer". El sistema creará automáticamente una carpeta con el nombre del módulo.
Verifica permisos: asegúrate de que la carpeta del módulo tenga permisos 755 y los archivos 644. Si no, cámbialos desde las propiedades del archivo.
Finaliza en el backoffice: ve a tu administración de PrestaShop, módulos y busca el nuevo módulo. Haz clic en "Instalar".

[TIP] Si el módulo no aparece, refresca la página del backoffice con Ctrl+F5. A veces la caché del navegador lo oculta.

### 1.2. ¿Por qué no puedo instalar un módulo desde el backoffice?

Es frustrante cuando arrastras el ZIP y te sale un error como "El archivo es demasiado grande" o "No se puede cargar el módulo". Esto suele deberse a:

Límite de subida de PHP: en cPanel puedes aumentarlo desde "Seleccionar versión de PHP" (o "MultiPHP Manager") y luego en "Opciones de PHP". Busca upload_max_filesize y post_max_size y cámbialos a 64M o más.
Falta de permisos en la carpeta modules: comprueba que tenga permisos 755. Si está en 750 o 644, el sistema no puede escribir.
Módulo incompatible: algunos módulos requieren versiones específicas de PrestaShop. Verifica en la ficha del módulo.

[WARNING] No subas módulos piratas o de fuentes no confiables. Pueden contener malware que comprometa tu tienda.

## 2. Errores comunes después de instalar un módulo

### 2.1. "El módulo no se muestra en el listado"

Este es otro clásico. Has seguido todos los pasos, pero en el backoffice no aparece. Las causas pueden ser:

El módulo no está en la carpeta correcta: revisa que el nombre de la carpeta coincida exactamente con el nombre del módulo (sin espacios ni mayúsculas extrañas). Por ejemplo, si el módulo se llama "micromercado", la carpeta debe ser micromercado.
Falta el archivo index.php: algunos módulos necesitan un archivo index.php dentro de su carpeta para ser detectados. Si no está, puedes crear uno vacío o copiarlo de otro módulo.
Caché de PrestaShop: ve a "Parámetros avanzados > Rendimiento" y limpia la caché. También puedes forzar la regeneración de archivos.

### 2.2. Error 500 o página en blanco al activar un módulo

Un error 500 suele indicar un conflicto de código o de permisos. Soluciones:

Desactiva el modo debug: en el archivo config/defines.inc.php, cambia _PS_MODE_DEV_ a false. Esto mostrará el error real.
Revisa los logs de error: en cPanel, ve a "Errores" o "Error Log" y busca la línea que menciona el módulo.
Aumenta la memoria PHP: desde las opciones de PHP en cPanel, sube memory_limit a 256M o 512M.
Verifica la compatibilidad: el módulo puede necesitar PHP 7.4 o 8.0. Cambia la versión desde el selector de PHP en cPanel.

[INFO] Si usas Syspanel, el proceso es similar: busca "PHP Settings" y ajusta los valores. Recuerda que el puerto de acceso es 2106.

## 3. Dudas sobre actualización de módulos

### 3.1. ¿Cómo actualizar un módulo sin perder configuraciones?

Actualizar un módulo puede ser aterrador si has personalizado sus ajustes. La regla de oro: siempre haz una copia de seguridad antes. En cPanel, usa "Backup" para descargar toda la carpeta modules y la base de datos.

Pasos seguros:

Desactiva el módulo en el backoffice (no lo desinstales, solo desactívalo).
Descarga la nueva versión del módulo desde la fuente oficial.
Sobrescribe la carpeta antigua: en File Manager, sube el nuevo ZIP y extrae sobre la carpeta existente. Elige "Sobrescribir archivos".
Reactiva el módulo y verifica que los ajustes se conservan.

Si algo sale mal, restaura la copia de seguridad.

### 3.2. ¿Por qué una actualización rompe mi tienda?

Esto puede pasar si el desarrollador cambió funciones clave o si tu PrestaShop no es compatible. Para evitarlo:

Lee las notas de actualización: suelen indicar cambios importantes.
Prueba en un entorno de staging: muchos hostings con cPanel ofrecen "Staging" para clonar tu tienda y probar.
Revisa los logs de error: como mencionamos antes.

## 4. Gestión de permisos y seguridad de módulos

### 4.1. ¿Qué permisos deben tener las carpetas y archivos de módulos?

La seguridad es crítica. Permisos incorrectos pueden dejar tu tienda vulnerable. La regla estándar:

Carpetas: 755 (lectura y ejecución para todos, escritura solo para el usuario).
Archivos: 644 (lectura para todos, escritura solo para el usuario).
Archivos de configuración (como config.xml): 644.

Para cambiarlos en cPanel: selecciona el archivo o carpeta, haz clic en "Permisos" y ajusta los valores.

[WARNING] Nunca pongas permisos 777 en carpetas de módulos. Aunque parezca más fácil, cualquiera podría modificar tus archivos.

### 4.2. ¿Cómo saber si un módulo tiene malware?

Especialmente si descargas módulos gratuitos de sitios no oficiales, pueden incluir código malicioso. Señales de alerta:

Conexiones a IPs desconocidas: revisa el código del módulo (en File Manager, abre los archivos PHP y busca URLs extrañas).
Archivos ocultos: algunos módulos crean archivos como shell.php o backdoor.php.
Rendimiento lento: un módulo malicioso puede consumir muchos recursos.

Puedes usar herramientas como "PrestaShop Security Scanner" o simplemente eliminar módulos sospechosos.

## 5. Preguntas sobre módulos y rendimiento

### 5.1. ¿Demasiados módulos ralentizan mi tienda?

Sí, especialmente si están mal programados. Cada módulo añade consultas a la base de datos, archivos JavaScript y CSS. Consejos:

Desactiva módulos que no uses: no los elimines, solo desactívalos. Así evitas conflictos.
Usa un módulo de caché: como "PrestaShop Cache" o "Nginx Cache" (si tu hosting lo permite).
Revisa el consumo de recursos: en cPanel, ve a "Estadísticas" o "Resource Usage" para ver qué módulos consumen más CPU.

### 5.2. ¿Cómo optimizar módulos pesados?

Si un módulo es indispensable pero lento, puedes:

Combinar y comprimir archivos: en PrestaShop, ve a "Parámetros avanzados > Rendimiento" y activa "Combinar archivos CSS" y "Comprimir JavaScript".
Usar CDN: muchos módulos de terceros se integran con CDN para servir archivos estáticos.
Actualizar a la última versión: los desarrolladores suelen optimizar el rendimiento.

## 6. Dudas sobre módulos de pago y pasarelas

### 6.1. ¿Cómo configurar un módulo de pago desde cPanel?

Los módulos de pago (como PayPal, Stripe o Redsys) requieren a veces archivos de configuración adicionales. Por ejemplo, algunos necesitan un certificado SSL o un archivo de log. En cPanel:

Sube los archivos de configuración a la carpeta del módulo (ej: modules/paypal/).
Instala el certificado SSL desde "SSL/TLS" en cPanel.
Configura las claves API desde el backoffice del módulo.

[TIP] Si el módulo pide una URL de retorno, usa la URL completa de tu tienda con HTTPS.

### 6.2. ¿Por qué el módulo de pago no funciona en producción?

Suele ser por:

SSL mal configurado: verifica que tu dominio tenga un certificado válido.
Firewall bloqueando conexiones: algunos hostings bloquean puertos de pago. Contacta con tu proveedor.
Modo de pruebas activado: asegúrate de haber cambiado de "sandbox" a "producción".

## 7. Conclusión: Resuelve tus dudas con calma

Los módulos de PrestaShop en cPanel pueden parecer complejos, pero con paciencia y siguiendo estos pasos, la mayoría de dudas se resuelven. Recuerda:

Siempre haz copias de seguridad antes de instalar o actualizar.
Usa cPanel para solucionar errores de permisos, límites de PHP y subidas manuales.
Mantén los módulos actualizados para evitar vulnerabilidades.
Si usas Syspanel, el puerto 2106 es tu acceso, y los conceptos son similares.

Si después de todo esto aún tienes dudas, no dudes en contactar con el soporte de tu hosting. ¡Tu tienda online merece funcionar sin problemas!

[INFO] Este artículo es una guía general. Siempre consulta la documentación oficial de PrestaShop y de tu módulo específico para casos particulares.