Instalar módulos PrestaShop manualmente | Tutorial

Instalar módulos PrestaShop manualmente es una tarea esencial para personalizar tu tienda online, añadir funcionalidades o resolver problemas de compatibilidad. Aunque el marketplace de PrestaShop ofrece instalación automática, muchas veces es necesario hacerlo de forma manual, ya sea porque el módulo viene en un archivo ZIP, porque necesitas subir una versión específica o porque tu servidor tiene restricciones. Esta guía te explica paso a paso cómo realizar este proceso de manera segura y efectiva, sin necesidad de conocimientos técnicos avanzados.

¿Por qué instalar módulos manualmente en PrestaShop?

Antes de comenzar, es importante entender cuándo y por qué conviene hacer una instalación manual. Aunque la opción automática desde el back office es cómoda, en ciertos escenarios la instalación manual es la única alternativa viable:

Módulos personalizados o de terceros: Si has comprado un módulo en un sitio externo o lo has desarrollado tú mismo, no estará disponible en el marketplace oficial.
Problemas de conexión o permisos: Algunos servidores bloquean la descarga directa desde el back office, por lo que subir el archivo manualmente es la solución.
Control de versiones: Puedes instalar una versión específica que sabes que funciona bien con tu PrestaShop, evitando actualizaciones forzadas.
Módulos gratuitos sin soporte: Muchos módulos gratuitos se distribuyen solo como archivos ZIP descargables desde foros o repositorios.

Requisitos previos para instalar módulos PrestaShop manualmente

Antes de lanzarte a la instalación, asegúrate de cumplir con estos requisitos básicos:

Acceso al back office de PrestaShop: Necesitas credenciales de administrador.
Acceso al servidor vía FTP o panel de control: Herramientas como FileZilla, cPanel, o Syspanel (accesible por el puerto 2106) te permitirán subir archivos.
Archivo del módulo en formato ZIP: Asegúrate de que el módulo sea compatible con tu versión de PrestaShop (1.6, 1.7 o 8.x).
Copia de seguridad: Siempre es recomendable hacer un respaldo de tu tienda antes de instalar módulos, especialmente si estás en producción.

[WARNING] No instales módulos de fuentes no confiables. Un módulo malicioso puede comprometer la seguridad de tu tienda y los datos de tus clientes.

Método 1: Instalación manual desde el back office (subiendo el ZIP)

Este es el método más sencillo y no requiere acceso al servidor. Solo necesitas el archivo ZIP del módulo.

Paso 1: Accede al back office

Ingresa a tu panel de administración de PrestaShop. Normalmente la URL es tudominio.com/adminXXXX (donde XXXX es un código aleatorio). Una vez dentro, dirígete al menú Módulos > Gestor de módulos.

Paso 2: Sube el módulo

En la parte superior derecha verás un botón que dice "Subir un módulo" (o un icono de subida). Haz clic en él y selecciona el archivo ZIP desde tu computadora. PrestaShop se encargará de descomprimirlo e instalarlo automáticamente.

Paso 3: Configura y activa el módulo

Una vez subido, el módulo aparecerá en la lista. Busca su nombre y haz clic en "Configurar" para ajustar sus opciones, o en "Instalar" si no se activó solo. Si todo va bien, verás un mensaje de éxito.

[TIP] Si el botón de subir no aparece, puede ser que tu versión de PrestaShop sea muy antigua o que tengas deshabilitada la opción de carga de archivos. En ese caso, usa el Método 2.

Método 2: Instalación manual vía FTP o panel de control (Syspanel)

Este método es útil cuando el back office no permite subir archivos o cuando el módulo es demasiado grande. Necesitarás un cliente FTP (como FileZilla) o acceso a tu panel de hosting.

Paso 1: Descarga y descomprime el módulo

En tu computadora, descomprime el archivo ZIP del módulo. Verás una carpeta con el nombre del módulo (por ejemplo, micodigo). Dentro suele haber archivos PHP, carpetas de idiomas, etc.

Paso 2: Conéctate al servidor

Usa tu cliente FTP o el panel de control. Si usas Syspanel, accede a través de tudominio.com:2106 (puerto 2106) e inicia sesión con tus credenciales. Luego, navega hasta el administrador de archivos.

Paso 3: Localiza la carpeta de módulos

Dentro de la raíz de tu PrestaShop (normalmente public_html o www), busca la carpeta /modules/. Esta carpeta contiene todos los módulos instalados. Si no la ves, puede estar dentro de /tienda/modules/ o similar, dependiendo de tu estructura.

Paso 4: Sube la carpeta del módulo

Arrastra la carpeta descomprimida (no el ZIP) desde tu computadora a la carpeta /modules/ del servidor. Espera a que se complete la transferencia. Asegúrate de que la carpeta tenga los permisos correctos (generalmente 755 para carpetas y 644 para archivos).

[INFO] Si usas FTP, verifica que la transferencia sea en modo binario para evitar errores de codificación. FileZilla lo hace automáticamente.

Paso 5: Instala el módulo desde el back office

