Gestionar módulos de PrestaShop en Plesk | Guía práctica

¿Alguna vez has necesitado instalar un módulo en tu tienda PrestaShop y te has sentido perdido entre archivos, carpetas y permisos? No te preocupes, es más común de lo que crees. Gestionar los módulos de PrestaShop es una tarea diaria para cualquier administrador de tienda, y hacerlo a través de tu panel de control (como Plesk) te da un control total y evita muchos dolores de cabeza.

En esta guía extensa y detallada, vamos a desglosar cómo gestionar los módulos de PrestaShop en Plesk, paso a paso, desde la instalación manual hasta la resolución de los errores más frecuentes. No necesitas ser un experto en programación; solo seguir nuestras instrucciones y, sobre todo, entender qué está pasando en cada momento.

¿Por qué gestionar módulos desde Plesk y no desde el Back Office?

PrestaShop tiene su propio gestor de módulos, que es muy útil, pero a veces se queda corto. Por ejemplo, cuando el servidor tiene restricciones de memoria, cuando el módulo es muy pesado o cuando necesitas subir un módulo personalizado que no está en el marketplace oficial. Ahí es donde entra en juego Plesk.

Plesk es el panel de control de tu hosting. Es la "sala de máquinas" de tu web. Gestionar los módulos desde aquí te permite:

Subir archivos directamente al servidor sin pasar por el limitador de tamaño de subida de PrestaShop.
Ajustar permisos de archivos (CHMOD) para que el módulo funcione correctamente.
Ver los logs de error en tiempo real si algo sale mal.
Forzar la limpieza de caché de una manera más profunda que desde el propio PrestaShop.

En resumen, si el Back Office es el volante del coche, Plesk es el capó. A veces necesitas abrir el capó para arreglar el motor.

Antes de empezar: Requisitos y precauciones

Antes de tocar nada, es vital que hagas una copia de seguridad. Esto es una regla de oro en el hosting. Un módulo mal instalado puede romper tu tienda.

[WARNING]
IMPORTANTE: Nunca instales un módulo sin tener una copia de seguridad reciente de tu base de datos y de tus archivos. Puedes hacerlo desde la sección "Copias de seguridad" de Plesk. Si algo falla, podrás restaurar todo en minutos.

También necesitas tener a mano los datos de acceso a Plesk (normalmente te los dio tu proveedor de hosting) y, por supuesto, el archivo del módulo en formato .zip o .tar.gz. No lo descomprimas en tu ordenador; lo subiremos tal cual.

Paso 1: Acceder al administrador de archivos de Plesk

Lo primero es acceder a tu panel de Plesk. Normalmente se accede a través de una URL como https://tu-dominio.com:8443 o https://tu-ip:8443. Una vez dentro, sigue estos pasos:

Busca la sección "Archivos" en el menú lateral izquierdo. Su icono es una carpeta amarilla.
Haz clic en él. Se abrirá el administrador de archivos de tu servidor.
Ahora, debes navegar hasta la raíz de tu instalación de PrestaShop. Normalmente es la carpeta httpdocs o public_html. Si tu tienda está en una subcarpeta (por ejemplo, httpdocs/tienda), navega hasta allí.

Dentro de esa carpeta raíz, verás muchas carpetas y archivos. No te asustes, es normal. Busca la carpeta llamada modules. Es ahí donde viven todos los módulos de tu PrestaShop.

Paso 2: Subir e instalar módulos PrestaShop manualmente

Ahora viene la parte importante. Para instalar un módulo nuevo, tienes dos opciones principales: subirlo comprimido o descomprimirlo directamente. Te recomiendo la primera, es más limpia y evita errores de permisos.

Opción A: Subir el archivo comprimido (Recomendada)

Dentro de la carpeta modules, haz clic en el botón "Subir archivo" (suele tener un icono de flecha hacia arriba).
Se abrirá una ventana. Arrastra tu archivo .zip del módulo o haz clic para seleccionarlo desde tu ordenador.
Espera a que la subida termine. Si el archivo pesa mucho, puede tardar unos segundos. No cierres la ventana mientras se sube.
Una vez subido, verás el archivo .zip listado en la carpeta modules. Haz clic derecho sobre él y selecciona "Extraer" o "Descomprimir".
Plesk te preguntará dónde extraer los archivos. Asegúrate de que la ruta sea la carpeta modules actual y haz clic en "Extraer".
Una vez extraído, verás una nueva carpeta con el nombre del módulo (por ejemplo, mycustommodule). Elimina el archivo .zip que subiste originalmente para mantener la carpeta limpia.

