Instalar módulos PrestaShop con Syspanel | FAQ y consejos

¿Por qué es importante instalar bien los módulos en PrestaShop?

Instalar módulos en PrestaShop es una de las tareas más comunes para cualquier tienda online. Los módulos PrestaShop añaden funcionalidades como pasarelas de pago, envíos, SEO, marketing o personalización del diseño. Sin embargo, una instalación incorrecta puede provocar errores en la tienda, problemas de rendimiento o incluso vulnerabilidades de seguridad.

En este FAQ, resolveremos las preguntas más frecuentes sobre la instalación de módulos en PrestaShop utilizando Syspanel, el panel de control que usamos para gestionar tu hosting. Syspanel (basado en HestiaCP) te permite acceder a tu servidor a través del puerto 2106, facilitando tareas como la subida de archivos, la gestión de bases de datos y la configuración del servidor.

1. Preguntas generales sobre módulos PrestaShop y Syspanel

¿Qué es un módulo en PrestaShop?

Un módulo es un paquete de software que extiende las funcionalidades de PrestaShop. Puede ser gratuito o de pago, y se instala directamente desde el backoffice de tu tienda o mediante la subida de archivos al servidor.

¿Qué es Syspanel y cómo accedo?

Syspanel es el panel de control de tu hosting que te permite gestionar archivos, bases de datos, dominios y más. Para acceder, abre tu navegador y escribe https://tudominio.com:2106. Recuerda que el puerto 2106 es específico de Syspanel (basado en HestiaCP). Allí encontrarás herramientas como el gestor de archivos, el administrador de bases de datos y logs del servidor.

¿Necesito conocimientos técnicos para instalar módulos?

No necesitas ser un experto, pero sí es útil conocer lo básico: cómo acceder a tu backoffice de PrestaShop, cómo subir archivos a través de Syspanel y cómo verificar que los permisos de carpetas sean correctos. Este FAQ te guiará paso a paso.

2. Preguntas frecuentes sobre la instalación de módulos

¿Cómo instalo un módulo desde el backoffice de PrestaShop?

La forma más sencilla es desde el panel de administración de tu tienda:

Inicia sesión en tu backoffice de PrestaShop (normalmente tudominio.com/admin).
Ve al menú Módulos y luego Módulos y servicios.
Haz clic en Subir un módulo (arriba a la derecha).
Selecciona el archivo .zip del módulo desde tu ordenador.
PrestaShop lo descomprimirá e instalará automáticamente.
Una vez instalado, busca el módulo en la lista y haz clic en Configurar para ajustar sus opciones.

[TIP] Si el módulo no aparece, verifica que el archivo .zip no esté dañado y que sea compatible con tu versión de PrestaShop.

¿Qué hago si la instalación desde el backoffice falla?

Puede fallar por límites de tamaño de archivo, permisos incorrectos o errores de PHP. Si ocurre, prueba a instalarlo manualmente a través de Syspanel:

Accede a Syspanel en https://tudominio.com:2106 con tus credenciales.
Ve a Archivos y navega hasta la carpeta public_html (o la raíz de tu tienda).
Busca la carpeta modules y ábrela.
Sube el archivo .zip del módulo a esa carpeta (usa el botón Subir).
Una vez subido, selecciona el archivo y haz clic en Extraer (o Descomprimir).
Confirma la extracción y luego ve al backoffice de PrestaShop. El módulo debería aparecer en la lista de módulos. Si no, refresca la página y busca en Módulos > Módulos y servicios.

[WARNING] Nunca subas módulos directamente sin extraerlos. Asegúrate de que el nombre de la carpeta del módulo coincida con el nombre del módulo en PrestaShop.

¿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 o en la documentación del desarrollador. Normalmente indican las versiones compatibles. También puedes verificar en el backoffice: ve a Módulos > Módulos y servicios y busca el módulo. Si aparece con un mensaje de advertencia (ej. "No compatible con tu versión"), no lo instales. Forzar la instalación puede romper tu tienda.

¿Qué permisos deben tener las carpetas de módulos?

Los módulos necesitan permisos de escritura para funcionar correctamente, especialmente para guardar configuraciones o subir archivos. En Syspanel, puedes ajustar permisos desde el gestor de archivos:

Ve a la carpeta modules dentro de public_html.
Selecciona la carpeta del módulo que instalaste.
Haz clic en Permisos y establece 755 para carpetas y 644 para archivos.
Si el módulo requiere permisos más abiertos (ej. 777 para subir imágenes), el desarrollador lo indicará. Usa 777 solo si es estrictamente necesario, ya que es menos seguro.

[INFO] Los permisos 755 permiten lectura y ejecución para todos, y escritura para el propietario. Es el estándar para la mayoría de módulos.

¿Puedo instalar un módulo desde un archivo .zip que no sea oficial?

Sí, pero con precaución. Los módulos de fuentes no oficiales pueden contener malware o ser incompatibles. Siempre verifica la reputación del desarrollador y, si es posible, escanea el archivo con un antivirus antes de subirlo. En Syspanel, puedes subir el .zip de la misma forma que con módulos oficiales.

¿Qué hago si el módulo no aparece en la lista después de instalarlo?

Esto puede deberse a:

Error en la extracción: Vuelve a extraer el .zip desde Syspanel y asegúrate de que la carpeta del módulo tenga el nombre correcto (sin espacios ni caracteres extraños).
Caché de PrestaShop: Ve a Parámetros avanzados > Rendimiento y limpia la caché. También puedes forzar la compilación de plantillas.
Permisos incorrectos: Ajusta los permisos como se explicó antes.
Módulo desactivado: En el backoffice, ve a Módulos > Módulos y servicios y usa el buscador. Si aparece pero en gris, actívalo.

