Instalar módulos en PrestaShop desde Syspanel: tutorial fácil

¿Necesitas ampliar las funcionalidades de tu tienda online añadiendo nuevos módulos? Si gestionas tu PrestaShop a través de Syspanel (el panel de control basado en HestiaCP, accesible por el puerto 2106), estás de suerte. Esta guía te enseñará paso a paso cómo instalar módulos PrestaShop de forma segura y eficiente, ya sea desde el propio backoffice o subiendo archivos manualmente.

En este artículo aprenderás a instalar plugins sin complicaciones, resolver los errores más comunes y mantener tu gestión tienda optimizada. Vamos allá.

¿Qué son los módulos en PrestaShop y por qué son importantes?

Los módulos son extensiones que añaden funcionalidades específicas a tu tienda online. Pueden ser desde un simple bloque de búsqueda hasta un completo sistema de envíos o pasarela de pago. Sin ellos, PrestaShop sería una plataforma muy básica. Por eso, saber cómo instalar plugins correctamente es una habilidad esencial para cualquier propietario de tienda.

Con Syspanel, tienes control total sobre tu servidor, lo que facilita la instalación de módulos que requieren acceso a archivos del sistema o modificaciones en la base de datos.

Requisitos previos antes de instalar módulos

Antes de empezar, asegúrate de cumplir con estos puntos:

Acceso a Syspanel: Necesitas las credenciales de administrador de tu hosting. Recuerda que la URL de acceso es tudominio.com:2106.
Versión compatible: Verifica que el módulo sea compatible con tu versión de PrestaShop (1.6, 1.7 o 8.x).
Copia de seguridad: Siempre haz una copia de seguridad de tu tienda y base de datos antes de instalar cualquier módulo nuevo.
Permisos de escritura: Los directorios /modules y /themes deben tener permisos 755 o 775.

[WARNING] Instalar módulos de fuentes no oficiales puede comprometer la seguridad de tu tienda. Descarga siempre de la tienda oficial de PrestaShop o de desarrolladores de confianza.

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

Este es el método más sencillo y seguro. Solo necesitas el archivo ZIP del módulo.

Paso 1: Accede al panel de administración de PrestaShop

Ingresa a tu dominio seguido de /admin (ejemplo: tumitienda.com/admin). Introduce tu usuario y contraseña.

Paso 2: Ve al gestor de módulos

En el menú lateral izquierdo, busca la sección "Módulos" y haz clic en "Gestor de módulos" (o "Módulos y servicios" en versiones antiguas).

Paso 3: Sube el módulo

Haz clic en el botón "Subir un módulo" (normalmente en la parte superior derecha). Se abrirá una ventana para seleccionar el archivo ZIP. Arrástralo o búscalo en tu ordenador.

Paso 4: Instala y configura

Una vez subido, PrestaShop lo procesará automáticamente. Si todo va bien, verás el módulo en la lista. Haz clic en "Instalar" y luego en "Configurar" para ajustar sus opciones.

[TIP] Si el módulo requiere dependencias (como librerías PHP), el sistema te avisará. En ese caso, contacta con tu soporte de hosting para que las instale en tu servidor.

Método 2: Instalar módulos manualmente a través de Syspanel (para módulos problemáticos)

A veces, el backoffice no permite la instalación por límites de tamaño de archivo o errores de permisos. Entonces, la instalación manual es tu mejor aliada.

Paso 1: Conéctate a Syspanel

Abre tu navegador y ve a tudominio.com:2106. Inicia sesión con tus credenciales de administrador del hosting.

Paso 2: Accede al gestor de archivos

En el panel de Syspanel, busca la opción "Archivos" o "Gestor de archivos". Te llevará al explorador de archivos de tu servidor.

Paso 3: Navega hasta la carpeta de módulos

Dentro del gestor, localiza la carpeta public_html (o htdocs). Dentro de ella, busca la carpeta de tu tienda (ejemplo: shop). Luego, entra en modules. Aquí es donde se almacenan todos los módulos.

Paso 4: Sube el módulo descomprimido

Opción A: Sube el archivo ZIP directamente y luego haz clic derecho > "Extraer" para descomprimirlo.
Opción B: Descomprime el ZIP en tu ordenador y sube la carpeta completa mediante el botón "Subir".

Asegúrate de que el nombre de la carpeta coincida exactamente con el nombre del módulo (ejemplo: ps_emailalerts).

Paso 5: Instala el módulo desde el backoffice

Ahora vuelve al panel de administración de PrestaShop. Ve a "Módulos" > "Gestor de módulos". El módulo debería aparecer en la lista (si no, recarga la página). Haz clic en "Instalar".

