Cómo instalar módulos y temas en PrestaShop con Syspanel

¡Hola! Bienvenido a esta guía completa. Si tienes una tienda online con PrestaShop, sabrás que una de sus mayores ventajas es la posibilidad de ampliarla y personalizarla mediante módulos (que añaden funcionalidades) y temas (que cambian el diseño).

En este artículo, te explicaré paso a paso cómo realizar esta tarea directamente desde Syspanel (el panel de control de tu hosting, cuyo acceso se realiza a través del puerto 2106). No necesitas ser un experto técnico; solo sigue las instrucciones y verás que es muy sencillo.

Empecemos.

¿Qué es Syspanel y cómo acceder a él?

Syspanel es la herramienta de administración de tu servidor (basada en HestiaCP). Desde aquí puedes gestionar tus sitios web, bases de datos, cuentas de correo y, por supuesto, los archivos de tu tienda PrestaShop.

Para acceder, abre tu navegador y escribe la siguiente dirección:
https://tudominio.com:2106
(Recuerda sustituir "tudominio.com" por tu dominio real).

Introduce tu usuario y contraseña (los mismos que usas para acceder al panel de tu hosting). Una vez dentro, verás un escritorio con varias opciones. La que nos interesa hoy es la sección de Archivos o File Manager, aunque también usaremos la terminal para tareas más avanzadas.

Antes de empezar: requisitos y precauciones

Antes de instalar cualquier cosa, ten en cuenta lo siguiente:

Haz una copia de seguridad de tu tienda. Siempre. Un módulo o tema incompatible puede romper tu web. En Syspanel, puedes ir a la sección de Backups para generar una copia completa.
Verifica la compatibilidad: Asegúrate de que el módulo o tema sea compatible con tu versión de PrestaShop (1.6, 1.7, 8.x, etc.). Puedes consultarlo en la ficha del producto o en la web del desarrollador.
Espacio en disco: Comprueba que tienes suficiente espacio. En Syspanel, en la sección Estadísticas, verás el uso de disco.

[INFO] Algunos módulos requieren permisos de escritura en carpetas específicas. Si ves errores de permisos, no te preocupes; más adelante te explico cómo solucionarlo desde Syspanel.

Método 1: Instalar módulos PrestaShop desde el propio backoffice (recomendado para principiantes)

Este es el método más sencillo, pero a veces falla por límites de tamaño de archivo o permisos. Si te da error, pasa al Método 2.

Paso 1: Descarga el módulo o tema

Consigue el archivo comprimido (normalmente en .zip o .tar.gz) desde el marketplace oficial de PrestaShop, un desarrollador externo o un proveedor de confianza.

Paso 2: Accede al backoffice de tu tienda

Ve a tudominio.com/adminXXXX (donde XXXX es un código aleatorio que te dieron al instalar). Inicia sesión.

Paso 3: Sube e instala el módulo

En el menú lateral, ve a Módulos > Módulos y servicios.
Haz clic en el botón Subir un módulo (arriba a la derecha).
Selecciona el archivo .zip desde tu ordenador.
Espera a que se suba y se instale automáticamente. Verás un mensaje de éxito.

Para temas: Ve a Diseño > Temas y plantillas, luego haz clic en Añadir un nuevo tema y sube el archivo.

[WARNING] Si el archivo pesa más de lo permitido por tu servidor (normalmente 2MB, 8MB o 20MB), la subida fallará. En ese caso, usa el Método 2.

Método 2: Instalar módulos PrestaShop manualmente desde Syspanel (más fiable)

Cuando el método automático falla, la instalación manual es la solución. Usaremos el Administrador de archivos de Syspanel.

Paso 1: Sube el archivo comprimido a tu servidor

En Syspanel, ve a Archivos > Administrador de archivos.
Navega hasta la carpeta raíz de tu tienda. Normalmente es algo como /home/usuario/web/tudominio/public_html (o public_html directamente).
Arriba a la derecha, haz clic en Subir y selecciona el archivo .zip de tu ordenador. Se subirá directamente a esa carpeta.

Paso 2: Descomprime el archivo en la ubicación correcta

Una vez subido, localiza el archivo en el listado y haz clic derecho sobre él. Selecciona Extraer (o Unzip).
El sistema te preguntará dónde extraerlo. Para módulos, la carpeta de destino debe ser:
.../public_html/modules/
Para temas:
.../public_html/themes/
Acepta y espera a que se complete. Si todo va bien, verás una nueva carpeta con el nombre del módulo o tema.

Paso 3: Instala desde el backoffice

Vuelve a tu backoffice de PrestaShop.
Ve a Módulos > Módulos y servicios.
En la lista de módulos (no en "Subir un módulo"), busca el que acabas de subir. Puede que aparezca automáticamente o necesites hacer clic en el botón Instalar que aparece a su lado.
Haz clic en Instalar y listo.

[TIP] Si el módulo no aparece, refresca la página del backoffice (F5) o cierra sesión y vuelve a entrar.

Método 3: Instalar temas PrestaShop desde Syspanel (paso a paso)