Ahora ve al back office de PrestaShop. En el gestor de módulos, el módulo debería aparecer en la lista (a veces hay que recargar la página). Haz clic en "Instalar" y luego configura sus opciones.

Solución de problemas comunes al instalar módulos PrestaShop manualmente

A veces, la instalación no es tan fluida. Aquí tienes los problemas más frecuentes y cómo resolverlos:

El módulo no aparece después de subirlo

Causa: La carpeta no está en la ubicación correcta o el nombre de la carpeta no coincide con el nombre del módulo.
Solución: Revisa que la carpeta esté dentro de /modules/ y que su nombre sea exactamente el mismo que el del módulo (sin espacios ni caracteres extraños). Por ejemplo, si el módulo se llama "micodigo", la carpeta debe llamarse micodigo.

Error de compatibilidad al instalar

Causa: El módulo fue diseñado para una versión anterior de PrestaShop.
Solución: Busca una versión del módulo compatible con tu PrestaShop. Puedes modificar manualmente el archivo config.xml dentro de la carpeta del módulo para cambiar la versión requerida, pero esto puede causar fallos. Mejor contacta al desarrollador.

Mensaje "No se puede escribir en el directorio"

Causa: Permisos incorrectos en la carpeta /modules/ o en la carpeta del módulo.
Solución: Desde FTP o Syspanel, cambia los permisos de la carpeta del módulo a 755 y los archivos a 644. Si el problema persiste, verifica que el usuario del servidor tenga permisos de escritura.

El módulo se instala pero da error 500 o pantalla en blanco

Causa: Conflicto con otros módulos o falta de dependencias (como librerías PHP).
Solución: Desactiva temporalmente otros módulos para identificar el conflicto. Revisa los logs de errores de PrestaShop en /var/logs/ o en el panel de hosting. Si el error es de código, contacta al desarrollador.

Consejos adicionales para una instalación exitosa

Siempre verifica la compatibilidad: Antes de instalar, lee la descripción del módulo y asegúrate de que sea compatible con tu versión de PrestaShop (1.6, 1.7, 8.x). Los módulos de versiones antiguas pueden no funcionar.
Usa un entorno de pruebas: Si tienes un sitio de staging (copia de prueba), instala el módulo allí primero para verificar que no rompa nada.
Mantén copias de seguridad: Antes de cualquier instalación, haz un respaldo de la base de datos y los archivos. Así, si algo sale mal, puedes restaurar fácilmente.
Actualiza PrestaShop: A veces, los módulos requieren la última versión de PrestaShop. Mantén tu tienda actualizada para evitar problemas de compatibilidad.
Lee las reseñas: Si el módulo es de terceros, busca opiniones de otros usuarios. Un módulo con malas reseñas puede ser problemático.

[WARNING] No elimines la carpeta del módulo directamente desde el servidor si está instalado. Primero desinstálalo desde el back office para evitar errores en la base de datos.

Preguntas frecuentes (FAQ) sobre instalación manual de módulos PrestaShop

¿Puedo instalar un módulo ZIP sin descomprimirlo?

No directamente. El back office acepta el ZIP y lo descomprime automáticamente. Si usas FTP, debes descomprimirlo primero y subir la carpeta.

¿Qué hago si el botón "Subir un módulo" no aparece?

Esto suele ocurrir en versiones antiguas o cuando el servidor tiene restricciones. Usa el método FTP o contacta con tu proveedor de hosting para habilitar la carga de archivos.

¿Cómo sé si un módulo es compatible con mi PrestaShop?

Revisa la descripción del módulo o su archivo config.xml. Allí suele indicar las versiones compatibles. También puedes probar instalarlo y ver si da error.

¿Puedo instalar módulos gratuitos de fuentes externas?

Sí, pero con precaución. Descarga solo de sitios confiables y verifica que el archivo no contenga malware. Escanea el ZIP con un antivirus antes de subirlo.

¿Qué pasa si el módulo no se activa después de instalarlo?

Puede que tenga dependencias no cumplidas (por ejemplo, requiere una librería PHP específica). Revisa los logs de errores o contacta al desarrollador.

¿Es seguro instalar módulos manualmente?

Sí, siempre que sigas los pasos correctos y uses fuentes confiables. La instalación manual te da más control sobre el proceso.

Conclusión: Domina la instalación manual de módulos PrestaShop

Instalar módulos PrestaShop manualmente no tiene por qué ser complicado. Con esta guía, tienes dos métodos claros: desde el back office subiendo el ZIP, o vía FTP/Syspanel subiendo la carpeta descomprimida. Ambos son efectivos, y la elección depende de tu acceso y comodidad.

Recuerda siempre hacer una copia de seguridad antes de jugar con módulos, verificar la compatibilidad y, si te atascas, consultar los logs de errores. La práctica hace al maestro, y pronto podrás instalar cualquier módulo en cuestión de minutos. ¡Tu tienda online te lo agradecerá con nuevas funcionalidades y mejor rendimiento!

[TIP] Si eres principiante, empieza con el método del back office. Es el más rápido y no requiere herramientas externas. Cuando te sientas más seguro, prueba con FTP para tener un control total.