[INFO] Si el módulo no aparece, verifica que la carpeta tenga los permisos correctos (755). En Syspanel, puedes cambiar permisos haciendo clic derecho sobre la carpeta y seleccionando "Permisos".

Solución de problemas comunes al instalar módulos

Error: "No se puede cargar el módulo" o "Módulo no encontrado"

Causa: El módulo no está en la carpeta correcta o los permisos son incorrectos.

Solución:

Verifica que la carpeta esté dentro de /modules y tenga el nombre exacto.
Cambia los permisos de la carpeta a 755 desde Syspanel (gestor de archivos > clic derecho > Permisos).

Error: "El archivo ZIP es demasiado grande"

Causa: Límite de subida en el backoffice (normalmente 8MB).

Solución: Usa el método manual (Método 2) para subir el módulo descomprimido a través de Syspanel.

Error: "El módulo requiere PHP versión X.X"

Causa: Tu servidor tiene una versión de PHP inferior a la necesaria.

Solución: Desde Syspanel, ve a "Ajustes" > "PHP" y selecciona una versión superior (ejemplo: 7.4 o 8.0). Guarda los cambios.

Error: "El módulo no es compatible con tu versión de PrestaShop"

Causa: El módulo está diseñado para una versión diferente.

Solución: Busca una versión del módulo específica para tu PrestaShop o contacta al desarrollador.

Cómo gestionar los módulos instalados en tu tienda

Una vez instalados, es importante mantenerlos actualizados y organizados.

Actualizar módulos

Desde el backoffice, ve a "Módulos" > "Gestor de módulos". Los módulos con actualizaciones disponibles mostrarán un botón "Actualizar". Haz clic para obtener la última versión.

[WARNING] Antes de actualizar, lee las notas de la versión. Algunas actualizaciones pueden romper la compatibilidad con otros módulos o temas.

Desinstalar o eliminar módulos

Si un módulo ya no te sirve, es mejor eliminarlo por completo para liberar recursos.

En el gestor de módulos, busca el módulo y haz clic en "Desinstalar".
Luego, haz clic en "Eliminar" para borrar sus archivos del servidor.

También puedes eliminar la carpeta manualmente desde Syspanel (gestor de archivos) si el botón de eliminar no funciona.

Preguntas frecuentes (FAQ)

¿Puedo instalar módulos gratuitos de terceros?

Sí, pero con precaución. Asegúrate de que el desarrollador sea confiable y de que el módulo no tenga malware. Siempre revisa las reseñas y la fecha de actualización.

¿Qué hago si un módulo rompe mi tienda?

Si después de instalar un módulo tu tienda deja de funcionar, accede a Syspanel y renombra la carpeta del módulo (por ejemplo, añade _old al final). Esto lo desactivará. Luego, desde el backoffice, desinstálalo y elimínalo.

¿Los módulos afectan el rendimiento de mi tienda?

Sí, especialmente los que hacen muchas consultas a la base de datos o cargan scripts pesados. Instala solo los módulos necesarios y mantenlos actualizados.

¿Puedo instalar módulos desde la consola de Syspanel?

Sí, si tienes conocimientos técnicos, puedes usar el terminal de Syspanel (acceso SSH) para descargar e instalar módulos con comandos como wget y unzip. Pero para la mayoría de usuarios, el gestor de archivos es más seguro.

¿Cómo sé si un módulo es compatible con mi versión de PrestaShop?

Revisa la ficha del módulo en la tienda oficial. Normalmente indica las versiones compatibles (ejemplo: "1.7.x" o "8.x"). También puedes consultar el archivo config.xml dentro del ZIP del módulo.

Consejos finales para una gestión eficiente de tu tienda

Mantén un registro: Lleva un listado de los módulos instalados y su propósito. Esto te ayudará a depurar problemas.
Usa un entorno de pruebas: Si tu tienda es grande, instala los módulos primero en un subdominio o copia local antes de ponerlos en producción.
Automatiza las copias de seguridad: Desde Syspanel, programa copias de seguridad automáticas de tu base de datos y archivos. Así, si algo sale mal, puedes restaurar rápidamente.

Instalar módulos PrestaShop a través de Syspanel es un proceso sencillo si sigues los pasos correctos. Ya sea usando el backoffice o la instalación manual, lo importante es mantener la seguridad y el rendimiento de tu tienda. Ahora que sabes cómo hacerlo, ¡dale un impulso a tu negocio online con los plugins que necesitas!

Si tienes dudas, recuerda que tu equipo de soporte técnico está disponible para ayudarte. ¡Buena suerte con tu gestión tienda!