Instalar módulos PrestaShop manualmente en DirectAdmin

Introducción

Si tienes una tienda en PrestaShop alojada en un servidor con panel DirectAdmin, probablemente quieras ampliar sus funcionalidades mediante módulos. Aunque PrestaShop permite instalar módulos desde su propio mercado, a veces necesitas instalar módulos PrestaShop DirectAdmin de forma manual, ya sea porque adquiriste un módulo de terceros, porque necesitas una versión específica, o porque tu tienda no está conectada al marketplace.

Esta guía está diseñada para que cualquier persona, incluso sin experiencia técnica avanzada, pueda añadir módulos PrestaShop paso a paso. No necesitas ser un experto en servidores, solo seguir las instrucciones con cuidado. Vamos a usar DirectAdmin FTP PrestaShop para subir los archivos, y luego activaremos el módulo desde el panel de administración.

[INFO] Esta guía asume que ya tienes acceso a DirectAdmin y a tu panel de administración de PrestaShop. Si no es así, contacta con tu proveedor de hosting.

¿Qué necesitas antes de empezar?

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

Acceso a DirectAdmin: Necesitas las credenciales de tu cuenta de hosting (usuario y contraseña). Si usas Syspanel (antes conocido como HestiaCP), el puerto de acceso es el 2106, pero en este artículo nos centramos en DirectAdmin.
Cliente FTP o el gestor de archivos de DirectAdmin: Puedes usar FileZilla (gratuito) o el propio gestor de archivos del panel.
El módulo en formato ZIP: Normalmente los módulos vienen comprimidos. No lo descomprimas aún.
Credenciales de administrador de PrestaShop: Para activar el módulo una vez subido.

[WARNING] Asegúrate de que el módulo sea compatible con tu versión de PrestaShop. De lo contrario, podrías romper la tienda.

Paso 1: Acceder a DirectAdmin y localizar la carpeta de PrestaShop

El primer paso para añadir módulos PrestaShop es acceder al servidor donde está alojada tu tienda.

