Gestión de módulos PrestaShop en cPanel para principiantes

Introducción: ¿Por qué gestionar módulos desde cPanel?

Si tienes una tienda en PrestaShop, los módulos son como piezas de Lego que añaden funciones: un carrito más rápido, un sistema de reseñas, integración con pasarelas de pago, etc. Pero a veces, instalar o gestionar estos módulos desde el panel de administración de PrestaShop puede fallar por límites de servidor, permisos o conflictos de archivos. Ahí es donde entra cPanel, el panel de control de tu hosting. Desde cPanel puedes acceder directamente a los archivos de tu tienda, subir módulos manualmente y solucionar problemas que desde el backoffice de PrestaShop no podrías resolver.

En este artículo te voy a guiar paso a paso para que aprendas a añadir y gestionar módulos en PrestaShop desde cPanel, desde la descarga hasta la activación. Incluiré trucos, alertas y consejos para que no te pierdas. Al final, también responderé preguntas frecuentes.

¿Qué necesitas antes de empezar?

Antes de meterte en cPanel, asegúrate de tener:

Acceso a cPanel: Lo proporciona tu hosting. Normalmente se accede desde tudominio.com/cpanel o tudominio.com:2083.
Credenciales de FTP o del administrador de archivos de cPanel: Las mismas que usas para acceder a tu hosting.
Archivo del módulo: Normalmente en formato .zip o .tar.gz. Lo obtienes desde el marketplace de PrestaShop, el desarrollador o un proveedor de confianza.
Conocimiento básico de la estructura de PrestaShop: No necesitas ser experto, pero debes saber que los módulos se almacenan en la carpeta /modules dentro de la raíz de tu tienda.

[WARNING] No descargues módulos de sitios piratas o gratuitos dudosos. Pueden contener malware que comprometa tu tienda y los datos de tus clientes.

Paso 1: Acceder a cPanel y al administrador de archivos

El primer paso es entrar a cPanel. Aquí te explico cómo hacerlo:

Abre tu navegador y escribe tudominio.com/cpanel o tudominio.com:2083.
Ingresa tu usuario y contraseña de cPanel (te los dio tu proveedor de hosting).
Una vez dentro, busca la sección Archivos y haz clic en Administrador de archivos (File Manager).

[TIP] Si tu hosting usa Syspanel (antes conocido como HestiaCP), el acceso es diferente: ingresa a tudominio.com:2106 con tus credenciales de Syspanel. Luego busca la opción de "Administrador de archivos" o "File Manager".

Paso 2: Localizar la carpeta de módulos de PrestaShop

Dentro del administrador de archivos, verás una estructura de carpetas. La ruta típica de PrestaShop es:

public_html/
├── ...
├── modules/
├── themes/
├── img/
└── ...

La carpeta modules es donde se almacenan todos los módulos instalados. Si no la ves, puede estar en una subcarpeta (por ejemplo, si tienes varias tiendas). Busca la raíz de tu tienda (normalmente public_html o www).

[INFO] Si tu tienda está en un subdirectorio (ej: tudominio.com/tienda), la ruta sería public_html/tienda/modules.

Paso 3: Subir el módulo manualmente

Ahora subiremos el archivo del módulo. Sigue estos pasos:

En el administrador de archivos, navega hasta la carpeta modules.
Haz clic en Subir (normalmente un botón en la barra superior).
Selecciona el archivo .zip del módulo desde tu computadora.
Espera a que termine la subida (verás una barra de progreso).
Una vez subido, verás el archivo .zip dentro de la carpeta modules.

[WARNING] No subas el módulo directamente en public_html o en otra carpeta que no sea modules. Si lo haces, PrestaShop no lo reconocerá.

Paso 4: Descomprimir el módulo

El archivo .zip debe descomprimirse para que PrestaShop pueda usarlo. Así se hace:

Haz clic derecho sobre el archivo .zip que subiste.
Selecciona Extraer (Extract).
Se abrirá una ventana. Asegúrate de que la ruta de destino sea la misma carpeta modules.
Haz clic en Extraer archivos.
Verás que aparece una nueva carpeta con el nombre del módulo (ej: micodigo-modulo).

[TIP] Si el módulo viene en formato .tar.gz, el proceso es el mismo: sube el archivo y luego selecciona "Extraer". El administrador de archivos de cPanel reconoce ambos formatos.

Paso 5: Verificar la estructura del módulo

Dentro de la carpeta del módulo recién creada, debe haber al menos estos archivos:

micodigo-modulo.php (archivo principal del módulo).
logo.png (opcional, pero común).
config.xml (opcional, información del módulo).
Subcarpetas como views, controllers, translations, etc.

Si ves solo un archivo .zip dentro de la carpeta, significa que no se descomprimió correctamente. Vuelve al paso 4.

