Cómo instalar módulos de PrestaShop en Plesk manualmente

¿Tienes una tienda online con PrestaShop alojada en Plesk y necesitas añadir un módulo o plugin que no está disponible directamente desde el back office? No te preocupes. Aunque instalar módulos desde el propio panel de PrestaShop es lo más cómodo, a veces necesitas hacerlo de forma manual, ya sea porque el módulo viene en un archivo ZIP, porque es una versión personalizada o porque el servidor tiene restricciones. En esta guía te explico, paso a paso y en un lenguaje muy sencillo, cómo instalar módulos PrestaShop Plesk de manera manual. Además, veremos cómo solucionar los problemas más comunes que pueden surgir durante el proceso.

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

Antes de empezar, es bueno que sepas que PrestaShop módulos manual es una práctica habitual cuando:

• El módulo no está en el marketplace oficial.
• El archivo ZIP que descargaste no se puede subir desde el back office (por límites de tamaño o permisos).
• Necesitas instalar una versión específica o un parche de seguridad.
• El módulo requiere configuración previa de archivos o carpetas.

Instalar manualmente te da control total sobre el proceso. Y aunque suene técnico, con las herramientas adecuadas (como el panel de control Plesk) es bastante sencillo.

Requisitos previos antes de instalar

Para que todo salga bien, asegúrate de tener:

• Acceso a Plesk con permisos de administrador o de gestión de archivos.
• El archivo ZIP del módulo de PrestaShop que quieres instalar (descargado de una fuente confiable).
• Conocimiento básico de la estructura de carpetas de PrestaShop.
• Opcional: acceso FTP o SFTP (aunque con Plesk no es necesario, porque puedes usar el gestor de archivos integrado).

[INFO] Si tu hosting usa un panel como Syspanel (antes HestiaCP), el acceso suele ser por el puerto 2106. Pero en este artículo nos centramos en Plesk, que es el estándar en muchos servidores.

Paso 1: Accede al gestor de archivos de Plesk

Lo primero es entrar en el panel de control de tu hosting. Una vez dentro de Plesk, busca la opción "Administrador de archivos" o "File Manager". Normalmente está en la sección de tu dominio o en el menú de herramientas.

Desde aquí podrás navegar por los directorios de tu sitio web sin necesidad de usar FTP. Es muy visual y fácil de usar: puedes arrastrar archivos, crear carpetas y cambiar permisos.

Paso 2: Localiza la carpeta de módulos de PrestaShop

Dentro del administrador de archivos, busca la carpeta raíz de tu instalación de PrestaShop. Generalmente se llama algo como httpdocs, public_html o directamente el nombre de tu dominio.

Dentro de esa carpeta, busca la subcarpeta modules. Esa es la carpeta donde PrestaShop almacena todos los módulos instalados. Si no la ves, puede estar dentro de htdocs o www.

[WARNING] No confundas la carpeta modules con la carpeta themes o override. Cada una tiene su función. Los módulos siempre van en modules.

Paso 3: Sube el módulo manualmente

Ahora viene la parte clave. Tienes dos formas de subir el módulo:

Opción A: Subir el ZIP y descomprimirlo

1. En el administrador de archivos, haz clic en "Subir archivos".
2. Selecciona el archivo ZIP del módulo desde tu computadora.
3. Una vez subido, localiza el ZIP dentro de la carpeta modules.
4. Haz clic derecho sobre el archivo y elige "Extraer" o "Descomprimir".
5. Asegúrate de que la extracción se haga en la misma carpeta (modules). El resultado debe ser una subcarpeta con el nombre del módulo (por ejemplo, micromodulo).

Opción B: Subir la carpeta ya descomprimida

Si prefieres, puedes descomprimir el ZIP en tu computadora y luego subir la carpeta completa:

1. Descomprime el ZIP en tu PC.
2. En el administrador de archivos, ve a la carpeta modules.
3. Haz clic en "Subir archivos" y arrastra la carpeta del módulo (ya descomprimida) o usa el botón de subir carpeta si está disponible.
4. Espera a que termine la subida.

[TIP] Si el módulo es muy grande, la opción de subir el ZIP y descomprimirlo en el servidor suele ser más rápida y evita errores de conexión.

Paso 4: Verifica los permisos de la carpeta

Uno de los errores más comunes al instalar módulos PrestaShop Plesk manualmente es que los permisos de la carpeta del módulo no son correctos. PrestaShop necesita poder leer y escribir en esas carpetas para funcionar bien.

Para verificarlo:

1. Dentro del administrador de archivos, haz clic derecho sobre la carpeta del módulo recién subida.
2. Selecciona "Permisos" o "Change Permissions".
3. Asegúrate de que los permisos sean al menos 755 para carpetas y 644 para archivos. Si ves valores como 777, cámbialos a 755 por seguridad.
4. Si el módulo necesita escribir archivos (por ejemplo, para logs o caché), puede que necesites permisos 775, pero en general 755 es suficiente.

