Instalar módulos en PrestaShop con Plesk: Tutorial detallado

Introducción: ¿Por qué instalar módulos en PrestaShop desde Plesk?

Si tienes una tienda online con PrestaShop, sabes que los módulos son el alma de la personalización. Añaden funcionalidades como pasarelas de pago, envíos, SEO, marketing y mucho más. Pero, ¿qué haces cuando el gestor de módulos de PrestaShop falla o tienes problemas de permisos? La solución está en tu panel de control: Plesk.

En esta guía completa te enseñaremos cómo instalar módulos en PrestaShop desde Plesk paso a paso. Aprenderás a subir archivos, descomprimir, configurar permisos y activar módulos sin necesidad de usar el backoffice de PrestaShop. Además, incluimos trucos para la gestión módulos PrestaShop desde el servidor y resolver los problemas más comunes.

Este tutorial módulos PrestaShop está diseñado para usuarios sin experiencia técnica. Vamos a usar un lenguaje claro, muchos ejemplos y advertencias importantes para que no te pierdas.

¿Qué necesitas antes de empezar?

Antes de lanzarte a instalar módulos PrestaShop Plesk, asegúrate de tener lo siguiente:

Acceso a Plesk: Usuario y contraseña de tu panel de hosting. Normalmente accedes a través de https://tudominio.com:8443 o la URL que te haya dado tu proveedor.
Módulo en formato ZIP: El archivo del módulo que quieres instalar (por ejemplo, micodigo.zip). Debe ser compatible con tu versión de PrestaShop.
Conexión FTP o SFTP: Aunque usemos Plesk, a veces necesitarás un cliente FTP como FileZilla para tareas avanzadas.
Credenciales de la base de datos: No siempre, pero es útil tenerlas a mano.

[WARNING] No todos los módulos son compatibles con todas las versiones de PrestaShop. Verifica los requisitos antes de descargar.

Paso 1: Accede al administrador de archivos de Plesk

El primer paso para instalar módulos PrestaShop Plesk es ubicar la carpeta de tu tienda. Sigue estos pasos:

Inicia sesión en Plesk con tu usuario y contraseña.
En el panel principal, busca tu dominio (el de tu tienda PrestaShop) y haz clic en "Administrador de archivos".
Se abrirá una ventana con la estructura de carpetas de tu sitio web.

La ruta típica para PrestaShop es:
httpdocs/ o public_html/
Dentro de esa carpeta, busca la subcarpeta modules. Ahí es donde se almacenan todos los módulos.

[TIP] Si no ves la carpeta modules, puede que esté oculta o que tu PrestaShop esté en una subcarpeta (por ejemplo, /tienda/modules). Revisa bien.

Paso 2: Sube el módulo ZIP a la carpeta temporal

Ahora que estás en la carpeta modules, vamos a subir el archivo ZIP que descargaste. No lo descomprimas aún.

Haz clic en el botón "Subir archivos" (normalmente un icono de flecha hacia arriba).
Selecciona el archivo .zip de tu módulo desde tu computadora.
Espera a que la carga termine. Verás el archivo listado en la carpeta.

[INFO] Si tu módulo pesa más de 50 MB, puede que el administrador de archivos de Plesk tenga límites. En ese caso, usa FTP.

Paso 3: Descomprime el módulo en la carpeta correcta

Una vez subido el ZIP, debemos extraerlo. Esto es clave para la gestión módulos PrestaShop:

Selecciona el archivo ZIP haciendo clic en la casilla de verificación.
Haz clic en "Extraer archivos" (o "Descomprimir").
En la ventana emergente, asegúrate de que la ruta de destino sea la misma carpeta modules. No cambies nada.
Haz clic en "Aceptar". Plesk descomprimirá el archivo y creará una carpeta con el nombre del módulo.

[WARNING] Si el módulo se descomprime en una subcarpeta adicional (por ejemplo, micodigo/micodigo), tendrás que mover los archivos al nivel correcto. La estructura debe ser: modules/nombredelmodulo/archivos.php.

Paso 4: Verifica los permisos de la carpeta del módulo

Este es el paso que más dolores de cabeza causa. PrestaShop necesita permisos de escritura en la carpeta del módulo para funcionar correctamente. Si no lo haces, el módulo no se activará o dará errores.

En el administrador de archivos, localiza la carpeta del módulo que acabas de descomprimir.
Haz clic derecho sobre ella y selecciona "Cambiar permisos".
Configura los permisos de la siguiente manera:
- Propietario: 755 (lectura, escritura y ejecución para el propietario; lectura y ejecución para el grupo y otros).
- Grupo y otros: 755 o 644 para archivos individuales.
Marca la opción "Aplicar a todos los archivos y subcarpetas" (recursivo).
Haz clic en "Aceptar".

[TIP] Si tu servidor usa PHP-FPM, a veces necesitas permisos 775 para que el usuario del servidor web pueda escribir. Consulta con tu hosting si no estás seguro.

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

Ahora que el módulo está físicamente en el servidor, debes activarlo desde PrestaShop:

Accede a tu panel de administración de PrestaShop (por ejemplo, tudominio.com/admin1234).
Ve a "Módulos" > "Gestor de módulos".
Busca el nombre del módulo que acabas de instalar. Si no aparece, haz clic en "Actualizar lista de módulos" (icono de flecha circular).
Una vez visible, haz clic en "Instalar" o "Activar".
Configura el módulo según las instrucciones del desarrollador.

[WARNING] Si el módulo no aparece, revisa que la carpeta esté en la ubicación correcta y que los permisos sean adecuados. También verifica que el nombre del módulo coincida exactamente con el de la carpeta.

Paso 6: Prueba el módulo y limpia la caché

Después de activarlo, es importante probar que funciona y limpiar la caché de PrestaShop:

Ve a "Parámetros avanzados" > "Rendimiento".
Haz clic en "Limpiar caché" (tanto de Smarty como de Symfony).
Visita tu tienda y prueba la funcionalidad del módulo (por ejemplo, un formulario de suscripción o un método de pago).

Si todo funciona, ¡enhorabuena! Has completado el tutorial módulos PrestaShop exitosamente.

Solución de problemas comunes al instalar módulos en PrestaShop desde Plesk

Incluso siguiendo los pasos, pueden surgir errores. Aquí tienes los más frecuentes y cómo solucionarlos:

Error: "El módulo no se encuentra" o "No se puede instalar"

Causa: La carpeta del módulo no está en la ruta correcta o tiene permisos incorrectos.
Solución: Vuelve al Administrador de archivos, verifica que la carpeta esté dentro de modules y que los permisos sean 755 (o 775).

Error: "Archivo no válido" al descomprimir

Causa: El ZIP está dañado o no es un módulo válido de PrestaShop.
Solución: Descarga el módulo nuevamente desde la fuente oficial. A veces los módulos gratuitos de foros vienen corruptos.

Error: "Permiso denegado" al subir archivos

Causa: El límite de tamaño de archivo en Plesk es muy bajo.
Solución: Usa un cliente FTP (como FileZilla) para subir el ZIP directamente a la carpeta modules. Luego descomprímelo desde Plesk.

El módulo se instala pero no funciona

Causa: El módulo requiere extensiones de PHP (como cURL, JSON, etc.) o una versión específica de PrestaShop.
Solución: Revisa los requisitos del módulo. Desde Plesk, puedes ir a "PHP Settings" y habilitar extensiones. También verifica que tu PrestaShop esté actualizado.

Preguntas frecuentes (FAQ)

¿Puedo instalar módulos sin usar el backoffice de PrestaShop?

Sí, siguiendo esta guía. De hecho, es la forma más segura cuando el gestor de módulos falla o tienes problemas de conexión.

¿Qué hago si no veo la carpeta `modules` en Plesk?

Es posible que tu PrestaShop esté instalado en una subcarpeta (por ejemplo, /tienda). Busca dentro de httpdocs/tienda/modules. Si no existe, crea la carpeta manualmente.

¿Los módulos gratuitos y de pago se instalan igual?

Sí, el proceso es idéntico. Solo cambia que los módulos de pago suelen requerir una clave de licencia que configuras después de activarlos.

¿Puedo instalar módulos desde un hosting compartido con Plesk?

Sí, Plesk está diseñado para funcionar en la mayoría de los hostings compartidos. Sin embargo, algunos proveedores limitan el acceso al administrador de archivos. En ese caso, usa FTP.

¿Cómo desinstalo un módulo desde Plesk?

Para desinstalar, primero desactívalo desde el backoffice de PrestaShop. Luego, desde Plesk, elimina la carpeta del módulo dentro de modules. Finalmente, limpia la caché.

Consejos finales para una gestión eficiente de módulos en PrestaShop

Mantén un backup: Antes de instalar cualquier módulo, haz una copia de seguridad de tu tienda (archivos y base de datos). Plesk tiene una herramienta de backup integrada.
Actualiza los módulos regularmente: Los módulos desactualizados pueden causar vulnerabilidades de seguridad. Desde Plesk, puedes ver las versiones disponibles.
Usa módulos de fuentes confiables: El marketplace oficial de PrestaShop y desarrolladores reconocidos son la mejor opción. Evita módulos de dudosa procedencia.
Documenta los cambios: Si instalas varios módulos, lleva un registro de qué hace cada uno. Esto facilita la resolución de conflictos.

[TIP] Si tu tienda crece, considera usar un entorno de pruebas (staging) para instalar módulos antes de ponerlos en producción. Plesk permite crear copias de tu sitio con un clic.

Conclusión

Instalar módulos en PrestaShop desde Plesk es un proceso sencillo si sigues los pasos correctos. Con esta guía, has aprendido a subir, descomprimir, configurar permisos y activar módulos sin depender del backoffice. Además, ya sabes cómo solucionar los errores más comunes.

Recuerda que la gestión módulos PrestaShop desde el servidor te da mayor control y estabilidad. Ahora puedes personalizar tu tienda al máximo sin miedo a romper nada.

Si te quedó alguna duda, déjanos un comentario o consulta con tu proveedor de hosting. ¡Buena suerte con tu tienda online!