Instalar módulos PrestaShop en cPanel | Tutorial fácil

¿Quieres ampliar las funcionalidades de tu tienda online o darle un cambio de imagen completamente nuevo? Si gestionas tu PrestaShop desde un hosting compartido o VPS, lo más probable es que tengas acceso a cPanel. Aunque PrestaShop tiene su propio gestor de módulos desde el panel de administración, a veces necesitas instalar módulos PrestaShop cPanel manualmente, ya sea porque el archivo es muy grande, porque el módulo no está en el marketplace oficial o porque prefieres tener un control total de los archivos.

En esta guía extensa, te voy a explicar paso a paso cómo realizar la instalación de módulos y temas PrestaShop cPanel de forma manual, usando el administrador de archivos de cPanel o un cliente FTP. No necesitas ser un experto en desarrollo; solo seguir estas instrucciones al pie de la letra. Al final, también responderemos a las preguntas más frecuentes para que no te quede ninguna duda.

[INFO] Esta guía es válida para cualquier versión reciente de PrestaShop (1.6, 1.7 y 8.x). Los pasos son prácticamente idénticos, aunque la carpeta de módulos puede variar ligeramente en versiones muy antiguas.

¿Por qué instalar módulos y temas desde cPanel?

Antes de meternos en harina, es importante que entiendas por qué a veces es mejor o necesario añadir módulos PrestaShop desde el panel de control de tu hosting, en lugar de hacerlo desde el back office de la tienda.

Límite de tamaño de archivo: El gestor de módulos de PrestaShop suele tener un límite de subida (por ejemplo, 2 MB o 8 MB). Si tu módulo o tema pesa más, fallará. Desde cPanel no hay ese límite.
Errores de conexión: A veces el marketplace de PrestaShop no responde o hay problemas de permisos. La instalación manual evita estos fallos.
Módulos personalizados o comprados fuera: Muchos desarrolladores venden módulos que no están en el marketplace oficial. La única forma de instalarlos es manual.
Control total: Puedes ver exactamente qué archivos se están copiando y dónde. Además, puedes hacer copias de seguridad fácilmente.

Requisitos previos antes de empezar

Para que todo salga bien, asegúrate de tener lo siguiente:

Acceso a cPanel: Necesitas el usuario y contraseña de tu hosting. Normalmente accedes desde tudominio.com/cpanel o tudominio.com:2083.
Archivo del módulo o tema: Debe venir en formato .zip o .tar.gz. Si está comprimido en .rar, descomprímelo en tu ordenador y vuélvelo a comprimir en .zip.
Ruta de instalación de PrestaShop: Generalmente está en public_html/ o en una subcarpeta (ej: public_html/tienda/). Debes saber exactamente dónde está.
Copia de seguridad: Antes de tocar archivos, haz una copia de seguridad de tu base de datos y de los archivos de la tienda. Por si las moscas.

[WARNING] No realizar una copia de seguridad puede dejarte la tienda inaccesible si algo sale mal. Dedica 5 minutos a hacerla, es muy sencillo desde cPanel.

Método 1: Instalar módulos y temas desde el Administrador de Archivos de cPanel

Este es el método más directo y no requiere programas externos. Lo haremos todo desde el navegador.

Paso 1: Accede al Administrador de Archivos

Inicia sesión en tu cPanel.
Busca la sección Archivos y haz clic en Administrador de Archivos.
Se abrirá una ventana. Selecciona la raíz del documento (normalmente public_html o www) y haz clic en Ir.

Paso 2: Localiza la carpeta de módulos o temas

Dentro de la estructura de archivos de tu PrestaShop, busca lo siguiente:

Para módulos: Ve a la carpeta modules/. Por ejemplo: public_html/modules/.
Para temas: Ve a la carpeta themes/. Por ejemplo: public_html/themes/.

Si tu tienda está en una subcarpeta, la ruta sería algo como public_html/mitienda/modules/.

Paso 3: Sube el archivo comprimido

En la parte superior del Administrador de Archivos, haz clic en Subir.
Se abrirá una ventana de selección de archivos. Elige el archivo .zip de tu módulo o tema.
Espera a que la barra de progreso llegue al 100%. No cierres la ventana hasta que termine.

Paso 4: Descomprime el archivo

Una vez subido, vuelve a la lista de archivos. Verás el .zip que acabas de subir.
Haz clic derecho sobre el archivo y selecciona Extraer (o Extract).
Se abrirá un cuadro de diálogo. La ruta de destino debe ser la misma carpeta donde está el archivo (por ejemplo, public_html/modules/). Haz clic en Extraer archivos.
Verás que se crea una nueva carpeta con el nombre del módulo o tema.

Paso 5: Verifica y elimina el comprimido

Comprueba que la carpeta extraída contiene archivos como index.php, config.xml o carpetas como views/, controllers/. Si solo ves otra carpeta dentro, algo salió mal (doble compresión). En ese caso, extrae manualmente o sube de nuevo.
Una vez verificado, selecciona el archivo .zip y haz clic en Eliminar (arriba a la derecha). No es necesario mantenerlo.

Paso 6: Instala desde el back office de PrestaShop

