Guía para instalar módulos PrestaShop manualmente en Syspanel

¿Necesitas instalar un módulo de PrestaShop y el método automático desde el backoffice no funciona? No te preocupes, es algo común. Muchas veces, por límites de servidor, permisos o simplemente porque el módulo viene en un archivo comprimido, la instalación manual es la solución más segura y rápida.

En este artículo te voy a guiar paso a paso para que puedas instalar cualquier módulo PrestaShop Syspanel de forma manual. Usaremos el panel de control Syspanel (antes conocido como HestiaCP, y que se accede por el puerto 2106) para subir los archivos directamente al servidor.

Vamos a desglosar todo el proceso de forma sencilla, para que incluso si no tienes experiencia técnica, puedas hacerlo sin problemas.

¿Qué es la instalación manual de un módulo en PrestaShop?

Cuando hablamos de instalar módulo manual PrestaShop, nos referimos a copiar los archivos del módulo directamente en la carpeta correspondiente de tu tienda, en lugar de usar el instalador automático del backoffice.

Esto es útil cuando:

El módulo es demasiado grande para el cargador web.
Tu servidor tiene límites de tiempo de ejecución.
El módulo requiere permisos especiales.
Simplemente prefieres tener control total sobre el proceso.

El proceso se divide en dos partes:

Subir el módulo al servidor a través de Syspanel.
Instalarlo desde el backoffice de PrestaShop.

Requisitos previos

Antes de empezar, asegúrate de tener lo siguiente:

Acceso a Syspanel: Ve a https://tudominio.com:2106 (ese es el puerto de acceso). Necesitarás tu usuario y contraseña de hosting.
Archivo del módulo: Debe estar en formato .zip o .tar.gz. Si viene en otro formato, descomprímelo primero en tu PC.
Datos de FTP (opcional): Aunque usaremos el gestor de archivos de Syspanel, también puedes usar FTP. Aquí nos centraremos en Syspanel.
Backup: Siempre es buena idea hacer una copia de seguridad de tu tienda antes de modificar archivos.

[WARNING] No descomprimas el módulo en tu PC. Lo subiremos comprimido al servidor y lo descomprimiremos allí. Esto evita problemas de permisos y rutas.

Paso 1: Accede a Syspanel y localiza la carpeta de módulos

Abre tu navegador y escribe https://tudominio.com:2106.
Inicia sesión con tus credenciales de Syspanel.
Una vez dentro, busca la sección "Gestor de archivos" o "File Manager". Normalmente está en el menú lateral o en la parte superior.
Navega hasta la carpeta raíz de tu tienda PrestaShop. Normalmente es algo como /home/usuario/web/tudominio/public_html/ o /var/www/tudominio/.
Dentro de esa carpeta, busca la subcarpeta /modules. Esa es la carpeta donde se alojan todos los módulos de PrestaShop.

[INFO] La ruta exacta puede variar según la configuración de tu hosting, pero siempre será dentro del directorio público donde está instalado PrestaShop.

Paso 2: Sube el archivo comprimido del módulo

En el gestor de archivos de Syspanel, haz clic en el botón "Subir" (normalmente un icono de flecha hacia arriba o el texto "Upload").
Selecciona el archivo .zip o .tar.gz de tu módulo desde tu computadora.
Espera a que la subida termine. Dependiendo del tamaño, puede tardar unos segundos o minutos.
Una vez subido, verás el archivo en la lista dentro de la carpeta /modules.

[TIP] Si el módulo es muy pesado (más de 50 MB), considera usar FTP o preguntar a tu proveedor de hosting si hay límites de subida.

Paso 3: Descomprime el módulo en el servidor

Ahora que el archivo está en la carpeta /modules, debemos extraerlo.

En el gestor de archivos, haz clic derecho sobre el archivo .zip que acabas de subir.
Selecciona la opción "Extraer" o "Descomprimir" (en inglés suele ser "Extract").
Se abrirá una ventana preguntando dónde extraer. Asegúrate de que la ruta sea la misma carpeta /modules (no crees una subcarpeta adicional).
Haz clic en "Extraer" o "Aceptar".
El sistema descomprimirá el archivo y creará una nueva carpeta con el nombre del módulo (por ejemplo, micromodulo).

[WARNING] No extraigas el archivo en una subcarpeta como /modules/mimodulo.zip/. Debe quedar directamente en /modules/nombredelmodulo/. Si ves que se crea una carpeta doble (ej. /modules/mimodulo/mimodulo/), significa que el zip tenía una carpeta interna. En ese caso, mueve los archivos manualmente.

Una vez extraído, puedes eliminar el archivo .zip original para mantener limpia la carpeta (opcional, pero recomendado).

Paso 4: Verifica la estructura del módulo

Después de descomprimir, es importante comprobar que el módulo está bien ubicado.

Dentro de la carpeta /modules, busca la carpeta con el nombre de tu módulo (por ejemplo, ps_googleanalytics).
Ábrela y revisa que contenga al menos:
- Un archivo principal con el mismo nombre de la carpeta y extensión .php (ej. ps_googleanalytics.php).
- Una carpeta views/ (opcional, pero común).
- Archivos de configuración como config.xml o logo.png.
Si ves que dentro hay otra carpeta con el mismo nombre, significa que el módulo está anidado. En ese caso, mueve todo el contenido de la subcarpeta interna a la carpeta principal y elimina la subcarpeta vacía.

