Instalar módulo en PrestaShop manualmente: Guía para principiantes

Introducción: ¿Por qué instalar un módulo manualmente en PrestaShop?

PrestaShop es una de las plataformas de comercio electrónico más populares y flexibles. Una de sus grandes ventajas es la posibilidad de ampliar sus funcionalidades mediante módulos. Aunque la forma más común de instalar un módulo es desde el propio backoffice de PrestaShop (a través del conector con Addons o subiendo un archivo ZIP), en ocasiones te encontrarás con situaciones donde la instalación automática falla: el archivo es demasiado grande, el servidor tiene límites de subida, o simplemente necesitas instalar un módulo personalizado o de terceros que no está disponible en el marketplace.

En este artículo te explicaré paso a paso cómo realizar una instalación manual de un módulo en PrestaShop. Este método es especialmente útil si gestionas tu propio servidor o tienes acceso a un panel de administración como Syspanel. No necesitas ser un experto en Linux, solo seguir las instrucciones con atención.

[INFO] Este tutorial está pensado para usuarios con acceso al sistema de archivos de su tienda, ya sea mediante FTP, cPanel, o un panel como Syspanel. Si no tienes experiencia manejando archivos del servidor, te recomiendo pedir ayuda a tu proveedor de hosting o a un técnico.

Requisitos previos antes de instalar un módulo manualmente

Antes de lanzarte a subir archivos, asegúrate de cumplir con estos requisitos básicos:

Acceso al servidor: Necesitas poder conectarte al servidor donde está alojada tu tienda PrestaShop. Esto puede ser mediante FTP (FileZilla, por ejemplo), un administrador de archivos en tu panel de hosting, o una terminal SSH si tienes experiencia.
Conocimiento de la estructura de PrestaShop: Los módulos se instalan en la carpeta /modules dentro del directorio raíz de tu tienda.
El módulo en formato ZIP o carpeta descomprimida: Asegúrate de tener el archivo del módulo listo. Si es un ZIP, deberás descomprimirlo antes de subirlo manualmente.
Permisos de escritura: El servidor debe permitir que subas archivos a la carpeta /modules. Normalmente, esto ya está configurado, pero si tienes dudas, verifica los permisos (755 o 775 suele ser suficiente).
Copia de seguridad: Siempre, siempre, haz una copia de seguridad de tu tienda antes de instalar cualquier módulo. Un módulo incompatible puede romper tu web.

Paso 1: Descargar y preparar el módulo

Lo primero es obtener el módulo que deseas instalar. Puede ser un módulo gratuito de GitHub, uno comprado en un sitio de terceros, o uno que hayas desarrollado tú mismo.

Cómo identificar un módulo válido

Un módulo de PrestaShop suele tener esta estructura:

Un archivo principal PHP (por ejemplo, mimodulo.php) que extiende la clase Module.
Una carpeta con el mismo nombre que el archivo principal (por ejemplo, mimodulo).
Archivos de configuración, plantillas, traducciones, etc.

Si el módulo viene en un archivo ZIP, descomprímelo en tu ordenador. No subas el ZIP directamente a la carpeta /modules, porque PrestaShop no lo procesará. Debes subir la carpeta descomprimida.

[WARNING] Asegúrate de que el nombre de la carpeta del módulo coincida exactamente con el nombre del archivo PHP principal. Por ejemplo, si el archivo se llama supermodulo.php, la carpeta debe llamarse supermodulo. De lo contrario, PrestaShop no podrá reconocerlo.

Paso 2: Acceder al servidor de tu tienda

Ahora necesitas conectar con tu servidor. Dependiendo del tipo de hosting que tengas, el método variará. Aquí te explico los dos más comunes:

Opción A: Usando un panel de administración como Syspanel

Si tu hosting utiliza Syspanel, el acceso es muy sencillo:

Abre tu navegador y ve a https://tudominio.com:2106 (recuerda, el puerto es el 2106).
Inicia sesión con tus credenciales de administrador.
Busca la sección "Administrador de archivos" o "File Manager". Normalmente está en el menú principal.
Navega hasta la carpeta donde está instalado PrestaShop. Por ejemplo, si tu tienda está en public_html/tienda, entra ahí.
Dentro, localiza la carpeta modules.

Opción B: Usando FTP

Si prefieres FTP:

Abre tu cliente FTP (FileZilla, Cyberduck, etc.).
Conéctate al servidor usando los datos que te proporcionó tu hosting (servidor, usuario, contraseña y puerto, normalmente 21).
Navega hasta el directorio raíz de tu tienda (suele ser public_html, www o htdocs).
Busca la carpeta modules.

Paso 3: Subir la carpeta del módulo a la carpeta `modules`

Una vez dentro de la carpeta modules del servidor, es hora de subir el módulo.

Sube la carpeta completa del módulo (la que descomprimiste en tu ordenador) a la carpeta modules del servidor.
- Si usas Syspanel, usa el botón "Subir" o "Upload" y selecciona la carpeta.
- Si usas FTP, arrastra la carpeta desde tu ordenador a la carpeta modules en el servidor.
Verifica que la carpeta se haya subido correctamente. Deberías ver una nueva carpeta con el nombre del módulo dentro de modules.
Comprueba los permisos de la carpeta. En la mayoría de los casos, con permisos 755 es suficiente. Si ves que el módulo no funciona después, puedes probar con 775. En Syspanel, puedes hacer clic derecho sobre la carpeta y seleccionar "Permisos" o "Chmod". En FTP, también puedes cambiar permisos desde las propiedades del archivo.