¿Cómo desinstalo un módulo correctamente?

Para eliminar un módulo sin dejar rastros:

En el backoffice, ve a Módulos > Módulos y servicios.
Busca el módulo y haz clic en Desinstalar (no solo desactivar).
Luego, haz clic en Eliminar para borrar sus archivos.
Opcionalmente, desde Syspanel, ve a la carpeta modules y elimina la carpeta del módulo manualmente. También puedes borrar tablas de la base de datos si el módulo las creó (consulta la documentación).

[WARNING] No elimines la carpeta del módulo sin antes desinstalarlo desde el backoffice, o podrías dejar datos huérfanos en la base de datos.

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

Sí, especialmente si están mal optimizados. Para minimizar el impacto:

Instala solo los módulos que necesites.
Revisa las valoraciones y actualizaciones del módulo.
Usa herramientas de caché como PrestaShop Cache o módulos de optimización.
Si notas lentitud, desactiva módulos uno por uno para identificar al culpable.

¿Puedo instalar módulos en una tienda multitienda?

Sí, PrestaShop permite instalar módulos en una o varias tiendas de tu red. Durante la instalación, elige la opción adecuada. Si el módulo no lo soporta, puede que solo funcione en la tienda principal. Consulta la documentación del módulo.

3. Preguntas sobre Syspanel y la gestión de archivos

¿Cómo subo un módulo grande si el backoffice me da error por tamaño?

El backoffice de PrestaShop tiene un límite de subida (generalmente 2 MB o 8 MB). Si tu módulo supera ese tamaño, usa Syspanel:

Accede a Syspanel en https://tudominio.com:2106.
Ve a Archivos y navega a public_html/modules.
Sube el archivo .zip directamente (Syspanel no tiene límite de tamaño).
Extrae el archivo y luego activa el módulo desde el backoffice.

[TIP] Si el módulo es muy grande, también puedes subirlo por FTP usando un cliente como FileZilla, pero Syspanel es más rápido y no requiere software adicional.

¿Cómo verifico que los archivos del módulo se hayan subido correctamente?

En Syspanel, después de extraer el .zip, revisa que la carpeta del módulo contenga los archivos esperados (ej. index.php, config.xml, etc.). También puedes comparar el tamaño de la carpeta con el del .zip original. Si falta algún archivo, repite la extracción.

¿Qué hago si el módulo requiere una base de datos adicional?

Algunos módulos crean tablas en la base de datos de PrestaShop. Si el módulo no las crea automáticamente, puedes ejecutar el script SQL desde Syspanel:

Ve a Bases de datos en Syspanel.
Selecciona la base de datos de tu tienda.
Haz clic en phpMyAdmin y luego en la pestaña SQL.
Pega las consultas SQL proporcionadas por el desarrollador del módulo y ejecútalas.

[INFO] Siempre haz una copia de seguridad de tu base de datos antes de ejecutar consultas manuales.

¿Puedo instalar un módulo desde un repositorio de Git (GitHub, GitLab)?

Sí, pero requiere más pasos. Descarga el repositorio como .zip desde la interfaz web de Git, luego súbelo a la carpeta modules en Syspanel y extráelo. Alternativamente, si tienes acceso SSH, puedes clonar el repositorio directamente, pero eso es más avanzado.

4. Consejos finales y solución de problemas comunes

Mi módulo no funciona después de la instalación, ¿qué reviso?

Compatibilidad: Asegúrate de que el módulo sea para tu versión de PrestaShop.
Permisos: Verifica que la carpeta del módulo tenga permisos 755 y los archivos 644.
Logs de errores: En Syspanel, ve a Logs y busca errores de PHP. También puedes activar el modo depuración en PrestaShop (config/defines.inc.php, cambia _PS_MODE_DEV_ a true).
Conflictos: Desactiva otros módulos para ver si hay conflicto.
Actualizaciones: Revisa si el módulo tiene una versión más reciente.

¿Cómo hago una copia de seguridad antes de instalar un módulo?

Siempre es recomendable. Desde Syspanel:

Archivos: Ve a Archivos y comprime toda la carpeta public_html en un .zip, luego descárgalo.
Base de datos: Ve a Bases de datos, selecciona tu base de datos y haz clic en phpMyAdmin. Luego exporta la base de datos en formato SQL.

[WARNING] No instales módulos en una tienda en producción sin hacer copia de seguridad. Un módulo defectuoso puede dañar tu negocio.

¿Puedo instalar módulos desde el marketplace de PrestaShop?

Sí, es la forma más segura. Desde tu backoffice, ve a Módulos > Módulos y servicios y busca en el marketplace integrado. La instalación es automática. Si falla, descarga el .zip desde el marketplace y súbelo manualmente como se explicó.

¿Qué hago si el módulo me pide una clave de licencia?

Los módulos de pago suelen requerir una clave que obtienes al comprarlos. Ingresa la clave en la configuración del módulo después de instalarlo. Si no la tienes, contacta al desarrollador.

Conclusión

Instalar módulos PrestaShop con Syspanel es un proceso sencillo si sigues los pasos correctos. Recuerda siempre verificar la compatibilidad, hacer copias de seguridad y usar permisos adecuados. Si encuentras problemas, revisa los logs y no dudes en consultar la documentación del módulo o contactar a soporte técnico.

Con este FAQ, esperamos haberte ayudado a resolver las dudas más comunes. ¡Ahora ya puedes personalizar tu tienda con total confianza!