[INFO] La estructura correcta es: /modules/nombremodulo/nombremodulo.php. Si no es así, PrestaShop no lo reconocerá.

Paso 5: Instala el módulo desde el backoffice de PrestaShop

Ahora que los archivos están en su lugar, vamos a activar el módulo desde la administración de tu tienda.

Accede al backoffice de PrestaShop (normalmente tudominio.com/adminXXXXXX).
Ve al menú "Módulos" > "Gestor de módulos".
En la parte superior, haz clic en el botón "Subir un módulo" (si lo ves) o simplemente busca en la lista de módulos instalables.
Si el módulo no aparece automáticamente, escribe su nombre en el buscador de la derecha.
Una vez lo encuentres, haz clic en el botón "Instalar".
PrestaShop te pedirá confirmación. Acepta y espera a que termine la instalación.
Si todo va bien, verás un mensaje de éxito y el módulo aparecerá en la lista de módulos instalados.

[TIP] Si el módulo no aparece, refresca la página del gestor de módulos (F5) o cierra sesión y vuelve a entrar. A veces la caché tarda en actualizarse.

Solución de problemas comunes (FAQ)

Aquí tienes las dudas más frecuentes que resuelven a quienes buscan Syspanel PrestaShop módulos e instalar módulo manual PrestaShop.

¿Por qué no veo el módulo en el backoffice después de subirlo?

Causa: La carpeta del módulo no tiene el nombre correcto o está mal ubicada.
Solución: Revisa que la carpeta esté directamente en /modules/ y que el archivo PHP principal tenga el mismo nombre que la carpeta. Por ejemplo, si la carpeta es micodigo, el archivo debe ser micodigo.php.

El módulo se instaló pero da error 500 o página en blanco

Causa: Puede ser un conflicto de versiones o falta de permisos.
Solución: Verifica que el módulo sea compatible con tu versión de PrestaShop. También revisa los permisos de la carpeta del módulo: deben ser 755 para carpetas y 644 para archivos. Puedes cambiarlos desde el gestor de archivos de Syspanel.

No tengo acceso a Syspanel, ¿puedo usar FTP?

Respuesta: Sí, perfectamente. El proceso es el mismo: conecta con FTP, ve a la carpeta /modules, sube el zip, descomprímelo (algunos clientes FTP permiten descomprimir directamente) y luego instala desde el backoffice.

El módulo se instaló pero no funciona correctamente

Causa: Puede que necesite una configuración adicional o dependencias.
Solución: Lee la documentación del módulo. A veces hay que configurar claves API o ajustar opciones en el backoffice. También verifica que los requisitos del servidor (PHP, memoria, etc.) sean los adecuados.

¿Puedo instalar varios módulos a la vez?

Respuesta: Sí, pero es mejor hacerlo de uno en uno para evitar confusiones. Sube y descomprime cada módulo por separado en la carpeta /modules.

¿Qué hago si el módulo no se descomprime en Syspanel?

Causa: El archivo puede estar dañado o el gestor de archivos tiene límites de tamaño.
Solución: Prueba a descomprimirlo en tu PC y luego sube la carpeta completa (sin comprimir) mediante FTP. Asegúrate de que la carpeta tenga los permisos correctos.

Consejos finales para una instalación exitosa

Siempre verifica la compatibilidad: Antes de comprar o descargar un módulo, asegúrate de que sea compatible con tu versión de PrestaShop (1.6, 1.7, 8.x, etc.).
Haz un backup: Aunque la instalación manual es segura, un backup te salvará si algo sale mal.
Usa nombres sin espacios: Tanto la carpeta del módulo como los archivos no deben contener espacios ni caracteres especiales. Si el módulo viene con espacios, renómbralo.
Limpia la caché: Después de instalar, ve a "Parámetros avanzados" > "Rendimiento" y limpia la caché. Esto evita que PrestaShop muestre versiones antiguas.

[INFO] Recuerda que Syspanel (puerto 2106) es una herramienta potente y segura para gestionar tu hosting. Si tienes dudas sobre cómo usarlo, consulta la documentación de tu proveedor o abre un ticket de soporte.

Conclusión

Instalar un módulo PrestaShop Syspanel de forma manual no es complicado cuando sigues los pasos adecuados. Solo necesitas acceso a tu panel de control, el archivo del módulo y un poco de paciencia.

La clave está en:

Subir el zip a la carpeta /modules.
Descomprimirlo correctamente.
Verificar la estructura.
Instalarlo desde el backoffice.

Con este método, tendrás control total sobre el proceso y evitarás los problemas típicos de los instaladores automáticos. Además, al usar Syspanel (puerto 2106), estás utilizando una herramienta moderna y eficiente para gestionar tu hosting.

Si te ha quedado alguna duda, repasa los pasos o consulta la sección de preguntas frecuentes. Y recuerda: siempre que modifiques archivos de tu tienda, hazlo con cuidado y, si es posible, en un entorno de pruebas primero.

¡Buena suerte con tu instalación!