[TIP]
Si tu módulo viene en formato .tar.gz, Plesk también puede extraerlo. El proceso es idéntico al del .zip.

Opción B: Subir archivos descomprimidos

Si tu proveedor de módulos te da los archivos ya descomprimidos (una carpeta con archivos dentro), simplemente sube esa carpeta entera a la carpeta modules. Usa el botón "Subir archivo" y selecciona la carpeta, o arrástrala directamente si tu navegador lo permite.

Paso 3: Ajustar los permisos de los archivos (CHMOD)

Este es el paso que más errores evita. Los archivos de tu servidor tienen permisos que indican quién puede leer, escribir o ejecutarlos. PrestaShop necesita permisos específicos para funcionar.

En el administrador de archivos de Plesk, navega a la carpeta del módulo que acabas de subir (dentro de modules).
Selecciona toda la carpeta haciendo clic en la casilla de verificación al lado de su nombre.
Haz clic en el botón "Permisos" (o "CHMOD") en la barra de herramientas superior.
Se abrirá un cuadro de diálogo. Aquí debes asegurarte de que los permisos sean al menos 755 para las carpetas y 644 para los archivos. La forma más fácil es marcar las casillas de la siguiente manera:
- Owner (Propietario): Lectura, Escritura y Ejecución (marcar todo).
- Group (Grupo): Lectura y Ejecución.
- Public (Público): Lectura y Ejecución.
Haz clic en "Aceptar" o "Aplicar". Plesk aplicará estos permisos a todos los archivos y subcarpetas.

[WARNING]
Si no ves la opción de permisos, asegúrate de que el archivo no esté bloqueado. En Plesk, a veces los archivos subidos por FTP tienen un candado. Desbloquéalo antes de intentar cambiar permisos.

Paso 4: Instalar el módulo desde el Back Office de PrestaShop

Ahora que los archivos están en el servidor, vamos a activar el módulo. Vuelve a tu panel de administración de PrestaShop.

Ve a la sección "Módulos" > "Módulos y servicios".
En la esquina superior derecha, verás un botón que dice "Subir un módulo". Haz clic en él.
Se abrirá una ventana. No subas ningún archivo aquí. Simplemente espera a que la lista de módulos se cargue.
En la barra de búsqueda de módulos, escribe el nombre del módulo que acabas de subir (el nombre de la carpeta).
El módulo debería aparecer en la lista, aunque esté desinstalado. Si ves un botón "Instalar", haz clic en él.
PrestaShop te pedirá confirmación. Haz clic en "Instalar" de nuevo.

¡Felicidades! Has instalado el módulo manualmente. Ahora podrás configurarlo desde su propia página de configuración.

Paso 5: Solucionar errores comunes de la gestión de módulos

A veces, las cosas no salen a la primera. Aquí tienes los errores más típicos y cómo solucionarlos desde Plesk.

Error de "No se puede cargar el módulo" o "Clase no encontrada"

Esto significa que PrestaShop no encuentra el archivo principal del módulo. Las causas suelen ser:

La carpeta del módulo está mal nombrada. El nombre de la carpeta debe coincidir exactamente con el nombre de la clase principal del módulo. Por ejemplo, si la clase se llama MyCustomModule, la carpeta debe llamarse mycustommodule (en minúsculas). Revisa la documentación del módulo.
Falta el archivo principal. Dentro de la carpeta del módulo debe haber un archivo .php con el mismo nombre que la carpeta. Si no está, el módulo está incompleto. Vuelve a subirlo.

Error de memoria (Memory Limit)

PrestaShop a veces se queda sin memoria al intentar cargar un módulo pesado. Para solucionarlo, necesitas aumentar el límite de memoria de PHP.

En Plesk, ve a la sección "Configuración de PHP" (dentro de tu dominio o suscripción).
Busca la opción memory_limit y aumenta el valor. Por ejemplo, de 128M a 256M o 512M.
Guarda los cambios y vuelve a intentar la instalación.

