Gestión de módulos en PrestaShop con Plesk

Introducción

Si tienes una tienda online con PrestaShop, sabes que los módulos son el alma de tu sitio. Te permiten añadir funcionalidades como pasarelas de pago, envíos, SEO, marketing o personalización del diseño. Pero, ¿qué ocurre cuando necesitas instalar, actualizar o solucionar problemas con esos módulos? Aquí es donde entra Plesk, el panel de control de hosting que utilizas para gestionar tu servidor.

En este artículo extenso y detallado, te explicaré paso a paso cómo crear y gestionar módulos en PrestaShop desde Plesk. No importa si eres principiante o tienes algo de experiencia: el lenguaje será claro, visual y con muchos ejemplos prácticos. Al final, serás capaz de instalar módulos PrestaShop Plesk, gestionar módulos PrestaShop y solucionar los problemas más comunes sin estrés.

¿Qué necesitas saber antes de empezar?

Antes de lanzarnos a la acción, repasemos algunos conceptos básicos. Plesk es un panel de control de hosting que te permite administrar tu servidor web, bases de datos, correos electrónicos y, por supuesto, tu tienda PrestaShop. Desde Plesk puedes acceder directamente a los archivos de tu tienda, hacer copias de seguridad y gestionar módulos sin necesidad de entrar al backoffice de PrestaShop.

¿Por qué gestionar módulos desde Plesk?

Porque a veces el backoffice de PrestaShop se queda colgado o no te deja instalar módulos.
Porque necesitas subir un módulo manualmente (por ejemplo, si lo compraste en un marketplace externo).
Porque quieres hacer cambios en los archivos de configuración del módulo.
Porque necesitas solucionar errores de compatibilidad o permisos.

[INFO] Si tu hosting usa Syspanel (antes conocido como HestiaCP), recuerda que el puerto de acceso es el 2106. Pero en este artículo nos centraremos en Plesk, que es el panel más común para tiendas profesionales.

Paso 1: Acceder a los archivos de tu tienda en Plesk

Lo primero es entrar a Plesk. Normalmente lo haces a través de una URL como https://tudominio.com:8443 o la que te haya proporcionado tu proveedor de hosting. Una vez dentro, sigue estos pasos:

Inicia sesión con tu usuario y contraseña de Plesk.
En el panel principal, busca la sección "Sitios web y dominios" o directamente el nombre de tu dominio.
Haz clic en "Administrar archivos" (o "File Manager"). Se abrirá una ventana con la estructura de carpetas de tu sitio.

Aquí es donde ocurre la magia. Los módulos de PrestaShop se almacenan en la carpeta modules dentro del directorio raíz de tu tienda (normalmente httpdocs o public_html).

[TIP] Si no ves la carpeta modules, revisa que estés en la raíz correcta. A veces hay una subcarpeta como prestashop o tienda.

Paso 2: Instalar un módulo manualmente desde Plesk

La instalación manual es la opción más fiable cuando el backoffice falla o cuando el módulo no está disponible en el marketplace de PrestaShop. Aquí te explico cómo hacerlo:

2.1. Subir el archivo ZIP del módulo

Descarga el módulo en tu ordenador. Normalmente viene en un archivo .zip.
En el File Manager de Plesk, navega hasta la carpeta modules.
Haz clic en "Subir archivos" (icono de flecha hacia arriba).
Selecciona el archivo ZIP desde tu ordenador y súbelo. Espera a que termine la subida (puede tardar unos segundos dependiendo del tamaño).

2.2. Descomprimir el módulo

Una vez subido, verás el archivo ZIP en la lista. Haz clic derecho sobre él y selecciona "Extraer" o "Descomprimir". El sistema creará una carpeta con el nombre del módulo.

[WARNING] Asegúrate de que el nombre de la carpeta extraída coincida con el nombre técnico del módulo (por ejemplo, ps_googleanalytics). Si no, PrestaShop no lo reconocerá.

2.3. Verificar permisos

Los módulos necesitan permisos de lectura y escritura para funcionar correctamente. En Plesk, puedes ajustar los permisos desde el File Manager:

Selecciona la carpeta del módulo recién extraída.
Haz clic en "Permisos" (o "Permissions").
Establece los valores: 755 para carpetas y 644 para archivos. Si ves que el módulo necesita escritura (por ejemplo, para logs), puedes poner 777 temporalmente, pero no es recomendable.

2.4. Instalar desde el backoffice de PrestaShop

Ahora ve al backoffice de tu tienda (normalmente tudominio.com/admin). Ve a "Módulos" > "Catálogo de módulos" y busca el nombre del módulo que acabas de subir. Debería aparecer en la lista de módulos no instalados. Haz clic en "Instalar".

[TIP] Si no aparece, prueba a refrescar la página o limpiar la caché de PrestaShop desde "Parámetros avanzados" > "Rendimiento".

Paso 3: Gestionar módulos desde Plesk (actualizar, desactivar, eliminar)

Una vez instalado, puedes gestionar el módulo desde el backoffice, pero a veces necesitas hacerlo directamente desde Plesk. Aquí te muestro cómo:

3.1. Actualizar un módulo manualmente

Descarga la nueva versión del módulo (otro archivo ZIP).
En Plesk, ve a la carpeta modules y elimina la carpeta antigua del módulo (no te preocupes, los datos suelen guardarse en la base de datos).
Sube y descomprime el nuevo ZIP como en el paso anterior.
Ve al backoffice y busca el módulo. Te pedirá que lo actualices. Sigue los pasos.