[WARNING] No pongas permisos 777 a menos que sea estrictamente necesario y sepas lo que haces. Es un riesgo de seguridad.

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

Una vez que la carpeta del módulo está en su sitio y con los permisos correctos, el siguiente paso es activarlo desde el panel de administración de PrestaShop.

1. Accede a tu back office de PrestaShop (normalmente tudominio.com/admin).
2. Ve al menú "Módulos" > "Gestor de módulos".
3. Haz clic en la pestaña "Módulos" (no confundir con "Servicios" o "Temas").
4. En la lista de módulos, busca el nombre del módulo que acabas de subir. Si todo está bien, debería aparecer.
5. Haz clic en el botón "Instalar" o "Activar" (depende de la versión de PrestaShop).
6. Sigue las instrucciones del módulo (puede pedir configuración adicional).

Si el módulo no aparece, puede que el nombre de la carpeta no coincida con el nombre del módulo en el código, o que falte algún archivo esencial (como index.php o config.xml). Revisa que la carpeta contenga al menos un archivo principal (normalmente nombre_del_modulo.php).

Solución de problemas comunes

El módulo no aparece en la lista

• Causa: La carpeta no está en modules o el nombre es incorrecto.
• Solución: Verifica que la carpeta esté directamente dentro de modules y que el nombre sea exactamente el mismo que el del módulo (suele ser en minúsculas y sin espacios).

Error de permisos al instalar

• Causa: La carpeta o archivos tienen permisos muy restrictivos (por ejemplo, 600).
• Solución: Cambia los permisos de toda la carpeta del módulo a 755 (o 775 si es necesario).

Error de "módulo no válido" o "archivo corrupto"

• Causa: El ZIP que descargaste está dañado o no es compatible con tu versión de PrestaShop.
• Solución: Descarga el módulo nuevamente desde una fuente oficial. Asegúrate de que sea para tu versión de PrestaShop (1.6, 1.7, 8.x, etc.).

El módulo se instala pero no funciona

• Causa: Puede faltar alguna dependencia (como otra extensión) o la configuración es incorrecta.
• Solución: Revisa la documentación del módulo. A veces necesitas activar otros módulos o ajustar parámetros en el back office.

Consejos adicionales para una instalación exitosa

• Siempre haz una copia de seguridad de tu tienda antes de instalar módulos manualmente. Puedes usar la herramienta de backup de Plesk o exportar la base de datos y los archivos.
• Mantén PrestaShop actualizado. Los módulos más recientes suelen ser compatibles con las últimas versiones.
• Usa un entorno de pruebas si es posible. Algunos módulos pueden causar conflictos con otros plugins.
• Si el módulo es de pago, asegúrate de tener la licencia activa y de que el desarrollador ofrezca soporte.

Preguntas frecuentes (FAQ)

¿Puedo instalar un módulo de PrestaShop desde Plesk sin usar el back office?

Sí, pero el módulo no se activará hasta que no lo instales desde el back office. Subir la carpeta es solo el primer paso.

¿Qué hago si el administrador de archivos de Plesk no me deja subir archivos grandes?

Puedes usar FTP o SFTP. En Plesk, ve a la sección de "Acceso FTP" y crea una cuenta. Luego, con un cliente como FileZilla, conecta y sube el archivo directamente.

¿El proceso es el mismo para cualquier versión de PrestaShop?

Básicamente sí. La carpeta modules siempre está en la raíz. Sin embargo, en PrestaShop 1.7 y versiones superiores, la estructura es similar, pero algunos módulos requieren pasos adicionales (como registro en el marketplace). Sigue las instrucciones del fabricante.

¿Puedo instalar módulos de terceros que no sean del marketplace oficial?

Sí, pero con precaución. Asegúrate de que el módulo sea de confianza y no contenga malware. Revisa las reseñas y la reputación del desarrollador.

¿Qué pasa si el módulo necesita una base de datos?

La mayoría de los módulos crean sus propias tablas al instalarse desde el back office. Si el módulo no se activa, puede que la base de datos no se haya creado. En ese caso, contacta al soporte del módulo.

Conclusión

Instalar módulos PrestaShop Plesk manualmente no es complicado si sigues estos pasos. Con el administrador de archivos de Plesk, puedes subir y descomprimir el módulo en la carpeta correcta, ajustar permisos y luego activarlo desde el back office. Recuerda siempre verificar la compatibilidad con tu versión de PrestaShop y hacer copias de seguridad.

Si encuentras algún problema, revisa los permisos, el nombre de la carpeta y la integridad del archivo ZIP. Y si todo falla, no dudes en consultar la documentación oficial de PrestaShop o pedir ayuda en foros especializados.

Ahora ya sabes cómo añadir cualquier PrestaShop extensión Plesk sin depender del instalador automático. ¡Manos a la obra!