Instalar módulos en PrestaShop con Plesk | Dudas frecuentes

¿Tienes problemas para instalar o gestionar módulos PrestaShop en tu servidor Plesk? No te preocupes, es una de las consultas más frecuentes que recibimos en soporte. La instalación de módulos puede parecer compleja al principio, pero con la guía adecuada y conociendo las herramientas que te ofrece Plesk módulos, verás que es un proceso sencillo y rápido.

En este artículo, vamos a resolver las dudas más comunes (FAQ PrestaShop) sobre la instalación de módulos. Te explicaremos paso a paso cómo hacerlo, qué permisos necesitas, cómo solucionar errores típicos y cómo mantener tu tienda segura. Todo explicado de forma clara, sin tecnicismos innecesarios.

¿Qué necesitas saber antes de instalar un módulo en PrestaShop?

Antes de lanzarte a instalar cualquier módulo, es importante que tengas claros algunos conceptos básicos. Esto te ahorrará dolores de cabeza y posibles errores.

Requisitos previos

Para instalar módulos PrestaShop correctamente, tu servidor debe cumplir con los siguientes requisitos:

PHP 7.4 o superior (PrestaShop 1.7 y 8.x lo exigen).
Permisos de escritura en las carpetas /modules, /override y /config.
Acceso a Plesk con permisos de administrador o de suscripción.
Conexión FTP o SFTP (aunque desde Plesk puedes hacerlo sin necesidad de cliente FTP).

[INFO] Si tu versión de PHP es inferior a 7.4, muchos módulos modernos no funcionarán. Puedes cambiarlo desde Plesk en "Hosting & DNS" > "Configuración de PHP".

¿Qué tipos de módulos existen?

Módulos gratuitos: se instalan directamente desde el back office de PrestaShop.
Módulos de pago o personalizados: suelen venir en un archivo .zip que debes subir manualmente.
Módulos empaquetados por el desarrollador: pueden incluir dependencias o requerir ajustes adicionales.

Cómo instalar módulos PrestaShop desde Plesk paso a paso

Vamos a lo práctico. Aquí tienes dos métodos principales para instalar módulos en tu tienda PrestaShop alojada en Plesk.

Método 1: Instalación directa desde el back office de PrestaShop

Este es el método más sencillo y recomendado para módulos del marketplace oficial.

Accede a tu panel de administración de PrestaShop (tu-dominio.com/adminXXXX).
Ve a Módulos > Catálogo de módulos.
Busca el módulo que deseas instalar.
Haz clic en Instalar.
Sigue las instrucciones del asistente (si las hay).

[TIP] Si el módulo no aparece en el catálogo, puede que no sea compatible con tu versión de PrestaShop o que esté desactivado en el marketplace.

Método 2: Instalación manual desde Plesk (módulos en .zip)

Este método es ideal cuando tienes un módulo descargado de un desarrollador externo o de pago.

Inicia sesión en Plesk.
Ve a Archivos (en el menú de la izquierda, dentro de tu suscripción).
Navega hasta la carpeta raíz de tu PrestaShop (normalmente httpdocs o public_html).
Localiza la carpeta /modules.
Sube el archivo .zip del módulo a una carpeta temporal (por ejemplo, tmp dentro de httpdocs).
Descomprime el .zip directamente desde Plesk (selecciona el archivo y haz clic en "Extraer archivos").
Mueve la carpeta extraída a la ruta /modules/.
Asigna permisos 755 a la carpeta del módulo y todos sus archivos (desde Plesk: selecciona la carpeta > "Permisos" > marcar "755").
Ve al back office de PrestaShop > Módulos > Gestor de módulos.
Haz clic en Subir un módulo (botón en la parte superior derecha).
Selecciona el archivo .zip desde tu ordenador (no desde el servidor). PrestaShop lo instalará automáticamente.

[WARNING] No subas el .zip directamente a la carpeta /modules sin descomprimirlo. PrestaShop no lo reconocerá.

Solución de errores comunes al instalar módulos PrestaShop

Aquí tienes las preguntas más frecuentes (FAQ PrestaShop) que recibimos en soporte. Si tu error no aparece, no dudes en contactarnos.

Error: "No se puede escribir en la carpeta /modules"

Causa: Permisos incorrectos en la carpeta /modules.

Solución:

Desde Plesk, ve a Archivos > selecciona la carpeta modules.
Haz clic en Permisos.
Marca 755 para directorios y 644 para archivos.
Si el error persiste, asigna temporalmente 777 (solo durante la instalación) y luego vuelve a 755.

[INFO] Nunca dejes permisos 777 de forma permanente. Es un riesgo de seguridad.

Error: "El módulo no es compatible con tu versión de PrestaShop"

Causa: El módulo fue diseñado para una versión anterior o posterior de PrestaShop.

Solución:

Verifica la versión de tu PrestaShop (en "Parámetros de la tienda" > "Información").
Busca una versión del módulo compatible con tu versión.
Si no existe, contacta al desarrollador.

Error: "No se puede conectar con el servidor"

Causa: Problemas de conexión a Internet o firewall bloqueando la descarga.

Solución:

Descarga el módulo manualmente desde el marketplace.
Sigue el Método 2 de instalación manual.

Error: "El archivo ZIP está corrupto o no es válido"

Causa: El archivo se descargó incompleto o está dañado.

Solución:

Descarga nuevamente el módulo desde la fuente original.
Verifica que el archivo tenga extensión .zip y no .rar o .tar.gz.

Preguntas frecuentes (FAQ PrestaShop) sobre módulos en Plesk

¿Puedo instalar módulos desde Plesk directamente?

Sí, puedes subir y descomprimir archivos desde el administrador de archivos de Plesk, pero la instalación final debe hacerse desde el back office de PrestaShop. Plesk te ayuda a gestionar los archivos, pero PrestaShop es quien registra el módulo en la base de datos.

¿Qué hago si el módulo no aparece en el gestor de módulos después de subirlo?

Verifica que la carpeta del módulo esté dentro de /modules y no en una subcarpeta.
Comprueba que el archivo principal del módulo (normalmente nombre_modulo.php) exista.
Refresca la página del gestor de módulos con Ctrl + F5.
Si sigue sin aparecer, revisa los logs de error en Plesk (en "Logs" del menú).

¿Puedo instalar módulos desde un servidor externo?

No es recomendable. Siempre descarga el módulo en tu ordenador y luego súbelo mediante el método manual. Instalar desde una URL externa puede ser un riesgo de seguridad.

¿Cómo desinstalo un módulo problemático?

Desde el back office de PrestaShop: Módulos > Gestor de módulos > busca el módulo > haz clic en Desinstalar.
Luego, desde Plesk, elimina la carpeta del módulo en /modules.
Si el módulo dejó tablas en la base de datos, puedes eliminarlas desde phpMyAdmin (en Plesk > "Bases de datos" > phpMyAdmin). Ojo: solo si estás seguro de que no las necesitas.

[WARNING] No elimines tablas sin hacer una copia de seguridad. Puedes romper tu tienda.

¿Qué permisos deben tener los archivos de los módulos?

Directorios: 755
Archivos: 644
Archivos de configuración (config.xml, etc.): 644

Puedes cambiarlos desde Plesk en "Archivos" > seleccionar carpeta/archivo > "Permisos".

Consejos avanzados para gestionar módulos en Plesk

Usa el modo de mantenimiento antes de instalar módulos críticos

Antes de instalar un módulo que modifique el front office (como un tema o un módulo de pago), activa el modo mantenimiento en PrestaShop. Así evitas que los clientes vean errores durante la instalación.

En PrestaShop: Parámetros de la tienda > Mantenimiento.
Activa "Modo mantenimiento".
Instala el módulo.
Desactiva el modo mantenimiento.

Haz una copia de seguridad antes de cada instalación

Especialmente si el módulo modifica la base de datos. Desde Plesk:

Ve a Sitios web y dominios > selecciona tu dominio.
Haz clic en Copias de seguridad.
Crea una copia completa (archivos + base de datos).

[TIP] Programa copias automáticas semanales desde Plesk. Así siempre tendrás un punto de restauración.

Si usas Syspanel (HestiaCP) en lugar de Plesk

Aunque este artículo está centrado en Plesk, si tu hosting usa Syspanel (HestiaCP), recuerda que el puerto de acceso es 2106. El proceso de instalación de módulos es similar, pero la gestión de archivos se hace desde el panel de Syspanel o mediante FTP.

Errores que debes evitar a toda costa

No sobrescribir archivos del núcleo de PrestaShop: algunos módulos mal diseñados te piden modificar archivos core. No lo hagas, usa siempre un override.
No instalar módulos de fuentes no confiables: pueden contener malware o backdoors.
No descomprimir módulos en carpetas equivocadas: asegúrate de que la carpeta del módulo esté dentro de /modules, no en /themes o /override.
No ignorar los logs de error: si algo falla, revisa los logs de Plesk y de PrestaShop. Te darán pistas claras.

Conclusión

Instalar módulos PrestaShop en un servidor con Plesk no tiene por qué ser un dolor de cabeza. Con los pasos que te hemos dado, podrás subir, instalar y solucionar problemas de la mayoría de módulos. Recuerda siempre:

Verificar permisos.
Hacer copias de seguridad.
Usar el método manual para módulos externos.
Consultar esta FAQ PrestaShop si algo falla.

Si después de todo sigues teniendo dudas, nuestro equipo de soporte está aquí para ayudarte. No dudes en abrir un ticket desde tu panel de control. ¡Buena suerte con tu tienda!