Ve a tu panel de administración de PrestaShop (ej: tudominio.com/admin1234).
Ve a Módulos > Gestor de módulos.
Busca el módulo que acabas de subir. Si no aparece, usa el botón Subir un módulo (a veces hay que refrescar la página o usar el buscador).
Haz clic en Instalar. El módulo ya está en los archivos, solo falta activarlo.

[TIP] Si el módulo no aparece, puede que necesites limpiar la caché de PrestaShop. Ve a Parámetros avanzados > Rendimiento y haz clic en Limpiar caché.

Método 2: Instalar módulos y temas mediante FTP (FileZilla)

Si prefieres usar un cliente FTP, el proceso es igual de sencillo. Este método es ideal si tienes muchos archivos que subir o si el Administrador de Archivos de cPanel va lento.

Paso 1: Conéctate a tu servidor FTP

Abre FileZilla (o cualquier cliente FTP).
Introduce los datos de conexión: servidor (normalmente tudominio.com o una IP), usuario y contraseña de FTP (los encuentras en cPanel, sección Cuentas FTP).
Puerto: 21 (por defecto).
Haz clic en Conexión rápida.

Paso 2: Navega hasta la carpeta correcta

En el lado derecho (servidor remoto), navega hasta la carpeta donde está tu PrestaShop. Normalmente:

public_html/modules/ (para módulos)
public_html/themes/ (para temas)

Paso 3: Sube la carpeta del módulo o tema

En tu ordenador (lado izquierdo), localiza la carpeta del módulo o tema ya descomprimida.
Arrástrala a la carpeta correspondiente en el servidor (lado derecho).
Espera a que termine la transferencia. Verás los archivos copiándose.

[INFO] Asegúrate de que estás subiendo la carpeta completa, no solo los archivos sueltos. Por ejemplo, si el módulo se llama micodigo, sube la carpeta micodigo/ entera.

Paso 4: Actívalo desde el back office

Igual que en el método anterior, ve a Módulos > Gestor de módulos en tu PrestaShop y busca el módulo. Si no aparece, refresca la página o limpia la caché.

Errores comunes y cómo solucionarlos

A veces, aunque sigas todos los pasos, pueden surgir problemas. Aquí tienes los más frecuentes:

El módulo no aparece en el gestor

Causa: La carpeta no está en la ruta correcta o el módulo está mal empaquetado.
Solución: Verifica que la carpeta esté dentro de modules/ y que contenga un archivo index.php. Si el módulo tiene una carpeta anidada (ej: modulo/modulo/), muévela un nivel arriba.

Error de permisos

Causa: Los archivos no tienen los permisos adecuados (normalmente 755 para carpetas y 644 para archivos).
Solución: Desde cPanel, selecciona la carpeta del módulo, haz clic derecho y elige Cambiar permisos. Pon 755 en carpetas y 644 en archivos. También puedes hacerlo desde FileZilla (clic derecho > Permisos de archivo).

El tema no se aplica o da error 500

Causa: El tema no es compatible con tu versión de PrestaShop o falta algún archivo.
Solución: Revisa los requisitos del tema en la documentación. A veces necesitas instalar un módulo complementario. Si el error es 500, revisa los logs de error de cPanel (sección Errores > Errores 500).

Preguntas frecuentes (FAQ)

¿Puedo instalar módulos PrestaShop cPanel si mi hosting usa HestiaCP (Syspanel)?

Sí, perfectamente. Si tu panel de control es Syspanel (el nombre que le damos a HestiaCP), el proceso es similar, pero el acceso es diferente. Debes conectarte mediante FTP o usar el Administrador de Archivos del propio Syspanel. El puerto de acceso a Syspanel es el 2106. Una vez dentro, busca la carpeta public_html y sigue los mismos pasos que en cPanel.

¿Qué hago si el módulo no se instala desde el back office después de subirlo?

Prueba a limpiar la caché de PrestaShop (Parámetros avanzados > Rendimiento > Limpiar caché). Si sigue sin aparecer, comprueba que el nombre de la carpeta coincide exactamente con el nombre del módulo en el marketplace.

¿Es seguro instalar módulos manualmente?

Sí, siempre que descargues el módulo de una fuente fiable (el desarrollador oficial o un proveedor de confianza). Los módulos de dudosa procedencia pueden contener código malicioso.

¿Puedo instalar un tema y un módulo al mismo tiempo?

Sí, no hay problema. Solo asegúrate de que el tema no requiera un módulo específico que aún no hayas instalado. Lee la documentación del tema antes.

¿Necesito conocimientos de programación?

No. Solo necesitas saber navegar por carpetas y arrastrar archivos. Eso es todo.

Conclusión

Instalar módulos PrestaShop cPanel es una habilidad básica que todo administrador de tiendas online debería dominar. Ya sea usando el Administrador de Archivos de cPanel o un cliente FTP como FileZilla, el proceso es rápido y te da un control total sobre tu tienda. Recuerda siempre hacer una copia de seguridad antes de cualquier cambio y verificar la compatibilidad de los módulos y temas con tu versión de PrestaShop.

Ahora que ya sabes cómo añadir módulos PrestaShop manualmente, podrás personalizar tu tienda sin límites. ¿Te animas a probarlo? Si tienes alguna duda, déjala en los comentarios (si este artículo está en un blog) o consulta la documentación oficial de PrestaShop. ¡Buena suerte!