Instalar módulos PrestaShop en Syspanel | Paso a paso

¿Por qué usar Syspanel para instalar módulos en PrestaShop?

Gestionar una tienda online implica mantenerla actualizada y funcional, y los módulos son el corazón de esa personalización. Si tienes un hosting con Syspanel (el panel de control que usamos, accesible por el puerto 2106), instalar módulos PrestaShop se vuelve un proceso sencillo y seguro. Syspanel te permite subir, extraer y gestionar archivos directamente en tu servidor, sin necesidad de plugins extra ni conocimientos avanzados de FTP.

Esta guía rápida te llevará paso a paso para que puedas instalar módulos, gestionar plugins y mantener tu gestión tienda al día. Vamos a ello.

Requisitos previos antes de empezar

Antes de instalar cualquier módulo, asegúrate de tener:

Acceso a tu panel Syspanel (usuario, contraseña y puerto 2106).
Tu tienda PrestaShop funcionando correctamente.
El archivo del módulo en formato .zip o .tar.gz, descargado de una fuente confiable (por ejemplo, el marketplace oficial de PrestaShop o un desarrollador de confianza).
Copia de seguridad reciente de tu tienda. Siempre es recomendable.

[INFO] Si no tienes acceso a Syspanel, contacta con tu proveedor de hosting. El puerto 2106 es el estándar para este panel.

Paso 1: Acceder a Syspanel

Abre tu navegador web y escribe la dirección de tu servidor seguida de :2106. Por ejemplo: https://tudominio.com:2106 o https://tuip:2106.
Introduce tu usuario y contraseña de Syspanel (los mismos que usas para gestionar tu hosting).
Haz clic en Iniciar sesión.

Ya estás dentro. Verás un panel con varias opciones. No te asustes, solo necesitas la sección de Archivos.

Paso 2: Localizar la carpeta de módulos de PrestaShop

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

En Syspanel, ve a Archivos > Administrador de archivos.
Navega hasta la carpeta raíz de tu tienda. Normalmente es public_html o www, o el nombre de tu dominio.
Dentro, busca la carpeta modules. Si no la ves, puede que esté dentro de prestashop o tienda. Revisa bien.
Una vez dentro de modules, verás muchas carpetas con nombres de módulos ya instalados. No borres nada aquí sin saber qué haces.

[TIP] Si tu tienda está en una subcarpeta (ejemplo: midominio.com/tienda), la ruta será /public_html/tienda/modules. Usa el administrador de archivos para navegar.

Paso 3: Subir el módulo desde Syspanel

Ahora vamos a subir el archivo del módulo que descargaste.

En la carpeta modules, haz clic en Subir (o Upload).
Selecciona el archivo .zip o .tar.gz de tu módulo desde tu computadora.
Espera a que termine la subida. Verás una barra de progreso.
Una vez subido, aparecerá el archivo en la lista de la carpeta modules.

[WARNING] No subas el módulo directamente a la raíz. Debe ir exactamente dentro de la carpeta modules para que PrestaShop lo reconozca.

Paso 4: Descomprimir el módulo

El archivo comprimido no sirve tal cual. Hay que extraerlo.

Haz clic derecho sobre el archivo .zip que acabas de subir.
Selecciona Extraer o Descomprimir.
Confirma la acción. Syspanel creará una nueva carpeta con el nombre del módulo (por ejemplo, micromodulo).
Verifica que dentro de esa carpeta haya al menos un archivo index.php y una carpeta views o controllers. Si ves eso, vas bien.
Opcional pero recomendado: elimina el archivo .zip original para mantener ordenado. Puedes seleccionarlo y hacer clic en Eliminar.

[INFO] Si el módulo no se extrae correctamente, prueba a descargarlo de nuevo. A veces los archivos se corrompen en la descarga.

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

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

