Dudas comunes sobre módulos de PrestaShop en Syspanel

¿Te has encontrado con mensajes de error extraños al intentar instalar o actualizar un módulo en tu tienda PrestaShop? ¿No sabes por qué algunos plugins no aparecen en el panel de administración? No te preocupes, es una de las consultas más frecuentes que recibimos en soporte técnico. En este artículo, vamos a desglosar las dudas más comunes sobre los módulos PrestaShop Syspanel, para que puedas gestionar tu tienda sin complicaciones.

Syspanel (recuerda, siempre accedes a él a través del puerto 2106) es la herramienta que te permite administrar tu servidor. Aunque no lo veas directamente, desde ahí se gestionan los permisos de archivos, la memoria PHP y otras configuraciones que afectan directamente a cómo se comportan los módulos de PrestaShop.

Vamos a resolver paso a paso las preguntas que más nos llegan.

¿Por qué no puedo instalar módulos PrestaShop desde Syspanel?

Este es, sin duda, el dolor de cabeza número uno. Intentas subir un módulo comprimido en .zip, pero PrestaShop no reacciona o te da un error. Las causas suelen ser tres:

1. Límite de memoria PHP insuficiente

PrestaShop necesita un mínimo de memoria para procesar la instalación de módulos. Si tu límite es muy bajo (por ejemplo, 32M o 64M), la instalación fallará silenciosamente.

[INFO] Para comprobarlo, ve a Syspanel > Ajustes de PHP (o PHP Settings) y busca el valor memory_limit. Debe ser al menos 128M, aunque recomendamos 256M o más para tiendas con varios módulos.

2. Permisos de archivos incorrectos

Los módulos se instalan en la carpeta /modules de tu PrestaShop. Si los permisos de esa carpeta no permiten escritura, el sistema no podrá descomprimir ni copiar los archivos.

Para solucionarlo desde Syspanel:

• Accede al Administrador de archivos (File Manager).
• Navega hasta la carpeta raíz de tu tienda (normalmente public_html o www).
• Busca la carpeta modules.
• Haz clic derecho > Permisos (o Properties) y establece 755 para carpetas y 644 para archivos. Si ves algún error de "escritura", prueba con 775 temporalmente.

3. El módulo no es compatible con tu versión de PrestaShop

A veces el problema no es técnico, sino de compatibilidad. Verifica en la descripción del módulo que sea compatible con tu versión (1.6, 1.7, 8.x, etc.). Si instalas un módulo de la versión 1.6 en una 1.7, lo más probable es que no funcione.

[WARNING] No fuerces la instalación de módulos incompatibles. Pueden romper el front-end o generar errores en la base de datos.

¿Cómo instalar módulos PrestaShop manualmente desde Syspanel?

Si la instalación automática desde el back office falla, siempre puedes hacerlo de forma manual. Es más seguro y te da control total.

Sigue estos pasos:

1. Descarga el módulo desde la fuente oficial (Addons de PrestaShop o desarrollador de confianza). Normalmente viene en un archivo .zip.
2. Descomprime el .zip en tu ordenador. Verás una carpeta con el nombre del módulo (ej: ps_googleanalytics).
3. Accede a Syspanel a través del puerto 2106 (ej: tudominio.com:2106).
4. Ve al Administrador de archivos y navega hasta la carpeta modules de tu tienda.
5. Sube la carpeta del módulo completa (no el .zip, sino la carpeta ya descomprimida) usando la opción "Subir" (Upload). Si tu Syspanel tiene función de arrastrar y soltar, úsala.
6. Verifica los permisos: una vez subida la carpeta, asegúrate de que tenga permisos 755.
7. Ve al back office de PrestaShop > Módulos > Catálogo de módulos. Busca el módulo recién subido (debería aparecer) y haz clic en "Instalar".

[TIP] Si el módulo no aparece, limpia la caché de PrestaShop desde: Configuración avanzada > Rendimiento > Limpiar caché.

Dudas frecuentes sobre la gestión de módulos en Syspanel

¿Puedo desinstalar un módulo desde Syspanel?

No directamente. La desinstalación de módulos se hace desde el back office de PrestaShop. Syspanel solo se usa para eliminar los archivos del módulo si quedan restos después de desinstalarlo.

Proceso recomendado:

1. Desinstala el módulo desde PrestaShop (Módulos > Gestor de módulos > Desinstalar).
2. Luego, desde Syspanel, elimina la carpeta del módulo en /modules para limpiar archivos residuales.

¿Cómo actualizar un módulo PrestaShop usando Syspanel?

Actualizar módulos es delicado. Si lo haces mal, puedes perder configuraciones. Sigue este orden:

1. Haz una copia de seguridad de tu tienda (base de datos y archivos). Syspanel suele tener una herramienta de backups.
2. Desinstala el módulo antiguo desde PrestaShop (esto no borra los datos si el módulo está bien programado, pero siempre es mejor prevenir).
3. Elimina la carpeta del módulo antiguo desde Syspanel (en /modules).
4. Sube la nueva versión siguiendo los pasos de instalación manual que vimos antes.
5. Instala el módulo nuevo desde el back office.

[WARNING] Algunos módulos guardan configuraciones en la base de datos. Si desinstalas y reinstalas, podrías perderlas. Consulta la documentación del módulo antes de hacerlo.

¿Por qué un módulo no aparece en el listado de Syspanel?

Syspanel no es un gestor de módulos de PrestaShop. No esperes ver una lista de tus plugins ahí. Syspanel gestiona el servidor, no la aplicación. Los módulos se ven y gestionan exclusivamente desde el back office de PrestaShop.

Excepción: Si usas un módulo que necesita configuración de servidor (como un módulo de caché o de seguridad), algunas opciones pueden aparecer en Syspanel, pero es raro.

Problemas comunes después de instalar un módulo

Error 500 o pantalla en blanco

Esto suele ocurrir por un conflicto de PHP o por un módulo mal codificado.

Soluciones desde Syspanel:

• Aumenta la memoria PHP como vimos antes.
• Activa el modo debug de PrestaShop desde el archivo /config/defines.inc.php. Busca _PS_MODE_DEV_ y cámbialo a true. Así verás el error exacto.
• Revisa los logs de error del servidor. En Syspanel, busca "Logs" o "Error Logs". Allí aparecerá el motivo del error 500.

El módulo se desactiva solo

Esto puede deberse a que el módulo requiere una extensión de PHP que no está activada (por ejemplo, curl, gd, mbstring).

Desde Syspanel:

1. Ve a Ajustes de PHP (PHP Settings).
2. Busca la lista de extensiones y activa las que falten (suele haber un checkbox o un botón "Enable").
3. Guarda los cambios y reinicia el servicio PHP si es necesario (algunos Syspanel lo hacen automáticamente).

No se guardan los cambios en la configuración del módulo

Esto suele ser un problema de permisos en la carpeta config o en el archivo de configuración del módulo.

Desde el Administrador de archivos de Syspanel:

• Ve a la carpeta del módulo (dentro de /modules).
• Busca archivos como config.xml o settings.php.
• Asegúrate de que tengan permisos 644 (o 664 si el usuario del servidor lo requiere).

Preguntas rápidas (FAQ exprés)

¿Puedo instalar módulos desde el mercado de PrestaShop directamente en Syspanel?

No. El mercado de PrestaShop (Addons) se integra con el back office, no con Syspanel. Descarga el módulo desde Addons y luego instálalo manualmente desde Syspanel si el método automático falla.

¿Syspanel me avisa si un módulo tiene una actualización?

No. Las actualizaciones se gestionan desde el back office de PrestaShop (en la sección de módulos). Syspanel no tiene conexión con los repositorios de módulos.

¿Es seguro modificar archivos de módulos desde Syspanel?

Sí, pero con cuidado. Si editas archivos PHP de un módulo directamente desde el editor de Syspanel, cualquier actualización futura del módulo sobrescribirá tus cambios. Es mejor usar un módulo hijo o un override.

[TIP] Siempre que edites un archivo de módulo, guarda una copia de seguridad del original.

Consejos finales para evitar problemas con módulos en Syspanel

1. Mantén PrestaShop actualizado: Las versiones antiguas tienen conflictos con módulos modernos.
2. Usa módulos de fuentes confiables: Los módulos gratuitos de foros o repositorios no oficiales pueden contener malware o ser incompatibles.
3. No sobrecargues de módulos: Cada módulo consume recursos. Si tu tienda va lenta, revisa cuáles tienes activos.
4. Prueba en un entorno de desarrollo: Si puedes, clona tu tienda en un subdominio y prueba los módulos allí antes de instalarlos en producción.
5. Revisa los logs de Syspanel: Ante cualquier error extraño, mira los logs del servidor. Allí suele estar la respuesta.

Esperamos que este artículo haya aclarado tus dudas sobre los módulos PrestaShop Syspanel. Recuerda que Syspanel es tu aliado para la parte del servidor, pero la magia de los módulos ocurre dentro de PrestaShop. Si tienes más preguntas, no dudes en contactar a nuestro equipo de soporte. ¡Estamos aquí para ayudarte a que tu tienda funcione perfectamente!