Los temas se instalan de forma similar a los módulos, pero tienen su propio procedimiento.

Paso 1: Sube el tema comprimido

Sigue el mismo proceso del Método 2, pero esta vez extrae el archivo en la carpeta .../public_html/themes/.

Paso 2: Activa el tema desde el backoffice

En PrestaShop, ve a Diseño > Temas y plantillas.
En la sección Temas instalados, deberías ver el nuevo tema listado. Si no aparece, haz clic en el botón Añadir nuevo tema y luego en Seleccionar archivo para subirlo desde el backoffice (aunque ya esté en la carpeta, a veces el sistema necesita un "empujón").
Una vez visible, haz clic en Usar este tema para activarlo.

Paso 3: Configura el tema

Cada tema tiene sus propias opciones de personalización (colores, fuentes, diseños de página). Normalmente encontrarás un apartado llamado Configuración del tema o Theme configurator en el menú de Diseño.

[WARNING] Al activar un tema nuevo, es posible que algunos módulos dejen de funcionar o se vean raros. No te asustes; muchos temas traen sus propios módulos. Simplemente revisa la apariencia de tu tienda y ajusta lo necesario.

Solución de problemas comunes (FAQ)

Aquí tienes las dudas más frecuentes que resuelven los usuarios al instalar módulos PrestaShop o temas PrestaShop Syspanel.

1. "El módulo no aparece en el backoffice después de subirlo"

Causa: La carpeta del módulo no está en la ruta correcta o tiene permisos incorrectos.
Solución: Desde Syspanel, ve a Archivos y revisa que la carpeta del módulo esté dentro de /public_html/modules/. Luego, selecciona la carpeta, haz clic derecho y elige Permisos. Asegúrate de que esté en 755 o 775. También puedes probar a cambiar el propietario a www-data (o el usuario de tu servidor web) desde la opción Propietario.

2. "Error de compatibilidad al instalar"

Causa: El módulo o tema no es compatible con tu versión de PrestaShop.
Solución: Revisa la ficha del producto. Si es un módulo antiguo, puedes intentar modificar el archivo config.xml dentro de la carpeta del módulo (con un editor de texto desde Syspanel) para cambiar la línea <version> a una compatible, pero esto no siempre funciona y puede causar errores. Mejor busca una versión actualizada.

3. "No puedo subir el archivo porque es demasiado grande"

Causa: Límite de tamaño de subida en PHP.
Solución: Desde Syspanel, ve a Configuración avanzada > PHP (o PHP Settings). Busca las opciones upload_max_filesize y post_max_size y auméntalas (por ejemplo, a 64M). Guarda los cambios. Si no ves esta opción, contacta a tu soporte técnico.

4. "El tema se ve roto o con estilos incorrectos"

Causa: No se ha regenerado la caché de PrestaShop.
Solución: En el backoffice, ve a Parámetros avanzados > Rendimiento. Haz clic en Limpiar la caché (tanto de Smarty como de la caché del servidor). Luego, en Diseño > Temas, haz clic en Regenerar miniaturas para las imágenes.

5. "Después de instalar un módulo, la tienda da error 500"

Causa: Conflicto con otro módulo o error en el código.
Solución: Desde Syspanel, accede a la carpeta /public_html/modules/ y cambia el nombre de la carpeta del módulo recién instalado (por ejemplo, añade _backup al final). Esto desactivará el módulo. Luego, desde el backoffice, desinstálalo o elimínalo definitivamente.

Consejos para personalizar tu tienda con módulos y temas

Más allá de la instalación, aquí tienes algunas ideas para sacar el máximo partido a tu personalizar tienda con PrestaShop:

Módulos esenciales: No te olvides de instalar un módulo de SEO (como el de metadatos automáticos), un módulo de envío, uno de pago seguro y otro de análisis (Google Analytics). Son la base de una tienda funcional.
Temas responsive: Elige temas que se adapten a móviles. Puedes probar su vista previa desde el backoffice antes de activarlos.
Personalización avanzada: Si sabes algo de CSS, puedes modificar el archivo custom.css del tema desde Syspanel (en /themes/tu_tema/assets/css/). Así cambias colores, fuentes o tamaños sin tocar el código principal.
Prueba en un entorno de desarrollo: Si tienes dudas, crea una copia de tu tienda en un subdominio (por ejemplo, test.tudominio.com) y prueba allí los módulos y temas antes de aplicarlos en producción.

Conclusión

Instalar módulos y temas en PrestaShop desde Syspanel es un proceso que, una vez que lo dominas, te da un control total sobre tu tienda. Recuerda siempre:

Acceder a Syspanel por el puerto 2106.
Hacer copias de seguridad antes de cualquier cambio.
Usar el Administrador de archivos para subir y descomprimir los paquetes.
Verificar permisos y compatibilidad.

Con estos pasos, podrás personalizar tienda a tu gusto, añadir funcionalidades nuevas y mantener tu PrestaShop actualizado y seguro. Si te surge alguna duda, no dudes en volver a consultar esta guía o contactar con tu proveedor de hosting.

¡Feliz personalización!