PrestaShop: Guía para instalar módulos desde cPanel

¿Te ha tocado administrar una tienda online con PrestaShop y necesitas instalar nuevos módulos para añadir funcionalidades? Es una tarea muy habitual, pero a veces puede parecer compleja si no tienes experiencia técnica. No te preocupes, en esta guía te voy a explicar paso a paso cómo realizar la instalación de módulos en PrestaShop desde el panel de control de tu hosting, cPanel. Este proceso es una de las tareas más comunes para un SysAdmin o para cualquier persona que gestione su propia tienda.

Vamos a cubrir desde qué son los módulos, por qué instalarlos desde cPanel, hasta los métodos más seguros y eficaces para hacerlo. Al final, tendrás claro cómo añadir cualquier extensión a tu PrestaShop sin miedo a romper nada.

¿Qué son los módulos en PrestaShop y por qué instalarlos desde cPanel?

Antes de meternos en faena, aclaremos conceptos. Los módulos en PrestaShop son como aplicaciones o plugins que añaden funcionalidades específicas a tu tienda. Pueden ser desde pasarelas de pago (PayPal, Stripe), sistemas de envío, herramientas de SEO, hasta constructores de páginas visuales.

Normalmente, la forma más sencilla de instalar un módulo es desde el propio panel de administración de PrestaShop, subiendo el archivo .zip. Sin embargo, hay situaciones donde este método falla:

• Límites de tamaño de archivo: El servidor tiene un límite para subir archivos por PHP. Si el módulo es muy pesado (por ejemplo, un tema completo), puede que no puedas subirlo desde el backend.
• Permisos de archivos: A veces, la carpeta de módulos de PrestaShop no tiene los permisos correctos para que el instalador web funcione.
• Errores de memoria: La instalación desde el panel puede agotar la memoria PHP disponible.

Aquí es donde entra cPanel. Al instalar el módulo directamente desde el panel de control de tu hosting, tienes control total sobre los archivos del servidor, evitando las limitaciones de PHP. Es la opción preferida por los SysAdmin para garantizar una instalación limpia y sin errores.

[INFO] Si tu hosting usa Syspanel (anteriormente conocido como HestiaCP), recuerda que el puerto de acceso es el 2106 (ejemplo: tudominio.com:2106). El proceso es muy similar al de cPanel, pero la interfaz cambia ligeramente.

Requisitos previos antes de instalar módulos

Para que todo salga bien, necesitas tener a mano lo siguiente:

1. Acceso a cPanel: Tus credenciales de usuario y contraseña del panel de control de tu hosting.
2. El archivo del módulo: El archivo comprimido .zip o .tar.gz del módulo que quieres instalar. Normalmente lo descargas desde la tienda de PrestaShop o desde el sitio del desarrollador.
3. Un cliente FTP (opcional pero recomendado): Aunque lo haremos desde cPanel, tener FileZilla o similar te puede sacar de apuros. No es obligatorio para este método.
4. Acceso al administrador de PrestaShop: Necesitarás entrar al backend de tu tienda para activar el módulo una vez instalado.

[WARNING] Siempre haz una copia de seguridad de tu tienda antes de instalar cualquier módulo. Puedes hacerlo desde cPanel (con la herramienta de Backup) o desde el propio PrestaShop. Un módulo incompatible puede dejar tu tienda inaccesible.

Método 1: Instalación de módulos usando el Administrador de Archivos de cPanel

Este es el método más directo y visual. No necesitas programas externos, solo tu navegador.

Paso 1: Accede a tu cPanel y busca el Administrador de Archivos

Inicia sesión en tu cPanel. La URL suele ser tudominio.com/cpanel o tudominio.com:2083. Una vez dentro, busca la sección Archivos y haz clic en Administrador de Archivos.

Paso 2: Navega hasta la carpeta de módulos de PrestaShop

Se abrirá una ventana con la estructura de archivos de tu sitio. Busca la carpeta donde tienes instalado PrestaShop. Normalmente es public_html (o www). Dentro de ella, localiza la carpeta modules. Esta es la carpeta donde viven todos los módulos de tu tienda.

