Cómo instalar módulos en PrestaShop usando Plesk

Instalar módulos en PrestaShop es una de las tareas más habituales para ampliar las funcionalidades de tu tienda online. Ya sea para mejorar el SEO, añadir pasarelas de pago o personalizar el diseño, los módulos son el corazón de la personalización de PrestaShop. En esta guía básica, te explicaré paso a paso cómo instalar módulos en PrestaShop desde Plesk, el panel de control de hosting más común. No necesitas ser un experto técnico; con seguir estos pasos, podrás gestionar tus módulos sin problemas.

¿Qué necesitas antes de empezar?

Antes de lanzarte a la instalación, asegúrate de tener a mano los siguientes elementos:

Acceso a Plesk: Las credenciales de tu panel de control (usuario y contraseña). Normalmente recibes esto cuando contratas tu hosting.
El módulo en formato ZIP: La mayoría de módulos de PrestaShop se distribuyen como archivos comprimidos .zip. Si lo has comprado en el marketplace oficial, lo descargarás desde tu cuenta.
Conocimiento básico de la estructura de PrestaShop: Saber que los módulos se alojan en la carpeta /modules dentro de la raíz de tu tienda.
Conexión FTP o acceso al administrador de archivos de Plesk: Usaremos este último para mayor comodidad.

[INFO] Si tu hosting usa Syspanel (antes conocido como HestiaCP), el puerto de acceso es el 2106. El proceso es similar, pero la interfaz varía ligeramente.

¿Por qué instalar módulos desde Plesk y no desde el backoffice de PrestaShop?

Aunque PrestaShop tiene su propio gestor de módulos en el panel de administración, a veces falla por limitaciones del servidor, problemas de permisos o porque el módulo no está en el marketplace oficial. Instalar manualmente desde Plesk te da control total y evita errores de conexión. Además, es la única opción si tienes un módulo personalizado o descargado de terceros.

Paso 1: Acceder a Plesk y localizar tu dominio

Abre tu navegador y escribe la URL de acceso a Plesk. Normalmente es algo como https://tudominio.com:8443 o la dirección que te haya proporcionado tu proveedor de hosting.
Inicia sesión con tu usuario y contraseña.
En el panel principal, busca la sección "Sitios web y dominios" o similar. Allí verás listados todos los dominios que gestionas.
Haz clic en el nombre de tu tienda PrestaShop (por ejemplo, mitienda.com).

[TIP] Si no ves tu dominio, revisa que esté correctamente añadido y que el plan de hosting lo incluya.

Paso 2: Subir el módulo a la carpeta correcta

Una vez dentro del panel de tu dominio, sigue estos pasos:

Busca la opción "Administrador de archivos" o "File Manager". Generalmente está en el menú de la izquierda o en la sección de herramientas.
Navega hasta la carpeta raíz de tu PrestaShop. Por defecto suele ser httpdocs o public_html. Si no estás seguro, busca un archivo llamado index.php que contiene el código de PrestaShop.
Dentro de la raíz, localiza la carpeta modules. Si no existe, créala (aunque normalmente ya está).
Ahora, sube el archivo ZIP de tu módulo. Puedes arrastrarlo desde tu ordenador o usar el botón "Subir archivos".
Una vez subido, selecciona el archivo ZIP y haz clic en "Extraer" o "Descomprimir". Plesk creará automáticamente una carpeta con el nombre del módulo.

[WARNING] No descomprimas el ZIP en tu ordenador y subas las carpetas sueltas, porque podrías perder permisos o estructura. Siempre sube el ZIP y extrae desde Plesk.

Paso 3: Verificar permisos de la carpeta del módulo

Los módulos de PrestaShop necesitan permisos de lectura y escritura para funcionar correctamente. Si el módulo no se activa después, suele ser por esto.

En el Administrador de archivos, localiza la carpeta del módulo que acabas de extraer (por ejemplo, modules/mimodulo).
Haz clic derecho sobre la carpeta y selecciona "Permisos" o "Change Permissions".
Establece los permisos en 755 para las carpetas y 644 para los archivos. Si ves una opción de "Recursivo", actívala para aplicar a todo el contenido.
Guarda los cambios.

