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

Introducción: ¿Por qué usar Syspanel para gestionar tu PrestaShop?

Si tienes una tienda online con PrestaShop, sabes que los módulos son el alma de tu negocio. Te permiten añadir funcionalidades como pasarelas de pago, envíos, SEO, o sistemas de reseñas. Pero, ¿qué pasa cuando necesitas instalar módulos PrestaShop desde Syspanel? Si no tienes experiencia técnica, puede parecer complicado, pero con esta guía lo harás en minutos.

Syspanel (el panel de control que antes se conocía como HestiaCP, y al que accedes por el puerto 2106) es una herramienta potente y sencilla que te permite gestionar tu servidor, archivos y bases de datos. A diferencia de otros paneles, Syspanel está optimizado para ser rápido y fácil de usar, ideal para dueños de tiendas que no quieren complicarse con líneas de comandos.

En este artículo, te explicaré paso a paso cómo instalar cualquier módulo en PrestaShop usando Syspanel. Cubriremos desde la descarga del módulo hasta su activación, pasando por la subida de archivos y la resolución de problemas comunes. Al final, tendrás una sección de preguntas frecuentes (FAQ) para resolver tus dudas más habituales.

Requisitos previos antes de empezar

Antes de lanzarte a instalar módulos, asegúrate de tener lo siguiente:

Acceso a Syspanel: Debes conocer la URL de tu panel (normalmente https://tudominio.com:2106) y tus credenciales de administrador.
Un módulo compatible: Descarga el módulo en formato .zip desde un proveedor de confianza (por ejemplo, el marketplace oficial de PrestaShop o el desarrollador).
Conexión FTP o gestor de archivos: Syspanel incluye un gestor de archivos integrado, pero también puedes usar un cliente FTP como FileZilla.
Copia de seguridad: Siempre es recomendable hacer una copia de seguridad de tu tienda antes de instalar nuevos módulos. Puedes hacerlo desde Syspanel en la sección de Backup.

[WARNING] No todos los módulos son compatibles con todas las versiones de PrestaShop. Revisa los requisitos del módulo antes de comprarlo o descargarlo.

Paso 1: Acceder a Syspanel y localizar el gestor de archivos

El primer paso para instalar módulos PrestaShop desde Syspanel es acceder al panel. Sigue estos pasos:

Abre tu navegador y escribe la URL de tu Syspanel: https://tudominio.com:2106 (reemplaza "tudominio.com" por tu dominio real).
Inicia sesión con tu usuario y contraseña de administrador.
Una vez dentro, busca la sección "Archivos" o "Gestor de archivos". En la mayoría de las versiones de Syspanel, está en el menú lateral izquierdo.
Haz clic en esa opción. Se abrirá una ventana con la estructura de carpetas de tu servidor.

[TIP] Si no ves la opción de archivos, puede que esté dentro de un submenú llamado "Avanzado" o "Herramientas". Explora las opciones del panel.

Paso 2: Navegar hasta la carpeta de módulos de PrestaShop

PrestaShop almacena sus módulos en una carpeta específica dentro de la instalación. Para encontrarla:

En el gestor de archivos de Syspanel, busca la carpeta raíz de tu tienda. Normalmente se llama public_html o www, y dentro de ella está todo el contenido de tu PrestaShop.
Dentro de esa carpeta, localiza la subcarpeta llamada modules. Es una de las carpetas principales de PrestaShop.
Haz clic en modules para abrirla. Verás una lista de todas las carpetas de módulos que ya tienes instalados.

[INFO] Si no encuentras la carpeta modules, es posible que tu PrestaShop esté instalado en una subcarpeta (por ejemplo, public_html/tienda). En ese caso, navega hasta allí primero.

Paso 3: Subir el archivo ZIP del módulo

Ahora que estás dentro de la carpeta modules, es momento de subir el módulo que descargaste. Hay dos formas de hacerlo:

Opción A: Subir directamente desde el gestor de archivos de Syspanel

En la parte superior del gestor de archivos, busca el botón "Subir" o "Upload".
Haz clic y selecciona el archivo .zip de tu módulo desde tu computadora.
Espera a que termine la subida. Verás el archivo .zip aparecer en la lista de archivos dentro de la carpeta modules.

Opción B: Subir vía FTP (si prefieres usar FileZilla)

Abre FileZilla y conéctate a tu servidor usando los datos de FTP que te proporcionó tu hosting (puedes encontrarlos en Syspanel, en la sección "Cuentas FTP").
Navega a la carpeta modules de tu PrestaShop.
Arrastra el archivo .zip desde tu computadora a la carpeta remota.

[TIP] La opción A es más rápida y no requiere configurar FTP. Recomiendo usarla para principiantes.

Paso 4: Descomprimir el módulo

Una vez subido el archivo .zip, debes descomprimirlo para que PrestaShop pueda reconocerlo. Sigue estos pasos:

En el gestor de archivos de Syspanel, localiza el archivo .zip que acabas de subir.
Haz clic derecho sobre él y selecciona la opción "Extraer" o "Unzip".
Se creará una nueva carpeta con el nombre del módulo (por ejemplo, micromodulo). Asegúrate de que la carpeta se haya creado dentro de modules.
Una vez extraído, puedes eliminar el archivo .zip para mantener ordenado. Haz clic derecho sobre él y elige "Eliminar".

[WARNING] No descomprimas el módulo fuera de la carpeta modules. Si lo haces, PrestaShop no podrá encontrarlo.

Paso 5: Instalar el módulo desde el back office de PrestaShop

Ahora que el módulo está en la carpeta correcta, debes instalarlo desde el panel de administración de tu tienda:

Accede a tu back office de PrestaShop (normalmente en tudominio.com/admin).
Ve al menú "Módulos" > "Gestor de módulos".
En la parte superior, busca el botón "Subir un módulo" (a veces es un icono de flecha hacia arriba). Haz clic.
Se abrirá un cuadro de diálogo. No selecciones ningún archivo aquí, ya que el módulo ya está subido. Simplemente cierra esa ventana.
Ahora, en la lista de módulos, busca el nombre del módulo que acabas de subir. Puedes usar el buscador.
Cuando lo encuentres, verás un botón "Instalar". Haz clic y espera a que termine el proceso.
Una vez instalado, puedes configurarlo según las instrucciones del desarrollador.

[INFO] Si el módulo no aparece, puede que necesites recargar la página o limpiar la caché de PrestaShop (ve a "Parámetros de la tienda" > "Rendimiento" y haz clic en "Limpiar caché").

Paso 6: Verificar que el módulo funciona correctamente

Después de la instalación, es importante comprobar que todo está bien:

Ve al front office de tu tienda (la parte pública) y revisa que el módulo se muestre correctamente (por ejemplo, un nuevo bloque en la página de inicio o una nueva opción en el checkout).
Si el módulo tiene configuración, accede a ella desde el back office (normalmente en "Módulos" > "Módulos instalados" y haz clic en "Configurar").
Realiza una prueba rápida, como simular una compra o enviar un formulario, para asegurarte de que no hay errores.

[TIP] Si ves errores o el módulo no funciona, revisa los logs de errores de PrestaShop (en "Parámetros avanzados" > "Logs") o consulta la documentación del módulo.

Solución de problemas comunes al instalar módulos PrestaShop desde Syspanel

A veces las cosas no salen a la primera. Aquí tienes los problemas más frecuentes y cómo solucionarlos:

El módulo no aparece en el back office

Causa: El archivo ZIP no se descomprimió correctamente o está en la carpeta equivocada.
Solución: Verifica que la carpeta del módulo esté dentro de modules y que contenga un archivo index.php o config.xml. Si no, vuelve a descomprimir.

Error "No se puede instalar el módulo"

Causa: Incompatibilidad de versiones o falta de permisos en archivos.
Solución: Comprueba que el módulo sea compatible con tu versión de PrestaShop. También puedes dar permisos 755 a la carpeta del módulo desde Syspanel (clic derecho > "Permisos").

La tienda se vuelve lenta o da error 500

Causa: Conflicto con otros módulos o mala configuración.
Solución: Desactiva el módulo desde el back office y contacta al desarrollador. También puedes eliminar la carpeta del módulo desde Syspanel si es necesario.

[WARNING] Si eliminas una carpeta de módulo, asegúrate de que no esté activo en PrestaShop. De lo contrario, podrías dañar la tienda.

Preguntas frecuentes (FAQ) sobre la gestión de módulos PrestaShop

¿Puedo instalar módulos PrestaShop sin usar Syspanel?

Sí, también puedes hacerlo desde el back office de PrestaShop subiendo el archivo ZIP directamente. Sin embargo, Syspanel te da más control si el módulo requiere modificar archivos del servidor.

¿Qué hago si no tengo acceso a Syspanel?

Pide las credenciales a tu proveedor de hosting. Normalmente, el acceso es https://tudominio.com:2106. Si no, contacta con soporte.

¿Los módulos gratuitos se instalan igual?

Sí, el proceso es idéntico. Solo asegúrate de descargarlos de fuentes confiables para evitar malware.

¿Puedo instalar varios módulos a la vez?

Técnicamente sí, pero es mejor instalar uno por uno para identificar problemas fácilmente.

¿Cómo desinstalo un módulo desde Syspanel?

Ve a la carpeta modules en el gestor de archivos, localiza la carpeta del módulo y elimínala. Luego, desde el back office de PrestaShop, ve a "Módulos" > "Módulos instalados" y haz clic en "Desinstalar" (si aún aparece).

Conclusión: Domina la instalación de módulos en PrestaShop con Syspanel

Ahora ya sabes cómo instalar módulos PrestaShop desde Syspanel de forma rápida y segura. Recuerda que la clave está en seguir el orden: subir el ZIP, descomprimirlo en la carpeta modules, y luego instalar desde el back office. Con esta guía, podrás ampliar las funcionalidades de tu tienda sin depender de un técnico.

Si te surge alguna duda, vuelve a este artículo o consulta la sección de FAQ. Y no olvides que Syspanel (puerto 2106) es tu aliado para la gestión módulos PrestaShop y mucho más. ¡A darle vida a tu tienda online!