Paso 3: Sube el archivo comprimido del módulo

En la barra de herramientas del Administrador de Archivos, haz clic en el botón Subir. Se abrirá una ventana. Selecciona el archivo .zip del módulo que descargaste. Asegúrate de que se suba a la carpeta modules que acabas de abrir. Espera a que la barra de progreso llegue al 100%.

Paso 4: Extrae el contenido del archivo

Una vez subido, el archivo .zip aparecerá en la lista de archivos dentro de la carpeta modules. Haz clic derecho sobre él y selecciona Extraer. Se te preguntará dónde extraerlo. Asegúrate de que la ruta sea la carpeta modules (ej: /home/tuusuario/public_html/modules). Haz clic en Extraer archivos.

Paso 5: Verifica que la carpeta del módulo se haya creado correctamente

Después de la extracción, deberías ver una nueva carpeta con el nombre del módulo (ej: micodigomodulo). Dentro de ella, deben estar todos los archivos del módulo, incluyendo el archivo principal micodigomodulo.php.

Paso 6: Instala y activa el módulo desde el backend de PrestaShop

Ahora ve al panel de administración de tu PrestaShop. Ve a Módulos -> Gestor de Módulos. En la lista de módulos, busca el que acabas de subir. Si todo ha ido bien, debería aparecer. Haz clic en el botón Instalar y luego en Configurar para ajustarlo a tu gusto.

[TIP] Si el módulo no aparece, puede que la carpeta tenga permisos incorrectos. En el Administrador de Archivos, haz clic derecho sobre la carpeta del módulo, selecciona Cambiar permisos y pon 755 (o 0755). Aplica a subcarpetas también.

Método 2: Instalación de módulos usando FTP (con cPanel como apoyo)

Este método es igual de válido y muchos SysAdmin lo prefieren porque es muy rápido. Usaremos un cliente FTP (como FileZilla) y las credenciales que nos da cPanel.

Paso 1: Obtén tus credenciales FTP desde cPanel

En cPanel, busca la sección Archivos y haz clic en Cuentas FTP. Ahí verás tu usuario FTP (suele ser tu usuario de cPanel seguido de @tudominio.com) y podrás gestionar la contraseña. Si no la recuerdas, puedes crear una nueva.

Paso 2: Conéctate a tu servidor con FileZilla

Abre FileZilla (o el cliente que uses). Introduce los datos:

• Servidor: tudominio.com (o la IP de tu servidor).
• Nombre de usuario: El que obtuviste en el paso anterior.
• Contraseña: La que configuraste.
• Puerto: 21 (por defecto).

Haz clic en Conexión rápida.

Paso 3: Navega hasta la carpeta modules

En el panel derecho (servidor remoto), busca la carpeta public_html y dentro, la carpeta modules. En el panel izquierdo (tu ordenador), busca el archivo .zip del módulo que descargaste.

Paso 4: Sube y descomprime el módulo

Arrastra el archivo .zip desde la izquierda a la carpeta modules de la derecha. Espera a que termine la transferencia.

Ahora, en lugar de descomprimir con FTP (que no se puede), vuelve a cPanel y usa el Administrador de Archivos (como en el Método 1, Paso 4) para extraer el archivo .zip que acabas de subir por FTP. Una vez extraído, puedes borrar el archivo .zip del servidor para mantenerlo limpio.

Paso 5: Activa el módulo en PrestaShop

Igual que en el método anterior, ve al backend de PrestaShop, busca el módulo en el gestor y actívalo.

Solución de problemas comunes al instalar módulos

A veces, incluso siguiendo los pasos al pie de la letra, pueden surgir problemas. Aquí tienes los más comunes y cómo solucionarlos.

El módulo no aparece en el gestor de módulos

• Causa más común: La carpeta del módulo no está en la ruta correcta o tiene un nombre incorrecto.
• Solución: Verifica que la carpeta esté dentro de /public_html/modules/ y que el nombre coincida exactamente con el que espera PrestaShop (normalmente el nombre de la carpeta es el mismo que el del archivo .php principal).

