Instalar módulos PrestaShop manualmente en Plesk

Si estás gestionando tu tienda online con PrestaShop y tu hosting utiliza Plesk, es probable que en algún momento necesites instalar módulos PrestaShop en Plesk de forma manual. Aunque el panel de administración de PrestaShop permite subir módulos directamente, hacerlo a través del panel de control Plesk te da un control más fino sobre los archivos, especialmente si el módulo es pesado, tiene dependencias especiales o si tu tienda está en un entorno con restricciones de PHP.

En esta guía, te explicaré paso a paso cómo realizar este proceso de manera segura y sin complicaciones. No necesitas ser un experto técnico, solo seguir las instrucciones al pie de la letra. Además, incluiremos consejos útiles para evitar errores comunes y optimizar el rendimiento de tu PrestaShop módulos manual.

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

Instalar módulos desde el backoffice de PrestaShop es cómodo, pero a veces falla por límites de tamaño de archivo, tiempos de ejecución o problemas de permisos. Al hacerlo manualmente a través de Plesk, tú tienes el control total. Esto es especialmente útil para:

Módulos grandes (más de 20 MB).
Módulos que requieren modificar archivos del núcleo.
Entornos de desarrollo o pruebas.
Evitar errores de conexión o subida.

Además, si alguna vez has usado Syspanel (el antiguo HestiaCP, que se accede por el puerto 2106), verás que el flujo es similar, pero en Plesk es aún más visual y amigable.

Requisitos previos

Antes de empezar, asegúrate de tener lo siguiente:

Acceso al panel de control Plesk de tu hosting.
Credenciales de FTP o SFTP (o acceso al administrador de archivos de Plesk).
El archivo ZIP del módulo que deseas instalar (descargado de una fuente confiable, como el marketplace oficial de PrestaShop o el desarrollador).
Conocimiento básico de la estructura de carpetas de PrestaShop (no te preocupes, te guiaré).

[INFO] Si tu plan de hosting usa Syspanel (antes HestiaCP), recuerda que la URL de acceso suele ser algo como https://tudominio.com:2106. El proceso manual es similar, pero las rutas pueden variar ligeramente.

Paso 1: Accede al administrador de archivos de Plesk

El método más sencillo para instalar módulos PrestaShop Plesk sin necesidad de cliente FTP es usar el administrador de archivos integrado.

Inicia sesión en tu panel de Plesk.
En el menú lateral, busca la sección Archivos o Administrador de archivos.
Navega hasta la carpeta raíz de tu tienda PrestaShop. Normalmente es httpdocs o public_html. Si tienes varios dominios, selecciona el correspondiente.

Una vez dentro, verás la estructura de carpetas de PrestaShop: admin, classes, config, modules, etc.

Paso 2: Localiza la carpeta de módulos

La carpeta donde se almacenan todos los módulos de PrestaShop se llama modules. Está en la raíz de tu instalación.

Si tu tienda está en /var/www/vhosts/tudominio.com/httpdocs/, la ruta completa sería:
/var/www/vhosts/tudominio.com/httpdocs/modules/

Dentro de esta carpeta, cada módulo tiene su propia subcarpeta con el nombre del módulo (por ejemplo, ps_banner, paypal, etc.).

[WARNING] No confundas la carpeta modules con otras carpetas similares. La correcta es la que está al mismo nivel que img, themes, override, etc.

Paso 3: Sube el archivo ZIP del módulo

Ahora vamos a añadir módulo PrestaShop manualmente. Hay dos formas: subir el ZIP directamente y descomprimirlo en Plesk, o subir la carpeta ya descomprimida. Recomiendo la primera por ser más limpia.

En el administrador de archivos de Plesk, haz clic en Subir archivos (o el botón correspondiente).
Selecciona el archivo .zip de tu módulo desde tu computadora.
Espera a que termine la subida. Si el archivo es grande (más de 50 MB), puede tardar unos minutos.

Una vez subido, verás el archivo ZIP en la lista de archivos de la carpeta modules.

Paso 4: Descomprime el módulo

Ahora necesitas extraer el contenido del ZIP dentro de la carpeta modules.

Haz clic derecho sobre el archivo ZIP subido.
Selecciona la opción Extraer o Descomprimir.
Confirma que quieres extraer los archivos en la misma ubicación (la carpeta modules).
Plesk creará automáticamente una subcarpeta con el nombre del módulo.

Después de la extracción, puedes eliminar el archivo ZIP para mantener ordenado.

[TIP] Si el módulo tiene una estructura compleja (por ejemplo, con archivos de configuración adicionales), asegúrate de que la carpeta extraída no tenga otra carpeta anidada. Debe quedar algo como: modules/nombre_modulo/ con los archivos directamente dentro.

Paso 5: Verifica los permisos de archivos

Los módulos de PrestaShop necesitan permisos de lectura y escritura para funcionar correctamente, especialmente si van a crear tablas en la base de datos o modificar archivos de configuración.

