Instalar temas y módulos en PrestaShop con cPanel | Ayuda básica

¿Quieres darle un lavado de cara a tu tienda online o añadirle funciones nuevas sin complicarte la vida? Estás en el lugar correcto. Aunque instalar temas PrestaShop desde el backoffice es lo más común, a veces te encuentras con errores de límite de memoria, archivos corruptos o simplemente prefieres tener más control. Ahí es donde entra cPanel, el panel de control de tu hosting. En esta guía, te voy a enseñar paso a paso cómo subir e instalar tanto temas como módulos desde el administrador de archivos de cPanel. Es más fácil de lo que crees y te sacará de más de un apuro.

¿Por qué instalar desde cPanel y no desde el backoffice?

Antes de meternos en faena, es bueno que sepas por qué esta opción es tan útil. El backoffice de PrestaShop es intuitivo, pero tiene sus limitaciones:

Tamaño de archivo: Muchos servidores limitan la subida a 2MB o 8MB. Los temas y módulos premium suelen pesar mucho más.
Tiempo de ejecución: Si el proceso se alarga, el navegador puede dar timeout y la instalación se queda a medias.
Errores de memoria: PHP tiene un límite de memoria. Si el tema es pesado, puede saltar un error fatal.
Control total: Al hacerlo manualmente, ves exactamente dónde se colocan los archivos y puedes solucionar problemas de permisos sobre la marcha.

Instalar desde cPanel te da el control absoluto. Es como tener la llave maestra de tu tienda.

Requisitos previos: lo que necesitas antes de empezar

No necesitas ser un experto, pero sí tener a mano algunas cosas:

Acceso a cPanel: Tus credenciales de hosting (usuario y contraseña). Normalmente las recibiste por correo al contratar el plan.
El archivo del tema o módulo: Debe estar en formato .zip o .tar.gz. Asegúrate de que sea la versión compatible con tu PrestaShop (1.6, 1.7, 8.x, etc.).
Un cliente FTP o el Administrador de Archivos de cPanel: Usaremos este último, que es más visual y no necesita software extra.
Copia de seguridad: Antes de tocar nada, haz una copia de seguridad de tu base de datos y archivos. Por si acaso.
Paciencia y un café: No es complicado, pero hay que seguir los pasos con calma.

[WARNING] Si tu hosting usa Syspanel (antes conocido como HestiaCP), el proceso es muy similar, pero el acceso es por el puerto 2106. Por ejemplo: https://tudominio.com:2106. El resto de pasos son idénticos.

Paso 1: Accede a cPanel y localiza el Administrador de Archivos

Esto es pan comido. Abre tu navegador y escribe la dirección de acceso a cPanel. Normalmente es algo como:
https://tudominio.com/cpanel o https://tudominio.com:2083.

Introduce tu usuario y contraseña. Una vez dentro, busca el icono que dice "Administrador de Archivos" (File Manager). Está en la sección "Archivos". Haz clic.

Se abrirá una ventana con la estructura de carpetas de tu hosting. Verás varias carpetas como public_html, tmp, logs, etc.

Paso 2: Navega hasta la carpeta raíz de tu PrestaShop

Tu tienda PrestaShop está alojada dentro de una carpeta específica. Normalmente es public_html (si instalaste PrestaShop directamente en la raíz de tu dominio) o una subcarpeta como public_html/tienda o public_html/prestashop.

Para saber cuál es, piensa en la URL de tu tienda. Si tu tienda está en www.tudominio.com, la raíz es public_html. Si está en www.tudominio.com/tienda, la raíz es public_html/tienda.

Dentro de esa carpeta, busca las siguientes subcarpetas:

Para temas: /themes
Para módulos: /modules

Es importante que estés dentro de la carpeta correcta. Si subes un módulo a la carpeta de temas, no funcionará.

Paso 3: Subir el archivo ZIP del tema o módulo

Vamos a subir el archivo comprimido. En la barra superior del Administrador de Archivos, verás un botón que dice "Subir" (Upload). Haz clic.

Se abrirá una ventana de selección de archivos. Busca en tu ordenador el .zip del tema o módulo que descargaste. Selecciónalo y espera a que la subida termine. Verás una barra de progreso.

[TIP] Si el archivo es muy grande (más de 100MB), puede que el Administrador de Archivos de cPanel se queje. En ese caso, usa un cliente FTP como FileZilla. Es igual de fácil y no tiene límite de tamaño.

Una vez subido, el archivo aparecerá en la carpeta donde estás (por ejemplo, dentro de /themes o /modules).

Paso 4: Descomprimir el archivo en la carpeta correcta

Ahora viene el paso clave. Busca el archivo .zip que acabas de subir. Haz clic derecho sobre él (o selecciónalo y usa el menú superior). Verás la opción "Extraer" (Extract).

Te preguntará dónde quieres extraer los archivos. Por defecto, te sugerirá la misma carpeta donde está el ZIP. Déjalo así. Haz clic en "Extraer archivos".

El sistema descomprimirá todo el contenido. Dependiendo del tamaño, puede tardar unos segundos. Cuando termine, verás una nueva carpeta con el nombre del tema o módulo (por ejemplo, mi-tema-personalizado o mimodulopago).

¡Importante! Una vez extraído, puedes eliminar el archivo .zip para mantener ordenada la carpeta. No es obligatorio, pero es una buena práctica.

Paso 5: Verificar que los archivos están en su sitio

Antes de ir al backoffice, vamos a asegurarnos de que la estructura es correcta.