[INFO] Los permisos 755 significan: el propietario puede leer, escribir y ejecutar; el grupo y otros solo pueden leer y ejecutar. Es el estándar para archivos web.

Paso 4: Activar el módulo desde el backoffice de PrestaShop

Ahora vuelve a tu panel de administración de PrestaShop (normalmente en /admin o la URL que configuraste).

Ve a "Módulos" > "Gestor de módulos" (o "Módulos y servicios" según la versión).
En la lista de módulos, busca el que acabas de subir. Puede aparecer automáticamente o necesitar un clic en "Buscar módulos".
Si no aparece, prueba a limpiar la caché de PrestaShop: ve a "Parámetros de la tienda" > "Rendimiento" y haz clic en "Limpiar caché".
Una vez localizado, haz clic en "Instalar" o "Activar". El módulo se integrará y podrás configurarlo.

[TIP] Si el módulo no se muestra, verifica que el nombre de la carpeta coincida exactamente con el nombre del módulo en el código (sin espacios ni caracteres extraños).

Solución de problemas comunes (FAQ)

El módulo no aparece después de subirlo

Causa: La carpeta no está en la ubicación correcta o el nombre es incorrecto.
Solución: Revisa que esté dentro de modules y que el nombre de la carpeta sea el mismo que el del módulo (por ejemplo, ps_facebook y no ps-facebook).

Error de permisos al instalar

Causa: La carpeta del módulo no tiene permisos 755 o los archivos no tienen 644.
Solución: Vuelve al paso 3 y aplica permisos recursivos.

El módulo se instaló pero da error de "clase no encontrada"

Causa: El módulo requiere una versión específica de PHP o de PrestaShop.
Solución: Verifica los requisitos del módulo en su documentación. Puedes cambiar la versión de PHP desde Plesk en "Configuración de PHP".

[WARNING] No instales módulos de fuentes no oficiales. Pueden contener malware o ser incompatibles. Siempre descarga desde el marketplace de PrestaShop o de desarrolladores de confianza.

Consejos adicionales para gestionar módulos desde Plesk

Actualización manual: Cuando quieras actualizar un módulo, repite el proceso: sube el nuevo ZIP, extrae y sobrescribe la carpeta existente. Luego ve al backoffice y haz clic en "Actualizar" si aparece.
Copia de seguridad: Antes de instalar un módulo nuevo, haz una copia de seguridad de tu tienda. En Plesk puedes usar la herramienta "Copias de seguridad" para respaldar la base de datos y los archivos.
Módulos que modifican la base de datos: Algunos módulos crean tablas SQL. Si desinstalas el módulo, estas tablas pueden quedar huérfanas. Revisa la documentación para limpiarlas manualmente si es necesario.

¿Y si uso Syspanel en lugar de Plesk?

Si tu hosting utiliza Syspanel (antes HestiaCP), el proceso es muy similar. La principal diferencia es que el acceso se realiza por el puerto 2106 (por ejemplo, https://tudominio.com:2106). Dentro de Syspanel, busca la sección "Archivos" o "File Manager" para subir y extraer el ZIP. Los permisos se configuran de la misma forma. El resto de pasos (activación en backoffice) son idénticos.

[INFO] Syspanel también permite gestionar bases de datos y dominios. Si tienes dudas, consulta la documentación de tu proveedor de hosting.

Conclusión

Instalar módulos en PrestaShop desde Plesk es un proceso sencillo que te da control total sobre tu tienda. Siguiendo esta guía básica, podrás añadir funcionalidades sin depender del gestor interno y resolver problemas comunes como permisos o falta de visibilidad. Recuerda siempre verificar la compatibilidad del módulo con tu versión de PrestaShop y PHP, y mantener copias de seguridad periódicas.

Si encuentras algún error, no dudes en repasar los pasos: subir el ZIP, extraer en la carpeta correcta, ajustar permisos y activar desde el backoffice. Con práctica, lo harás en cuestión de minutos. ¡Tu tienda online merece tener los mejores módulos!