Error de "permiso denegado" al extraer o al instalar

• Causa: Los archivos o carpetas de PrestaShop tienen permisos demasiado restrictivos.
• Solución: Desde cPanel (Administrador de Archivos), ve a la carpeta modules, selecciona la carpeta de tu módulo y cambia los permisos a 755 para las carpetas y 644 para los archivos. A veces, dar permisos 777 temporalmente durante la instalación puede ayudar, pero luego debes devolverlos a 755.

El módulo da un error "500 Internal Server Error" después de instalarlo

• Causa: El módulo es incompatible con tu versión de PHP o de PrestaShop.
• Solución: Revisa los requisitos del módulo en la página del desarrollador. Puede que necesites cambiar la versión de PHP de tu sitio desde cPanel (en la sección Software -> Seleccionar versión de PHP). Si no es compatible, desinstala el módulo y busca una alternativa.

Tras la instalación, la tienda se vuelve lenta o da errores

• Causa: El módulo puede tener conflictos con otros módulos o con el tema.
• Solución: Desactiva el módulo desde el backend. Si no puedes acceder, desde cPanel, renombra la carpeta del módulo (por ejemplo, de mimodulo a mimodulo_desactivado). Esto lo desactivará a la fuerza. Luego, contacta al desarrollador del módulo para reportar el problema.

FAQ: Preguntas frecuentes sobre la instalación de módulos

Aquí respondemos las dudas más habituales que recibimos como técnicos de soporte.

¿Puedo instalar cualquier módulo desde cPanel?

Sí, siempre que el módulo esté diseñado para tu versión de PrestaShop (1.6, 1.7, 8.x, etc.). El método de cPanel solo se encarga de colocar los archivos en el lugar correcto.

¿Es más seguro instalar módulos desde cPanel que desde el backend?

No necesariamente más seguro, pero sí más fiable. Al evitar las limitaciones de PHP (tiempo de ejecución, tamaño de subida), reduces la probabilidad de errores durante la instalación. La seguridad depende del módulo en sí.

¿Qué hago si no tengo acceso a cPanel?

Si tu hosting no tiene cPanel, suele tener otro panel como Plesk o Syspanel (puerto 2106). El proceso es conceptualmente el mismo: accedes al administrador de archivos, buscas la carpeta modules de PrestaShop y subes/descomprimes el módulo. Si no tienes acceso a ningún panel, necesitarás usar FTP.

¿Puedo instalar un módulo pago desde cPanel?

Sí, exactamente igual. Solo asegúrate de que el archivo .zip que descargaste del sitio del desarrollador sea el correcto para la versión de tu PrestaShop.

Después de instalar el módulo, la tienda se queda en blanco (pantalla blanca). ¿Qué hago?

Esto es un Error 500 o un error PHP fatal. La solución de emergencia es: accede a cPanel -> Administrador de Archivos, ve a la carpeta modules, localiza la carpeta del módulo que acabas de instalar y renómbrala (ponle un guion al final, ej: mimodulo-bak). Esto desactivará el módulo al instante y tu tienda volverá a funcionar. Luego, investiga por qué fallaba.

[WARNING] No borres la carpeta de inmediato. Primero renómbrala para desactivar el módulo. Si la borras, perderás cualquier configuración que hubieras hecho si es que llegó a instalarse parcialmente.

Conclusión: Tú puedes con esto

Instalar módulos en PrestaShop desde cPanel es una habilidad básica que todo SysAdmin o propietario de una tienda online debería dominar. Te da control total sobre el proceso y te permite solucionar problemas que de otra forma te obligarían a llamar al soporte técnico.

Recuerda siempre los dos mandamientos del administrador de sistemas: haz copias de seguridad y verifica la compatibilidad del módulo. Siguiendo los pasos de esta guía, podrás añadir cualquier funcionalidad a tu tienda sin miedo. ¡Manos a la obra!