Instalar módulos PrestaShop manualmente en cPanel - Paso a paso

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

Si tienes una tienda online con PrestaShop, sabes que los módulos son esenciales para añadir funcionalidades, mejorar el diseño o potenciar el SEO. Aunque el panel de administración de PrestaShop permite instalar módulos directamente desde el marketplace oficial o mediante un archivo ZIP, a veces surgen problemas: errores de permisos, límites de tamaño de subida, incompatibilidades de versiones o simplemente necesitas un control más granular.

Aquí es donde entra la instalación manual a través de cPanel. Este método te permite subir y activar módulos directamente en el servidor, evitando limitaciones del navegador y dándote acceso completo a la estructura de archivos. En esta guía, paso a paso y sin tecnicismos, te enseñaré cómo instalar módulos PrestaShop cPanel de forma segura y efectiva.

Requisitos previos antes de empezar

Antes de lanzarte a la instalación, asegúrate de tener lo siguiente:

Acceso a cPanel de tu hosting (usuario y contraseña).
Archivo del módulo en ZIP (no lo descomprimas aún).
Versión compatible del módulo con tu PrestaShop (revisa los requisitos del desarrollador).
Conexión estable a internet y un gestor de archivos (como FileZilla o el propio de cPanel).

[WARNING] Si tu hosting usa Syspanel (antes conocido como HestiaCP), el acceso se realiza a través del puerto 2106. Por ejemplo: https://tudominio.com:2106. El proceso es muy similar, pero la interfaz puede variar ligeramente.

Método 1: Instalación manual mediante el gestor de archivos de cPanel

Este es el método más recomendado para usuarios sin experiencia con FTP, ya que todo se hace desde el navegador.

Paso 1: Accede a cPanel

Abre tu navegador y escribe: https://tudominio.com/cpanel o la URL que te haya proporcionado tu proveedor de hosting.
Inicia sesión con tus credenciales.

Paso 2: Busca el gestor de archivos

Dentro de cPanel, localiza la sección Archivos y haz clic en Administrador de archivos.
Se abrirá una ventana. Selecciona la opción Raíz del documento (normalmente es public_html o www) y haz clic en Ir.

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

En el gestor de archivos, busca la carpeta de tu tienda PrestaShop. Si tu tienda está en la raíz, verás carpetas como modules, themes, img, etc.
Haz clic en la carpeta modules. Aquí es donde se almacenan todos los módulos instalados.

[TIP] Si tienes varias tiendas en el mismo hosting, asegúrate de entrar en la carpeta correcta. Por ejemplo: public_html/mitienda/modules.

Paso 4: Sube el archivo ZIP del módulo

Dentro de la carpeta modules, haz clic en el botón Subir (normalmente en la barra superior).
Se abrirá una ventana de arrastrar y soltar. Arrastra tu archivo .zip desde tu computadora o haz clic en Seleccionar archivo para buscarlo.
Espera a que la subida termine (verás una barra de progreso).

Paso 5: Descomprime el archivo

Una vez subido, vuelve a la carpeta modules (puede que necesites recargar la página).
Verás el archivo ZIP que acabas de subir. Haz clic derecho sobre él y selecciona Extraer o Descomprimir.
En la ventana que aparece, asegúrate de que la ruta de destino sea la misma carpeta (modules) y haz clic en Extraer archivos.

Paso 6: Verifica la estructura

Después de la extracción, deberías ver una nueva carpeta con el nombre del módulo (por ejemplo, micodigo_seo).
Elimina el archivo ZIP original (puedes seleccionarlo y hacer clic en Eliminar) para mantener limpia la carpeta.

Paso 7: Activa el módulo desde el panel de administración

Ve a tu tienda PrestaShop y accede al Back Office (normalmente tudominio.com/admin).
En el menú izquierdo, ve a Módulos > Módulos y servicios.
Busca el nombre del módulo que acabas de subir. Si todo salió bien, debería aparecer en la lista con el estado Desinstalado.
Haz clic en el botón Instalar y luego Activar (si es necesario).

[INFO] Si el módulo no aparece, revisa que la carpeta dentro de modules tenga los archivos correctos (como index.php, micodigo_seo.php, etc.) y que el nombre de la carpeta coincida exactamente con el nombre del módulo.

Método 2: Instalación mediante FTP (FileZilla)

