Instalar módulos en PrestaShop manualmente desde cPanel

Instalar módulos en PrestaShop puede parecer complicado al principio, especialmente si no estás familiarizado con el panel de control de tu hosting. Sin embargo, con esta guía paso a paso, aprenderás a hacerlo de forma manual usando cPanel. Este método te da control total sobre los archivos de tu tienda y es ideal cuando el instalador automático de PrestaShop falla o el módulo requiere una configuración específica.

Aquí te explicamos todo lo que necesitas saber para instalar módulos en PrestaShop desde cPanel (método manual). Vamos a ello.

¿Por qué usar el método manual en cPanel?

El método manual para instalar módulos en PrestaShop es especialmente útil cuando:

El módulo que deseas instalar es pesado o tiene una estructura compleja.
El instalador automático de PrestaShop muestra errores (como problemas de permisos o de conexión FTP).
Necesitas subir el módulo directamente al servidor sin depender de la interfaz de administración.
Quieres tener un respaldo del módulo antes de activarlo.

Además, al hacerlo desde cPanel, accedes directamente al sistema de archivos de tu hosting, lo que te permite verificar y corregir cualquier problema de permisos o rutas.

[INFO] Este método es seguro siempre que descargues módulos de fuentes confiables (como el marketplace oficial de PrestaShop o desarrolladores reconocidos). Evita módulos piratas, ya que pueden comprometer la seguridad de tu tienda.

Requisitos previos

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

Acceso a tu panel de control cPanel (usuario y contraseña).
Un módulo de PrestaShop en formato ZIP (no lo descomprimas aún).
Conexión a internet estable.
Conocimiento básico de la estructura de carpetas de PrestaShop (aunque te guiaremos paso a paso).

Si tu hosting usa Syspanel en lugar de cPanel, el proceso es similar. Solo recuerda que el puerto de acceso es el 2106.

Paso 1: Accede a tu cPanel

Abre tu navegador y escribe la dirección de tu cPanel. Normalmente es algo como:

https://tudominio.com/cpanel

https://tudominio.com:2083

Ingresa tu usuario y contraseña (los mismos que usas para acceder a tu hosting).

[TIP] Si no recuerdas tus credenciales, revisa el correo de bienvenida de tu proveedor de hosting o contacta con su soporte técnico.

Paso 2: Busca el administrador de archivos

Una vez dentro de cPanel, busca la sección Archivos (Files). Allí verás la opción Administrador de Archivos (File Manager). Haz clic en ella.

Se abrirá una ventana que te mostrará la estructura de carpetas de tu hosting. Generalmente verás una carpeta llamada public_html (o www). Allí es donde está instalado tu PrestaShop.

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

Dentro de public_html, busca la carpeta de tu tienda PrestaShop. Si tu tienda está instalada en la raíz, verás directamente las carpetas de PrestaShop (como modules, themes, img, etc.). Si está en una subcarpeta (por ejemplo, public_html/tienda), navega hasta ella.

Ahora, busca la carpeta llamada modules. Haz clic derecho sobre ella y selecciona Ir a o simplemente haz doble clic para abrirla.

[WARNING] No modifiques ni borres archivos de otras carpetas. Solo trabaja dentro de modules.

Paso 4: Sube el módulo comprimido

Dentro de la carpeta modules, verás una lista de todas las carpetas de módulos instalados actualmente. Ahora:

Haz clic en el botón Subir (Upload) en la barra superior del Administrador de Archivos.
Se abrirá una ventana de carga. Haz clic en Seleccionar archivo (Select File) y busca el archivo ZIP del módulo que descargaste.
Espera a que la barra de progreso llegue al 100%.
Una vez subido, verás el archivo ZIP en la lista de archivos dentro de modules.

[TIP] Asegúrate de que el nombre del archivo ZIP no contenga espacios ni caracteres especiales (como ñ, tildes o símbolos). Si es necesario, renómbralo antes de subirlo.

Paso 5: Descomprime el módulo

Ahora que el ZIP está en la carpeta modules, debes descomprimirlo:

Haz clic derecho sobre el archivo ZIP.
Selecciona Extraer (Extract) o Descomprimir.
Se abrirá una ventana. Asegúrate de que la ruta de destino sea la misma carpeta modules (debe aparecer automáticamente).
Haz clic en Extraer archivos (Extract Files).

El sistema creará una nueva carpeta con el nombre del módulo (por ejemplo, micodigo, productcomments, etc.). Esta carpeta contiene todos los archivos del módulo.

[INFO] Si el módulo tiene varias subcarpetas, no te preocupes. La estructura debe coincidir con lo que PrestaShop espera.

Paso 6: Verifica los permisos de la carpeta del módulo

A veces, los módulos requieren permisos específicos para funcionar correctamente. Para evitar errores:

Haz clic derecho sobre la carpeta del módulo recién descomprimida.
Selecciona Cambiar permisos (Change Permissions).
Establece los permisos en 755 (lectura, escritura y ejecución para el propietario; lectura y ejecución para grupo y otros). Esto es seguro y suficiente para la mayoría de módulos.
Haz clic en Cambiar permisos.