[INFO]
Este cambio afecta a toda tu tienda, no solo al módulo. Es una solución segura y común para tiendas con muchos módulos.

Error de permisos (no se puede escribir en el archivo)

Si PrestaShop te dice que no puede escribir en un archivo de configuración, es un problema de permisos. Asegúrate de que la carpeta config de tu PrestaShop y sus archivos tengan permisos de escritura (por ejemplo, 755 para carpetas y 644 para archivos). Puedes cambiarlos desde el administrador de archivos de Plesk, como vimos antes.

Gestión avanzada: Limpiar la caché y forzar la compilación

Después de instalar o actualizar un módulo, es muy recomendable limpiar la caché para que los cambios se apliquen correctamente.

En el Back Office de PrestaShop, ve a "Parámetros avanzados" > "Rendimiento".
Haz clic en el botón "Vaciar la caché" (o "Limpiar caché"). Verás un icono de una escoba o un botón azul.
También puedes desactivar la opción "Forzar la compilación" (Force Compile) si está activada, ya que puede ralentizar tu tienda en producción.

Si el problema persiste, puedes borrar la caché manualmente desde Plesk. Dentro de la carpeta raíz de tu PrestaShop, busca la carpeta var/cache (en versiones modernas) o cache (en versiones antiguas). Elimina todos los archivos dentro de esa carpeta, pero no la carpeta en sí. Plesk te pedirá confirmación, acéptala.

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

¿Puedo instalar un módulo desde el mercado de PrestaShop directamente en Plesk?

No exactamente. El mercado de PrestaShop (Addons) está integrado en el Back Office. Si compras un módulo allí, la descarga se inicia desde el propio PrestaShop. Si tienes problemas con la descarga automática, puedes descargar el archivo .zip desde tu cuenta de Addons y subirlo manualmente a Plesk siguiendo los pasos anteriores.

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

Para eliminar un módulo por completo, primero debes desinstalarlo desde el Back Office (Módulos > Módulos y servicios > buscar el módulo > botón "Desinstalar"). Después, ve a Plesk, entra en la carpeta modules y elimina la carpeta del módulo. Esto borra todos los archivos restantes.

¿Es seguro cambiar los permisos a 777?

NO. Nunca uses permisos 777 (todos pueden escribir). Es un agujero de seguridad grave. Los permisos 755 y 644 son suficientes para el 99% de los casos. Si un módulo te pide permisos 777, es una mala señal y deberías buscar una alternativa.

¿Qué hago si mi módulo no aparece en la lista del Back Office?

Primero, revisa que has subido los archivos a la carpeta correcta (modules). Segundo, comprueba que el nombre de la carpeta coincide con el nombre de la clase principal. Tercero, limpia la caché como se explicó anteriormente. Si aún así no aparece, revisa los logs de error de PHP en Plesk (sección "Logs") para ver si hay algún error de sintaxis.

¿Puedo usar Plesk para actualizar un módulo existente?

Sí. El proceso es similar a la instalación. Descarga la nueva versión del módulo, sube el archivo .zip a la carpeta modules y extráelo. Plesk te preguntará si quieres sobrescribir los archivos existentes. Acepta. Después, ve al Back Office y haz clic en "Actualizar" en el módulo correspondiente.

[TIP]
Siempre desactiva el módulo antes de actualizarlo. Esto evita conflictos si el módulo se está ejecutando mientras se sobrescriben sus archivos.

Conclusión: Tú controlas tu tienda

Gestionar los módulos de PrestaShop en Plesk no es un misterio, es una habilidad que se aprende con la práctica. Tener este conocimiento te da una gran ventaja: no dependes de un técnico para cada pequeña actualización y puedes solucionar problemas críticos en minutos.

Recuerda siempre la máxima del buen administrador: copia de seguridad antes de tocar nada. Con Plesk, el proceso es transparente y, una vez que le coges el truco, te resultará tan natural como actualizar una aplicación en tu móvil.

Si has llegado hasta aquí, ya sabes más que la mayoría de los usuarios de PrestaShop. Ahora, ve y gestiona esos módulos con confianza. Si te surge alguna duda, repasa los pasos o consulta la documentación de tu hosting. ¡Tu tienda online te lo agradecerá!