[TIP] Si el módulo incluye archivos de configuración o plantillas que necesitan ser sobrescritos (por ejemplo, en la carpeta override), asegúrate de que también se suban a las ubicaciones correctas. Algunos módulos traen instrucciones específicas.

Paso 4: Activar el módulo desde el backoffice de PrestaShop

Una vez que el módulo está en el servidor, el siguiente paso es activarlo desde el panel de administración de tu tienda.

Inicia sesión en tu backoffice de PrestaShop (normalmente en tudominio.com/admin).
Ve al menú "Módulos" y luego a "Gestor de módulos" (o "Module Manager" en versiones recientes).
Haz clic en la pestaña "Módulos" (no confundir con "Servicios" o "Catálogo de módulos").
Busca el nombre del módulo que acabas de subir. Puedes usar el buscador en la parte superior.
Si el módulo aparece en la lista, verás un botón "Instalar" o "Activar". Haz clic en él.
PrestaShop realizará la instalación automática. Dependiendo del módulo, puede que te pida configurar algunos parámetros básicos.

[INFO] Si el módulo no aparece en la lista después de subirlo, puede deberse a varias razones:

El nombre de la carpeta no coincide con el archivo PHP principal.

El módulo tiene errores de sintaxis o no es compatible con tu versión de PrestaShop.

No se han subido todos los archivos necesarios.

Los permisos de la carpeta son incorrectos.

Paso 5: Verificar que el módulo funciona correctamente

Una vez instalado y activado, es importante comprobar que todo está en orden.

Configura el módulo si es necesario. Normalmente, después de instalarlo, aparecerá un botón "Configurar" en la misma pantalla de módulos.
Prueba la funcionalidad en tu tienda. Por ejemplo, si es un módulo de pago, realiza una compra de prueba. Si es de envío, simula un carrito.
Revisa el front office (la parte pública de tu tienda) para asegurarte de que se muestra correctamente (por ejemplo, un banner, un slider, etc.).
Limpia la caché de PrestaShop. Ve a "Parámetros avanzados" > "Rendimiento" y haz clic en "Limpiar caché". Esto evita que versiones antiguas del módulo interfieran.

[WARNING] Si después de instalar el módulo tu tienda da error (pantalla blanca, errores PHP, etc.), no entres en pánico. Simplemente accede al servidor, renombra la carpeta del módulo (por ejemplo, añadiendo _old al final) y recarga la tienda. Esto desactivará el módulo y tu tienda volverá a la normalidad. Luego puedes investigar el error.

Solución de problemas comunes (FAQ)

¿Por qué no aparece mi módulo en la lista después de subirlo?

Esto suele ocurrir por:

Nombre incorrecto: La carpeta debe llamarse igual que el archivo PHP principal.
Falta de permisos: La carpeta debe tener al menos 755.
Módulo no compatible: Revisa que el módulo sea para tu versión de PrestaShop (1.6, 1.7, 8.x, etc.).
Archivos incompletos: Asegúrate de haber subido todos los archivos y subcarpetas.

¿Puedo instalar un módulo manualmente si mi hosting tiene límites de subida?

Sí, este método es ideal para módulos grandes. Al subir directamente al servidor, evitas los límites de tamaño del backoffice.

¿Es seguro instalar módulos manualmente?

Sí, siempre que el módulo provenga de una fuente confiable. Los módulos de terceros pueden contener código malicioso, así que descarga solo de sitios de confianza o verifica el código si tienes conocimientos técnicos.

¿Puedo usar este método para actualizar un módulo?

Sí, pero ten cuidado. Para actualizar, normalmente debes:

Desinstalar el módulo desde el backoffice (no eliminar la carpeta).
Subir la nueva versión de la carpeta (sobrescribiendo la anterior).
Volver a instalar el módulo desde el backoffice.

Algunos módulos permiten la actualización directa, pero es más seguro seguir este proceso.

¿Qué hago si el módulo da error después de instalarlo?

Desactívalo temporalmente: Renombra la carpeta del módulo en el servidor (por ejemplo, de mimodulo a mimodulo_desactivado).
Recarga tu tienda: Debería volver a la normalidad.
Revisa los logs de error: En el backoffice, ve a "Parámetros avanzados" > "Logs" para ver posibles errores.
Contacta al desarrollador: Si el módulo es de pago, el soporte técnico puede ayudarte.

Conclusión

Instalar un módulo manualmente en PrestaShop es un proceso sencillo una vez que conoces los pasos. Solo necesitas acceso al servidor, subir la carpeta correcta a modules y activarlo desde el backoffice. Este método te da control total sobre tu tienda y es especialmente útil cuando los métodos automáticos fallan.

Recuerda siempre hacer una copia de seguridad antes de cualquier instalación, y no dudes en pedir ayuda si algo sale mal. Con un poco de práctica, podrás gestionar tus módulos como un profesional.

[TIP] Si usas Syspanel, recuerda que el acceso es por el puerto 2106. Es una herramienta muy visual que facilita la gestión de archivos, ideal para principiantes.

Ahora ya sabes cómo instalar un módulo PrestaShop de forma manual. ¡Manos a la obra y a personalizar tu tienda!