3.2. Desactivar un módulo desde Plesk

A veces un módulo da error y no puedes ni entrar al backoffice. Para desactivarlo:

En Plesk, ve a la carpeta modules y localiza la carpeta del módulo problemático.
Renombra la carpeta añadiendo _old al final (por ejemplo, ps_googleanalytics_old).
Esto hará que PrestaShop no lo reconozca y lo desactive automáticamente.
Luego, desde el backoffice, puedes desinstalarlo oficialmente.

3.3. Eliminar un módulo por completo

En Plesk, elimina la carpeta del módulo de modules.
Ve al backoffice y, en la sección de módulos, busca el módulo (aparecerá como "no instalado"). Haz clic en "Eliminar" para borrar los datos de la base de datos.

[INFO] Si quieres una limpieza más profunda, puedes usar PhpMyAdmin desde Plesk para buscar tablas relacionadas con el módulo (suelen empezar con ps_ o el nombre del módulo). Pero esto solo si sabes lo que haces.

Paso 4: Solucionar problemas comunes con módulos desde Plesk

Los módulos pueden dar problemas de compatibilidad, permisos o errores de código. Aquí tienes las soluciones más habituales que puedes aplicar desde Plesk.

4.1. Error "No se puede escribir en la carpeta de módulos"

Esto suele deberse a permisos incorrectos. Desde el File Manager de Plesk:

Ve a la carpeta modules.
Selecciona todas las carpetas de módulos.
Asigna permisos 755 a carpetas y 644 a archivos.
Si el error persiste, revisa que el usuario del servidor web (www-data, apache, etc.) tenga permisos de escritura en la carpeta modules.

4.2. Módulo no aparece en el backoffice después de instalarlo

Causas posibles:

Caché: Limpia la caché de PrestaShop desde "Parámetros avanzados" > "Rendimiento".
Nombre de carpeta incorrecto: Revisa que la carpeta en modules se llame exactamente como el nombre técnico del módulo.
Falta de archivos: Abre la carpeta del módulo en Plesk y verifica que contenga al menos un archivo index.php y un archivo de configuración (normalmente config.xml o module.php).

4.3. Módulo da error 500 o página en blanco

Esto suele ser por incompatibilidad de versiones o errores de PHP. Desde Plesk:

Ve a "Sitios web y dominios" > selecciona tu dominio > "Configuración de PHP".
Aumenta el límite de memoria (memory_limit) a 256M o 512M.
Activa la visualización de errores temporalmente para ver el mensaje exacto.
También puedes revisar los logs de error en "Logs" > "Error log" dentro de Plesk.

[WARNING] No dejes la visualización de errores activada en producción, ya que expone información sensible.

Paso 5: Buenas prácticas para gestionar módulos PrestaShop Plesk

Para evitar dolores de cabeza, sigue estas recomendaciones:

Haz copias de seguridad antes de instalar o actualizar módulos. En Plesk, ve a "Copias de seguridad" y crea una copia completa de tu sitio.
Usa módulos de fuentes confiables (marketplace oficial, desarrolladores conocidos). Los módulos piratas suelen tener malware.
Mantén PrestaShop actualizado junto con los módulos. Las versiones antiguas son vulnerables.
No instales demasiados módulos porque ralentizan la tienda. Solo los necesarios.
Revisa los logs en Plesk periódicamente para detectar errores de módulos.

Preguntas frecuentes (FAQ)

¿Puedo instalar módulos desde Plesk sin usar el backoffice?

Sí, subiendo el ZIP a la carpeta modules y descomprimiéndolo. Luego debes activarlo desde el backoffice, pero al menos la instalación física la haces desde Plesk.

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

Revisa la ficha del módulo en el marketplace o el archivo config.xml dentro de la carpeta del módulo. Allí suele indicar las versiones compatibles.

¿Qué hago si un módulo bloquea mi tienda?

Renombra la carpeta del módulo en Plesk (añadiendo _old). Esto lo desactivará y podrás acceder al backoffice para desinstalarlo.

¿Plesk tiene alguna herramienta específica para módulos PrestaShop?

Plesk no tiene un gestor de módulos integrado, pero su File Manager y las herramientas de base de datos (PhpMyAdmin) son suficientes para gestionarlos manualmente.

¿Puedo usar Syspanel (HestiaCP) para lo mismo?

Sí, pero recuerda que en Syspanel el puerto de acceso es el 2106 y la estructura de carpetas es similar. Los pasos son prácticamente idénticos.

Conclusión

Gestionar módulos en PrestaShop desde Plesk no es complicado una vez que entiendes la estructura de archivos y los permisos. Con este artículo, ahora tienes una guía completa para instalar módulos PrestaShop Plesk, actualizarlos, desactivarlos y solucionar problemas sin depender exclusivamente del backoffice.

Recuerda siempre hacer copias de seguridad antes de cualquier cambio y mantener tu tienda actualizada. Si sigues estos pasos, tu tienda funcionará de manera óptima y podrás añadir todas las funcionalidades que necesites.

Si tienes dudas, no dudes en consultar la documentación oficial de PrestaShop o contactar con tu soporte técnico de hosting. ¡Buena suerte con tu tienda online!