Si el módulo necesita permisos más restrictivos (como 644 para archivos), el desarrollador lo indicará en su documentación.

[WARNING] No uses permisos 777 a menos que sea estrictamente necesario y sepas lo que haces. Puede exponer tu tienda a vulnerabilidades.

Paso 7: Instala el módulo desde el back office de PrestaShop

Ahora que el módulo está en el servidor, debes activarlo desde la administración de tu tienda:

Accede a tu back office de PrestaShop (por ejemplo, tudominio.com/adminXXXX).
Ve a Módulos > Gestor de módulos.
En la lista de módulos, busca el nombre del que acabas de subir. Puede aparecer automáticamente o puede que necesites hacer clic en el botón Buscar módulos o Instalar módulo.
Si aparece, haz clic en Instalar.
Sigue las instrucciones del módulo (configuración de opciones, si las tiene).

Si el módulo no aparece, ve a la pestaña Módulos > Módulos instalados y usa el buscador. A veces PrestaShop tarda unos segundos en refrescar la lista.

[TIP] Si el módulo sigue sin aparecer, verifica que el nombre de la carpeta dentro de modules coincida exactamente con el nombre del módulo en el ZIP. Por ejemplo, si el ZIP se llama productcomments.zip, la carpeta debe llamarse productcomments.

Paso 8: Prueba el módulo

Una vez instalado, ve a la página de configuración del módulo (si la tiene) y ajústalo según tus necesidades. Luego, visita tu tienda en el frontend para verificar que el módulo funciona correctamente. Por ejemplo, si instalaste un módulo de reseñas, prueba a dejar un comentario en un producto.

[INFO] Si encuentras errores (como pantalla blanca o mensajes de PHP), revisa los logs de error de PrestaShop en Parámetros avanzados > Información > Logs. También puedes activar el modo de depuración en Parámetros avanzados > Rendimiento (marca "Depurar modo").

Paso 9: Limpia los archivos temporales (opcional pero recomendado)

Después de instalar, puedes eliminar el archivo ZIP que subiste para liberar espacio:

Vuelve al Administrador de Archivos de cPanel.
Dentro de la carpeta modules, selecciona el archivo ZIP.
Haz clic derecho y elige Eliminar (Delete).
Confirma la eliminación.

Esto no afecta al módulo, ya que los archivos ya están descomprimidos.

Solución de problemas comunes

El módulo no aparece en el back office

Verifica que la carpeta del módulo esté dentro de modules y no en una subcarpeta adicional.
Asegúrate de que el nombre de la carpeta coincida con el nombre del módulo (sin espacios ni mayúsculas extrañas).
Revisa los permisos de la carpeta (755).
Limpia la caché de PrestaShop: en Parámetros avanzados > Rendimiento, haz clic en Limpiar caché.

Error "No se puede cargar el módulo"

El módulo puede requerir una versión específica de PHP o de PrestaShop. Consulta la documentación del módulo.
Comprueba que no haya conflictos con otros módulos instalados.
Revisa los logs de error del servidor en cPanel (sección Métricas > Errores).

Pantalla blanca después de instalar

Desactiva el módulo desde el back office (si puedes acceder).
Si no puedes acceder, elimina la carpeta del módulo desde el Administrador de Archivos de cPanel. Luego, vuelve a intentar con una versión diferente del módulo.

[WARNING] Si borras la carpeta del módulo, perderás toda su configuración. Asegúrate de tener un respaldo si es necesario.

Preguntas frecuentes (FAQ)

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

Sí, el proceso es idéntico. Solo que en lugar de cPanel, usarás Syspanel. Recuerda que el puerto de acceso es el 2106. Una vez dentro, busca el Administrador de Archivos y sigue los mismos pasos.

¿El método manual es más rápido que el automático?

Depende. Si el módulo es pequeño, el automático puede ser más rápido. Pero si tienes problemas con el instalador, el manual suele ser más fiable.

¿Qué hago si el módulo no es compatible con mi versión de PrestaShop?

Revisa la documentación del módulo. Algunos módulos requieren versiones específicas. Si no es compatible, contacta al desarrollador o busca una alternativa.

¿Puedo instalar varios módulos a la vez?

Sí, puedes subir y descomprimir varios ZIPs en la carpeta modules. Luego, actívalos uno por uno desde el back office.

¿Es seguro instalar módulos de terceros?

Siempre que los descargues de fuentes confiables (como el marketplace oficial de PrestaShop o desarrolladores reconocidos), es seguro. Evita módulos de sitios dudosos o piratas.

Conclusión

Instalar módulos en PrestaShop desde cPanel de forma manual es un proceso sencillo una vez que conoces los pasos. Te da control total sobre los archivos y es una excelente alternativa cuando el método automático falla. Recuerda siempre verificar los permisos, limpiar la caché después de instalar y probar el módulo en tu tienda.

Con esta guía, ya estás listo para instalar módulos en PrestaShop desde cPanel (método manual) sin complicaciones. ¡Manos a la obra y mejora tu tienda con nuevas funcionalidades!

[TIP] Guarda esta guía en tus favoritos. Te será útil cada vez que necesites instalar un módulo de forma manual.