Abre tu navegador y escribe la URL de acceso a DirectAdmin (normalmente algo como https://tudominio.com:2222). Si tu proveedor usa Syspanel, recuerda que el puerto es el 2106.
Inicia sesión con tu usuario y contraseña.
Una vez dentro, busca la sección "Gestor de archivos" (File Manager). En DirectAdmin suele estar en el menú principal o en la sección "Administración de archivos".

Dentro del gestor de archivos, navega hasta la carpeta donde está instalado PrestaShop. Normalmente es algo como:

/home/tuusuario/domains/tudominio.com/public_html/

Dentro de public_html, busca la carpeta modules. Esa es la carpeta donde se almacenan todos los módulos de tu tienda.

[TIP] Si no ves la carpeta modules, asegúrate de que estás en la raíz de PrestaShop. Puede estar dentro de public_html o en una subcarpeta si tienes varias tiendas.

Paso 2: Subir el módulo mediante FTP o gestor de archivos

Ahora que ya sabes dónde está la carpeta, vamos a instalar módulos PrestaShop DirectAdmin subiendo el archivo ZIP.

Opción A: Usando el gestor de archivos de DirectAdmin

En el gestor de archivos, haz clic en "Subir archivos" (Upload).
Selecciona el archivo ZIP del módulo desde tu computadora.
Espera a que termine la subida. Verás el archivo en la lista de la carpeta modules.
Ahora, selecciona el archivo ZIP y haz clic en "Extraer" (Extract). El sistema lo descomprimirá automáticamente en una carpeta con el nombre del módulo.
Una vez extraído, puedes eliminar el archivo ZIP para mantener orden.

Opción B: Usando un cliente FTP como FileZilla

Abre FileZilla y conecta usando los datos FTP que te proporcionó tu hosting (servidor, usuario, contraseña y puerto 21).
Navega hasta la carpeta public_html/modules en el servidor (lado derecho).
En tu computadora (lado izquierdo), localiza el archivo ZIP del módulo.
Arrastra el archivo ZIP a la carpeta modules del servidor.
Una vez subido, desde DirectAdmin o desde el propio FileZilla, extrae el contenido. En FileZilla no puedes extraer directamente, así que tendrás que hacerlo desde el gestor de archivos de DirectAdmin.

[INFO] Si el módulo ya viene descomprimido (en una carpeta), simplemente arrastra la carpeta entera a modules. No necesitas extraer nada.

Paso 3: Verificar que la carpeta del módulo esté correcta

Después de extraer, es importante comprobar que la estructura sea la correcta. Dentro de la carpeta modules, deberías ver una nueva carpeta con el nombre del módulo (por ejemplo, micromodulo). Dentro de esa carpeta debe haber al menos un archivo llamado micromodulo.php (el nombre puede variar). Si ves archivos sueltos o una subcarpeta adicional, algo salió mal.

[WARNING] Si el módulo tiene una estructura incorrecta, PrestaShop no lo reconocerá. Asegúrate de que el archivo principal del módulo esté en la raíz de la carpeta del módulo, no en subcarpetas.

Paso 4: Activar el módulo desde el panel de administración de PrestaShop

Ahora que los archivos están en su lugar, toca añadir módulos PrestaShop al sistema.

Accede a tu panel de administración de PrestaShop (normalmente tudominio.com/admin).
Ve a la sección "Módulos" > "Gestor de módulos".
En la parte superior, verás un botón que dice "Subir un módulo" (o similar). Haz clic ahí.
Aunque ya subiste el módulo por FTP, PrestaShop a veces necesita un "refresh". Si no aparece en la lista, busca el nombre del módulo en el buscador.
Si el módulo aparece, haz clic en "Instalar". Si no aparece, prueba a recargar la página o ve al paso siguiente.

[TIP] Si el módulo no aparece después de subirlo, puede que necesites ir a "Módulos" > "Catálogo de módulos" y hacer clic en "Comprobar actualizaciones" para forzar a PrestaShop a escanear la carpeta.

Una vez instalado, configura el módulo según las instrucciones del desarrollador.

Solución de problemas comunes

A veces surgen inconvenientes al instalar módulos PrestaShop manual. Aquí tienes los más frecuentes:

El módulo no aparece en el gestor

Causa: La carpeta del módulo no tiene los permisos correctos o está mal estructurada.
Solución: Ve a DirectAdmin, haz clic derecho en la carpeta del módulo y selecciona "Cambiar permisos". Pon 755 (o 0755) en todos los archivos y carpetas. Luego recarga el panel de PrestaShop.

Error de compatibilidad al instalar

Causa: El módulo no es compatible con tu versión de PrestaShop.
Solución: Revisa la documentación del módulo o contacta al desarrollador. A veces puedes forzar la instalación editando el archivo config.xml dentro de la carpeta del módulo, pero no es recomendable.

Error 500 o página en blanco

Causa: Conflicto con otro módulo o error en el código.
Solución: Desactiva el módulo desde el panel (si puedes acceder) o elimina la carpeta del módulo por FTP. Luego verifica los logs de error en DirectAdmin (sección "Gestor de errores").

[WARNING] Siempre haz una copia de seguridad de tu tienda antes de instalar módulos manualmente. Un módulo defectuoso puede dejar tu tienda inaccesible.

Preguntas frecuentes (FAQ)

¿Puedo instalar módulos PrestaShop DirectAdmin sin FTP?

Sí, usando el gestor de archivos de DirectAdmin es igual de fácil. Solo necesitas subir el ZIP y extraerlo.

¿Qué hago si el módulo tiene varios archivos?

No importa, mientras estén dentro de la carpeta del módulo. PrestaShop solo necesita el archivo principal PHP.

¿Se puede instalar un módulo desde la nube (Google Drive, Dropbox)?

No directamente. Debes descargarlo a tu computadora y luego subirlo al servidor.

¿Cómo sé si mi versión de PrestaShop es compatible?

Revisa la descripción del módulo. Normalmente dice "Compatibilidad: PrestaShop 1.7.x" o similar. Si no, contacta al vendedor.

¿Puedo usar Syspanel (HestiaCP) para lo mismo?

Sí, pero recuerda que el puerto de acceso es el 2106. El proceso es similar: usa el gestor de archivos de Syspanel para subir y extraer el módulo.

Conclusión

Instalar módulos PrestaShop DirectAdmin de forma manual no es complicado si sigues los pasos adecuados. Solo necesitas acceso al panel, saber dónde está la carpeta modules, y usar el gestor de archivos o FTP. Recuerda siempre verificar la compatibilidad y hacer copias de seguridad.

Ahora ya sabes cómo añadir módulos PrestaShop sin depender del marketplace. ¡Anímate a personalizar tu tienda con las herramientas que necesitas!

[TIP] Si tienes dudas, busca en foros especializados o contacta a tu proveedor de hosting. La comunidad PrestaShop es muy activa y siempre hay alguien dispuesto a ayudar.