Para un tema: Dentro de la carpeta del tema (ej: /thebes/mi-tema-personalizado), debe haber archivos como theme.yml (en PrestaShop 1.7+) o config.xml (en versiones antiguas), además de carpetas como css, js, img, templates, etc.
Para un módulo: Dentro de la carpeta del módulo (ej: /modules/mimodulopago), debe haber un archivo principal con el nombre del módulo y extensión .php (ej: mimodulopago.php).

Si ves esos archivos, vas por buen camino.

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

Ahora sí, abre tu navegador y accede al panel de administración de tu tienda (normalmente www.tudominio.com/adminXXXXXX).

Instalar y activar un tema

Ve al menú "Diseño" > "Temas y logotipos".
Verás una lista de los temas disponibles. El que acabas de subir manualmente debería aparecer aquí (si no aparece, revisa el paso 4 y asegúrate de que la carpeta esté en /themes).
Haz clic en el botón "Usar este tema" o "Instalar" (depende de la versión).
El tema se activará. Es posible que te pida configurar algunas opciones. Sigue las instrucciones del desarrollador.

Instalar y activar un módulo

Ve al menú "Módulos" > "Gestor de módulos".
En la parte superior, verás un botón que dice "Subir un módulo" o "Instalar un módulo". Haz clic.
Se abrirá una ventana. No necesitas subir nada aquí, porque el módulo ya está en la carpeta. Simplemente, busca el módulo en la lista de "Módulos instalados" (a veces aparecen directamente en "Módulos no instalados").
Si no aparece, usa el buscador de la parte superior derecha con el nombre del módulo.
Una vez localizado, haz clic en "Instalar". El sistema hará las comprobaciones necesarias.
Después de la instalación, verás un botón "Configurar". Púlsalo para ajustar los parámetros del módulo.

[INFO] Si el módulo no aparece en la lista, puede ser porque la carpeta tiene permisos incorrectos. Desde cPanel, haz clic derecho sobre la carpeta del módulo, selecciona "Cambiar permisos" y pon 755 (o 0755). Luego refresca el backoffice.

Solución de problemas comunes (FAQ)

Aquí tienes las dudas más frecuentes que resuelvo a diario:

¿Por qué no veo el tema en el backoffice después de subirlo?

Causa 1: Lo subiste a la carpeta equivocada. Revisa que esté dentro de /themes y no en /modules.
Causa 2: El tema no es compatible con tu versión de PrestaShop. Por ejemplo, un tema de PS 1.6 no funcionará en PS 1.7.
Causa 3: La carpeta del tema tiene un nombre incorrecto o contiene archivos corruptos. Vuelve a descargarlo del desarrollador.

El módulo se instala pero da error "Clase no encontrada"

Esto suele pasar porque el archivo principal del módulo no tiene el nombre correcto. Por ejemplo, si el módulo se llama mimodulopago, el archivo principal debe ser mimodulopago.php (exactamente igual, respetando mayúsculas/minúsculas). Revisa la documentación del módulo.

No tengo acceso a cPanel, ¿qué hago?

Si tu hosting no te da cPanel (por ejemplo, usas un plan gestionado), pide a tu proveedor que te instale el tema o módulo. Otra opción es usar un cliente FTP como FileZilla. El proceso es el mismo: conéctate, navega a las carpetas /themes o /modules, sube el ZIP, descomprímelo y luego actívalo desde el backoffice.

¿Puedo instalar varios temas a la vez?

Sí, puedes tener varios temas en la carpeta /themes, pero solo uno puede estar activo a la vez. Los demás quedarán como "no usados". Es útil para tener backups visuales.

Después de instalar el tema, la tienda se ve en blanco

Esto indica un error de PHP. Activa el modo debug de PrestaShop para ver el error concreto. Ve a /config/defines.inc.php y cambia _PS_MODE_DEV_ a true. Luego recarga la tienda. Verás el mensaje de error. Lo más común es que falte un archivo o haya un conflicto de versiones.

Consejos finales para una PrestaShop personalización exitosa

Prueba en un entorno de desarrollo: Si puedes, instala el tema o módulo primero en una copia local o en un subdominio de pruebas. Así evitas romper la tienda en producción.
Lee las instrucciones del desarrollador: Cada tema y módulo tiene sus propias reglas. Algunos requieren instalar módulos adicionales o modificar archivos de configuración.
Actualiza todo: Asegúrate de que tu PrestaShop, el tema y los módulos estén actualizados a la última versión. La compatibilidad es clave.
Usa un buen hosting: Si tu servidor es lento, la instalación manual desde cPanel no solucionará los problemas de rendimiento. Invertir en un buen hosting es fundamental.
No te olvides de la caché: Después de instalar un tema o módulo, ve a "Parámetros de la tienda" > "Rendimiento" y limpia la caché. Esto evita que se muestren archivos antiguos.

Conclusión

Instalar temas PrestaShop y módulos PrestaShop desde cPanel no es un misterio. Es un proceso manual que te da control total y evita los límites del backoffice. Siguiendo estos pasos, podrás personalizar tu tienda sin depender de asistencias técnicas ni sufrir con errores de subida.

Recuerda: la clave está en la paciencia y en verificar cada paso. Si algo falla, revisa los permisos de las carpetas y la compatibilidad de versiones. Y si tu hosting es Syspanel, no olvides el puerto 2106 para acceder.

Ahora, manos a la obra. Dale a tu tienda ese aspecto único que buscas o añade esa funcionalidad que tus clientes necesitan. ¡Tú puedes hacerlo!