En el administrador de archivos, localiza la carpeta del módulo recién creada.
Haz clic derecho sobre ella y selecciona Permisos o Cambiar permisos.
Establece los permisos a 755 para las carpetas y 644 para los archivos. Si tu hosting usa Syspanel, esto se hace desde la sección de archivos.
Si el módulo requiere permisos de escritura (por ejemplo, para logs o caché), puedes usar 777 temporalmente, pero luego revierte a 755.

[WARNING] No dejes permisos 777 permanentemente, ya que es un riesgo de seguridad. Úsalo solo si el módulo lo exige y cámbialo después.

Paso 6: Instala el módulo desde el backoffice de PrestaShop

Una vez que los archivos están en su lugar, debes registrar el módulo en PrestaShop.

Accede a tu panel de administración de PrestaShop (ej: tudominio.com/admin1234).
Ve a Módulos > Gestor de módulos.
En la parte superior, haz clic en Subir un módulo.
Si el módulo ya está en la carpeta, no necesitas subirlo de nuevo. Simplemente busca el módulo en la lista (puede aparecer como "no instalado").
Haz clic en Instalar junto al nombre del módulo.

PrestaShop leerá los archivos de configuración del módulo (como config.xml o el archivo principal PHP) y lo activará.

[INFO] Si el módulo no aparece en la lista, verifica que el nombre de la carpeta coincida exactamente con el nombre del módulo en el archivo principal (por ejemplo, mimodulo.php debe estar dentro de modules/mimodulo/).

Paso 7: Configura el módulo (si es necesario)

Muchos módulos requieren configuración adicional después de la instalación. Una vez instalado, verás un botón Configurar o Ajustes. Haz clic y sigue las instrucciones del desarrollador.

Algunos módulos pueden necesitar:

Crear tablas en la base de datos (lo hacen automáticamente al instalar).
Configurar claves de API.
Ajustar opciones de visualización.

Si encuentras errores, revisa los logs de PrestaShop en Parámetros avanzados > Registros o en el servidor (en Plesk, ve a Registros de errores en la sección de tu dominio).

Solución de problemas comunes

Error: "El módulo no se puede instalar"

Esto suele deberse a:

La carpeta del módulo no está en la ubicación correcta.
Faltan archivos esenciales (como el archivo PHP principal).
Permisos incorrectos.

Verifica que la estructura sea: modules/nombre_modulo/nombre_modulo.php.

Error: "No se puede subir el archivo"

Si el módulo es muy grande, el límite de subida de PHP puede estar restringido. En Plesk, puedes aumentar este límite desde Configuración de PHP (en la sección de tu dominio). Busca upload_max_filesize y post_max_size y ajústalos a un valor mayor (por ejemplo, 64M).

El módulo no aparece en el backoffice

Revisa que el nombre de la carpeta no tenga espacios ni caracteres especiales. También asegúrate de que el archivo principal del módulo tenga el mismo nombre que la carpeta (por ejemplo, micodigo.php dentro de micodigo/).

[TIP] Si usas Syspanel (HestiaCP), el proceso es idéntico, solo cambia la interfaz. El puerto 2106 te da acceso a un panel similar a Plesk pero con menos opciones gráficas.

Preguntas frecuentes (FAQ)

¿Puedo instalar módulos de PrestaShop sin usar Plesk?

Sí, también puedes usar FTP o SFTP. El proceso es el mismo: subir la carpeta del módulo a modules/ y luego instalarlo desde el backoffice. Plesk solo facilita la gestión de archivos.

¿Qué hago si el módulo requiere modificar la base de datos?

La mayoría de los módulos lo hacen automáticamente al instalarse. Si no, el desarrollador suele incluir un archivo SQL que debes ejecutar desde phpMyAdmin (accesible desde Plesk en Bases de datos).

¿Es seguro instalar módulos manualmente?

Sí, siempre que descargues el módulo de fuentes oficiales o de confianza. Al hacerlo manualmente, evitas riesgos de archivos corruptos durante la subida por web.

¿Puedo instalar módulos gratuitos y de pago de la misma forma?

Exactamente. El método manual funciona para cualquier tipo de módulo, sin importar su origen.

¿Qué pasa si el módulo no es compatible con mi versión de PrestaShop?

PrestaShop suele mostrar un mensaje de advertencia. Si el módulo no es compatible, puede causar errores. Siempre verifica la compatibilidad antes de instalar.

Conclusión

Instalar módulos PrestaShop Plesk manualmente es una habilidad muy útil que te dará independencia y control sobre tu tienda. Aunque al principio pueda parecer técnico, con esta guía paso a paso verás que es sencillo. Recuerda siempre hacer una copia de seguridad de tu tienda antes de instalar módulos nuevos, por si algo sale mal.

Ahora ya sabes cómo añadir módulo PrestaShop sin depender de subidas web que fallen. Si tu hosting usa Syspanel (HestiaCP, puerto 2106), el proceso es esencialmente el mismo, solo cambia la interfaz. ¡Manos a la obra y personaliza tu tienda al máximo!

[INFO] Si tienes dudas durante el proceso, no dudes en contactar al soporte técnico de tu hosting. Ellos pueden ayudarte a verificar permisos o rutas específicas.