Accede a tu back office de PrestaShop (normalmente tudominio.com/admin o la URL que configuraste).
Ve al menú Módulos > Gestor de módulos.
En la parte superior, haz clic en Subir un módulo (si no ves esta opción, busca en la lista de módulos).
PrestaShop escaneará automáticamente la carpeta modules y detectará el nuevo módulo.
Busca el nombre del módulo en la lista (puede aparecer como "No instalado").
Haz clic en Instalar.
Sigue las instrucciones del módulo (puede pedir configuración adicional). Algunos módulos se activan solos.

[TIP] Si el módulo no aparece, ve a Módulos > Catálogo de módulos y haz clic en Actualizar la lista de módulos. A veces PrestaShop necesita refrescar.

Paso 6: Verificar que el módulo funciona

Una vez instalado, es importante comprobar que todo está correcto.

Desde el back office, ve a la sección del módulo recién instalado (suele tener su propio menú o aparecer en Módulos > Módulos instalados).
Configúralo según las necesidades de tu tienda (por ejemplo, ajustar métodos de pago, envío, SEO, etc.).
Haz una prueba rápida desde el front office (la parte pública de tu tienda) para ver que el módulo se muestra o funciona como esperas.
Si algo falla, revisa los logs de errores en Parámetros avanzados > Información > Logs.

[WARNING] Si el módulo da error 500 o rompe la tienda, no entres en pánico. Puedes desactivarlo desde el back office o, si no accedes, elimina la carpeta del módulo desde Syspanel (en modules) y vuelve a intentarlo con una versión diferente.

Preguntas frecuentes (FAQ)

¿Puedo instalar módulos PrestaShop sin Syspanel?

Sí, usando FTP o el propio gestor de módulos del back office, pero Syspanel te da control total sobre los archivos y es más rápido para módulos grandes o problemáticos.

¿Qué hago si el módulo no aparece en el back office?

Revisa que el archivo se haya descomprimido correctamente en la carpeta modules. También verifica que el módulo sea compatible con tu versión de PrestaShop (1.6, 1.7, 8.x, etc.). Si todo está bien, limpia la caché de PrestaShop desde Parámetros avanzados > Rendimiento.

¿Es seguro instalar módulos de terceros?

Siempre descarga módulos de fuentes oficiales o desarrolladores de confianza. Los módulos piratas pueden contener malware. Syspanel te permite revisar los archivos antes de instalarlos.

¿Cómo desinstalo un módulo?

Desde el back office, ve a Módulos > Gestor de módulos, busca el módulo y haz clic en Desinstalar. Luego, desde Syspanel, puedes eliminar su carpeta en modules para liberar espacio.

¿Puedo instalar varios módulos a la vez?

Sí, repite los pasos 3 y 4 para cada módulo. Luego actívalos uno por uno desde el back office para evitar conflictos.

¿Qué hago si la tienda se cae después de instalar un módulo?

Accede a Syspanel, ve a la carpeta modules, localiza la carpeta del módulo problemático y renómbrala (por ejemplo, añadiendo _backup al final). Esto lo desactivará. Luego, desde el back office, desinstálalo correctamente.

Consejos finales para una gestión exitosa

Mantén copias de seguridad: Antes de instalar cualquier módulo, haz una copia de tu base de datos y archivos desde Syspanel (sección Copias de seguridad).
Actualiza los módulos: Revisa periódicamente si hay nuevas versiones desde el back office. Los módulos desactualizados pueden generar vulnerabilidades.
No instales módulos innecesarios: Cada módulo consume recursos. Menos es más para la velocidad de tu tienda.
Usa módulos nativos de PrestaShop: Siempre que sea posible, prefiere los módulos oficiales. Son más estables y seguros.

Con Syspanel, instalar módulos PrestaShop es pan comido. Ahora ya sabes cómo subir, descomprimir y activar cualquier plugin en tu tienda. Si tienes dudas, recuerda que el puerto 2106 es tu puerta de entrada al control total de tu hosting. ¡A darle vida a tu tienda online!

¿Te ha sido útil esta guía? Compártela con otros comerciantes que estén empezando. Y si tienes algún problema, no dudes en contactar con nuestro soporte técnico.