Instalar módulos PrestaShop desde cPanel fácilmente

¡Hola! Soy tu técnico de soporte amigable y hoy te voy a guiar paso a paso para que puedas instalar módulos en PrestaShop desde cPanel. Este proceso es súper útil cuando necesitas añadir funcionalidades a tu tienda online, pero no tienes acceso directo al backoffice de PrestaShop o el módulo no se instala correctamente desde allí. No te preocupes si no eres un experto en tecnología; lo explicaré de forma sencilla y clara.

Vamos a cubrir desde qué es un módulo, por qué instalarlo desde cPanel, hasta el método exacto para hacerlo. Al final, incluiré una sección de preguntas frecuentes (FAQ) para resolver las dudas más comunes. ¡Empecemos!

¿Qué es un módulo en PrestaShop y por qué instalarlo desde cPanel?

Un módulo en PrestaShop es como un "plugin" o extensión que añade funciones extra a tu tienda: desde mejorar el SEO, añadir métodos de pago (como PayPal), hasta personalizar el diseño. Normalmente se instalan desde el propio backoffice de PrestaShop, pero a veces surgen problemas: errores de permisos, límites de tamaño de archivo, o simplemente el módulo no aparece en el marketplace. Ahí es donde entra cPanel.

cPanel es un panel de control de hosting que te permite gestionar archivos, bases de datos y más. Instalar módulos desde aquí te da control total sobre los archivos del módulo, evitando limitaciones del servidor. Es especialmente útil si tu hosting tiene restricciones o si el módulo viene en un archivo ZIP que no se sube bien desde PrestaShop.

Requisitos previos: lo que necesitas antes de empezar

Antes de lanzarte, asegúrate de tener lo siguiente:

Acceso a cPanel: Recibirás un usuario y contraseña de tu proveedor de hosting. Normalmente accedes a través de tudominio.com/cpanel o tudominio.com:2083.
El módulo en formato ZIP: Debes tener el archivo del módulo (generalmente un .zip o .tar.gz) descargado en tu computadora. Si es de pago, asegúrate de tener la licencia.
Conocimiento básico de tu tienda: Saber la versión de PrestaShop que usas (puedes verlo en el backoffice, en "Información del servidor").
Herramientas: Un gestor de archivos como FileZilla (opcional) o el propio administrador de archivos de cPanel.

[WARNING] Siempre haz una copia de seguridad de tu tienda antes de instalar módulos. Un módulo incompatible puede romper la web. Ve a tu backoffice de PrestaShop -> Parámetros de la tienda -> Mantenimiento -> Exportar o usar un plugin de backup.

Paso 1: Acceder a cPanel y localizar el administrador de archivos

Primero, inicia sesión en cPanel. Escribe en tu navegador: tudominio.com/cpanel e ingresa tus credenciales. Una vez dentro, busca la sección Archivos y haz clic en Administrador de archivos (File Manager). Se abrirá una ventana con la estructura de carpetas de tu hosting.

[TIP] Si tu hosting usa Syspanel (antes conocido como HestiaCP), el acceso es diferente: entra por tudominio.com:2106 y luego busca la opción "Archivos" o "File Manager". Syspanel también tiene un administrador de archivos similar.

Paso 2: Navegar a la carpeta de módulos de PrestaShop

Dentro del Administrador de archivos, busca la carpeta raíz de tu tienda. Normalmente se llama public_html o www, pero puede variar según tu hosting. Si tu tienda está en un subdominio, busca la carpeta correspondiente (ej: public_html/tienda).

Una vez dentro, localiza la carpeta modules. La ruta típica es: public_html/modules. Esta carpeta contiene todas las carpetas de los módulos instalados. No la confundas con themes o img.

[INFO] Si no ves la carpeta modules, asegúrate de que estás en el directorio correcto. A veces los hostings crean una carpeta prestashop dentro de public_html. Revisa la estructura.

Paso 3: Subir el archivo ZIP del módulo

Ahora, vamos a subir el módulo. Hay dos formas: subir el ZIP directamente y descomprimirlo aquí, o subir la carpeta ya descomprimida. Te recomiendo la primera para evitar errores.

En el Administrador de archivos, haz clic en Subir (botón en la barra superior).
Se abrirá una ventana. Arrastra el archivo ZIP del módulo desde tu computadora o haz clic en "Seleccionar archivo" y búscalo.
Espera a que se complete la subida (verás una barra de progreso). Luego cierra la ventana de subida.

[WARNING] Asegúrate de que el archivo ZIP no esté dañado. Si el módulo pesa más de 50 MB, puede dar problemas. En ese caso, usa FTP (FileZilla) para subirlo.

Paso 4: Descomprimir el módulo en la carpeta correcta

Una vez subido el ZIP, lo verás en la lista de archivos dentro de la carpeta modules. Ahora:

Haz clic derecho sobre el archivo ZIP y selecciona Extraer (Extract).
Se abrirá un cuadro de diálogo. Asegúrate de que la ruta de destino sea la carpeta actual (modules). Haz clic en Extraer archivos.
El sistema descomprimirá el contenido. Verás una nueva carpeta con el nombre del módulo (ej: paypal, seo-module, etc.).

[TIP] Si el ZIP contiene varios archivos, asegúrate de que la carpeta principal tenga el nombre correcto. A veces los módulos vienen dentro de una carpeta extra. Si es así, mueve la carpeta interior a modules y elimina la vacía.

Paso 5: Verificar permisos de la carpeta del módulo

Los módulos necesitan permisos de lectura y escritura para funcionar. Por defecto, cPanel asigna permisos correctos, pero es bueno verificarlo:

Haz clic derecho sobre la carpeta del módulo recién creada y selecciona Permisos (Permissions).
Asegúrate de que esté en 755 (lectura y ejecución para todos, escritura solo para el propietario). Si ves un número diferente, cámbialo a 755.
Haz clic en Cambiar permisos.

[INFO] Si usas Syspanel (HestiaCP), los permisos se gestionan de forma similar. Busca la opción "Permisos" en el menú contextual.

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

Ahora que el módulo está físicamente en tu servidor, toca activarlo desde PrestaShop.

Ve al backoffice de tu tienda: tudominio.com/adminXXXXXX (donde XXXXXX es el código de tu admin).
En el menú izquierdo, ve a Módulos -> Gestor de módulos.
En la parte superior, haz clic en Subir un módulo (si no lo ves, busca en la lista de módulos disponibles).
Si el módulo aparece en la lista (porque ya está en la carpeta), haz clic en Instalar al lado de su nombre.
Sigue las instrucciones: acepta términos, configura opciones básicas (si las hay) y listo.

[TIP] Si el módulo no aparece en la lista, prueba a refrescar la página o ve a Módulos -> Catálogo de módulos y busca manualmente. A veces tarda unos segundos en detectarse.

Paso 7: Probar y configurar el módulo

Una vez instalado, es hora de probarlo:

Ve a la configuración del módulo (suele tener un enlace "Configurar" en la lista de módulos).
Ajusta las opciones según tus necesidades (por ejemplo, para un módulo de SEO, pon las meta etiquetas).
Visita tu tienda en el frontend para verificar que funciona correctamente (ej: que aparezca el botón de pago o el slider).
Si ves errores, revisa los logs de PrestaShop en Parámetros avanzados -> Registros.

[WARNING] Si el módulo no funciona, puede ser por incompatibilidad de versiones. Verifica que el módulo sea compatible con tu versión de PrestaShop (1.6, 1.7 o 8.x). En ese caso, contacta al desarrollador.

Preguntas frecuentes (FAQ) sobre instalar módulos PrestaShop desde cPanel

Aquí respondo las dudas más comunes que mis clientes suelen tener:

¿Puedo instalar cualquier módulo desde cPanel?

Sí, siempre que el módulo esté en formato ZIP y sea compatible con tu versión de PrestaShop. Los módulos gratuitos y de pago funcionan igual. Eso sí, algunos módulos premium requieren una licencia que se activa desde el backoffice.

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

Primero, verifica que la carpeta del módulo esté dentro de modules y tenga el nombre correcto (sin espacios ni caracteres extraños). Luego, limpia la caché de PrestaShop: ve a Parámetros avanzados -> Rendimiento -> Limpiar caché. Si sigue sin aparecer, revisa los permisos de la carpeta (deben ser 755).

¿Es seguro instalar módulos desde cPanel?

Sí, siempre que descargues el módulo de fuentes confiables (como el marketplace oficial de PrestaShop o desarrolladores reputados). Evita módulos piratas, ya que pueden contener malware. Además, al hacerlo desde cPanel, evitas riesgos de subida por el backoffice.

¿Necesito conocimientos técnicos para esto?

No, solo seguir los pasos que te he dado. Si te sientes inseguro, puedes pedir ayuda a tu hosting o a un desarrollador. Pero con esta guía, cualquier persona puede hacerlo.

¿Qué pasa si uso Syspanel (HestiaCP) en lugar de cPanel?

No hay problema. El proceso es similar: accedes por tudominio.com:2106, buscas el administrador de archivos, navegas a public_html/modules, subes y descomprimes el ZIP. La única diferencia es la interfaz, pero los pasos son los mismos.

¿Puedo instalar varios módulos a la vez?

Sí, puedes subir varios archivos ZIP y descomprimirlos uno por uno. Solo asegúrate de no mezclar nombres de carpetas, ya que podrían sobrescribirse.

¿Qué hago si el módulo da error "No se puede escribir en el directorio"?

Esto es por permisos. Vuelve al paso 5 y asegúrate de que la carpeta del módulo tenga permisos 755. Si el error persiste, cambia temporalmente a 777 (solo para instalar) y luego vuelve a 755. No dejes permisos 777 por seguridad.

¿Cómo desinstalo un módulo instalado desde cPanel?

Desde el backoffice: ve a Módulos -> Gestor de módulos, busca el módulo y haz clic en Desinstalar. Luego, desde cPanel, elimina la carpeta del módulo en modules para liberar espacio.

Consejos finales para una instalación exitosa

Actualiza PrestaShop: Antes de instalar módulos, asegúrate de tener la última versión de tu tienda. Las versiones antiguas pueden no ser compatibles.
Usa un entorno de pruebas: Si es posible, prueba el módulo en un subdominio o copia de tu tienda antes de ponerlo en producción.
Documentación del módulo: Lee el manual del módulo (suele venir en el ZIP). Muchos tienen instrucciones específicas.
Soporte: Si te atascas, contacta al desarrollador del módulo o a tu hosting. Yo también estoy aquí para ayudarte.

[INFO] Recuerda que instalar módulos PrestaShop desde cPanel te da más control y es una solución rápida cuando el backoffice falla. Es una habilidad útil para cualquier dueño de tienda online.

Espero que esta guía te haya sido de gran ayuda. Ahora ya sabes cómo añadir cualquier funcionalidad a tu PrestaShop sin depender de terceros. Si tienes más dudas, no dudes en preguntar. ¡Buena suerte con tu tienda!