[INFO] Si la carpeta del módulo tiene un nombre extraño (ej: micodigo-modulo-1.0.0), no te preocupes. PrestaShop lo reconocerá igual.

Paso 6: Activar el módulo desde el backoffice de PrestaShop

Ahora que el módulo está en la carpeta correcta, debes activarlo desde el panel de administración de PrestaShop:

Ve a tu backoffice: tudominio.com/adminXXXXXX (donde XXXXXX es el código de seguridad).
En el menú izquierdo, haz clic en Módulos → Módulos y servicios.
En la barra de búsqueda, escribe el nombre del módulo que subiste.
Debería aparecer en la lista. Haz clic en Instalar (o Activar si ya aparece instalado).
Sigue las instrucciones de configuración si las hay.

Si no aparece, puede que el módulo tenga errores o no sea compatible con tu versión de PrestaShop. Revisa los requisitos del módulo.

[WARNING] Si el módulo no aparece después de subirlo, verifica que la carpeta del módulo tenga permisos 755 (lectura y ejecución) y los archivos 644. Puedes cambiarlos desde cPanel: haz clic derecho sobre la carpeta → Permisos.

Paso 7: Solucionar problemas comunes

A veces, los módulos no se instalan correctamente. Aquí tienes soluciones rápidas:

El módulo no aparece en el backoffice

Causa: El archivo principal del módulo no tiene el nombre correcto. Debe ser nombre_del_modulo.php (exactamente igual al nombre de la carpeta).
Solución: Renombra el archivo desde cPanel. Por ejemplo, si la carpeta es micodigo-modulo, el archivo debe ser micodigo-modulo.php.

Error de permisos

Causa: La carpeta del módulo o sus archivos tienen permisos incorrectos.
Solución: Cambia los permisos a 755 para carpetas y 644 para archivos.

Conflicto con otros módulos

Causa: Dos módulos usan el mismo hook o función.
Solución: Desactiva temporalmente otros módulos desde el backoffice y prueba de nuevo.

[TIP] Si tienes muchos módulos, usa la opción "Módulos" → "Catálogo de módulos" en el backoffice para buscar actualizaciones o conflictos.

Cómo gestionar módulos desde cPanel: actualizaciones y eliminación

Además de instalar, desde cPanel puedes:

Actualizar un módulo manualmente

Descarga la nueva versión del módulo.
Sube el archivo .zip a la carpeta modules (sobrescribe la carpeta antigua).
Descomprime y confirma que quieres reemplazar los archivos.
Ve al backoffice y busca el módulo. Si aparece como "Actualizar", haz clic.

Eliminar un módulo por completo

En el administrador de archivos, navega a modules.
Busca la carpeta del módulo que quieres eliminar.
Haz clic derecho → Eliminar.
Confirma la eliminación.
En el backoffice, ve a Módulos → Módulos y servicios y si aún aparece, desinstálalo primero.

[WARNING] Eliminar una carpeta de módulo desde cPanel no lo desinstala automáticamente. Primero desinstálalo desde el backoffice para evitar errores en la base de datos.

Preguntas frecuentes (FAQ)

¿Puedo instalar módulos desde cPanel si mi hosting usa Syspanel?

Sí, el proceso es similar. Accede a Syspanel en tudominio.com:2106, busca el administrador de archivos y sigue los mismos pasos. La ruta de los módulos sigue siendo public_html/modules.

¿Qué hago si el módulo no se descomprime correctamente?

Prueba a subir el archivo nuevamente. Si el problema persiste, el archivo puede estar corrupto. Descarga una copia fresca desde la fuente original.

¿Es seguro subir módulos manualmente?

Sí, siempre que el módulo provenga de una fuente confiable (marketplace oficial de PrestaShop, desarrollador reputado). Evita módulos de sitios desconocidos.

¿Necesito conocimientos de programación?

No, solo seguir los pasos de este artículo. Pero si el módulo requiere configuración avanzada (como modificar archivos de tema), sí necesitarás algo de conocimiento técnico.

¿Puedo instalar módulos gratuitos de la misma forma?

Sí, el proceso es idéntico para módulos gratuitos y de pago. Solo asegúrate de tener los derechos de uso.

Conclusión

Añadir y gestionar módulos PrestaShop cPanel es una habilidad clave para cualquier dueño de tienda online. Te permite resolver problemas cuando el backoffice falla, instalar módulos manualmente y mantener tu tienda actualizada. Recuerda siempre hacer copias de seguridad antes de tocar archivos, y si usas Syspanel, el puerto de acceso es el 2106.

Con esta guía, ya puedes manejar módulos como un experto. Si te surge alguna duda, revisa la sección de FAQ o consulta con tu proveedor de hosting. ¡Buena suerte con tu tienda!