Si prefieres usar un cliente FTP, el proceso es igual de sencillo. Aquí te lo explico:

Paso 1: Conéctate a tu servidor

Abre FileZilla (o cualquier cliente FTP).
Introduce los datos de conexión: Host (tudominio.com), Usuario y Contraseña (los mismos de cPanel).
Puerto: normalmente es 21 (o el que te haya proporcionado tu hosting).
Haz clic en Conexión rápida.

Paso 2: Navega a la carpeta de módulos

En el panel derecho (servidor), busca la carpeta public_html (o www).
Dentro, localiza la carpeta de tu tienda y luego la carpeta modules.

Paso 3: Sube el módulo

En el panel izquierdo (tu computadora), busca el archivo ZIP del módulo.
Arrastra el archivo ZIP desde la izquierda hacia la carpeta modules en la derecha.
Espera a que termine la transferencia.

Paso 4: Descomprime en el servidor

Con FileZilla, no puedes descomprimir directamente. Tendrás que hacerlo desde cPanel (como en el método anterior) o usar un comando SSH si tienes acceso.
Recomendación: Vuelve a cPanel, ve al gestor de archivos, localiza el ZIP en la carpeta modules y extráelo allí.

Paso 5: Activa el módulo

Igual que en el método anterior, ve al Back Office de PrestaShop e instala/activa el módulo.

[WARNING] No olvides eliminar el archivo ZIP después de descomprimirlo para evitar conflictos.

Solución de problemas comunes (FAQ)

¿Por qué no aparece el módulo en el Back Office?

Causa 1: La carpeta del módulo tiene un nombre incorrecto. Debe coincidir exactamente con el nombre del módulo en su archivo principal.
Causa 2: El módulo no es compatible con tu versión de PrestaShop. Revisa los requisitos.
Causa 3: No se ha subido a la carpeta correcta. Asegúrate de que esté dentro de modules.

¿Qué hago si el módulo da error al instalarlo?

Solución: Verifica que los archivos tengan permisos 755 (carpetas) y 644 (archivos). Puedes cambiarlos desde cPanel: haz clic derecho sobre la carpeta del módulo > Permisos.
Solución: Desactiva temporalmente la caché de PrestaShop desde Parámetros > Rendimiento.

¿Puedo instalar módulos desde Syspanel?

Sí, el proceso es similar. En Syspanel (HestiaCP, puerto 2106), usa el Administrador de archivos para subir y extraer el ZIP. La ruta también es public_html/modules.

¿Es seguro instalar módulos manualmente?

Siempre que descargues módulos de fuentes confiables (desarrolladores oficiales, marketplace de PrestaShop), es seguro. Evita módulos piratas o de dudosa procedencia.

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

Revisa los logs de errores de PrestaShop (Parámetros > Rendimiento > Logs). También puedes activar el modo debug desde el archivo config/defines.inc.php (cambia _PS_MODE_DEV_ a true).

Consejos adicionales para una instalación exitosa

Haz una copia de seguridad de tu tienda antes de instalar cualquier módulo, especialmente si es crítico.
Prueba el módulo en un entorno de desarrollo si es posible (subdominio o instalación local).
Mantén PrestaShop actualizado para evitar incompatibilidades.
Si usas Syspanel, recuerda que el acceso es por el puerto 2106 y la interfaz puede tener nombres diferentes (por ejemplo, "Archivos" en lugar de "Administrador de archivos").

Conclusión

Instalar módulos PrestaShop manual mediante cPanel es una habilidad esencial para cualquier administrador de tienda online. Te da control total, evita límites de subida y resuelve problemas comunes de instalación. Ya sea usando el gestor de archivos de cPanel o FTP, el proceso es sencillo si sigues los pasos al pie de la letra.

Recuerda siempre verificar la compatibilidad, hacer backups y mantener tu tienda optimizada. Con esta guía, podrás instalar módulos PrestaShop cPanel sin depender de asistencias técnicas y con total confianza.

[TIP] Si encuentras algún error, no dudes en consultar la documentación oficial de PrestaShop o contactar al soporte de tu hosting. ¡La práctica hace al maestro!

¿Te ha sido útil esta guía? Compártela con otros comerciantes o déjanos tus dudas en los comentarios. ¡Buena suerte con tu tienda!