Instalar módulos PrestaShop manualmente en DirectAdmin | Guía

Sabemos que gestionar tu tienda PrestaShop implica, en algún momento, tener que añadir nuevas funcionalidades. Los módulos son la pieza clave para personalizar tu negocio, desde mejorar el SEO hasta integrar pasarelas de pago. Aunque el panel de administración de PrestaShop permite instalar módulos de forma automática, a veces te encuentras con errores de compatibilidad, límites de tamaño de archivo o simplemente prefieres tener un control total del proceso.

Aquí es donde entra en juego la instalación manual. Si tu tienda está alojada en un servidor con DirectAdmin, este proceso es más sencillo de lo que parece. En esta guía detallada, te explicaré paso a paso cómo instalar módulos PrestaShop de forma manual usando DirectAdmin, sin necesidad de plugins adicionales ni conocimientos avanzados de programación. Al final, tendrás el control absoluto de tu tienda.

¿Por qué instalar módulos PrestaShop de forma manual en DirectAdmin?

Antes de lanzarnos a los pasos, es importante entender cuándo y por qué es mejor hacerlo manualmente. La instalación automática desde el backoffice de PrestaShop es cómoda, pero tiene limitaciones:

Límite de tamaño del servidor: Muchos módulos premium (como los de SEO avanzado, catálogos grandes o importadores masivos) superan los 2MB o 10MB que algunos servidores permiten subir por PHP.
Errores de conexión: A veces el servidor de PrestaShop o tu propia conexión fallan, dejando el módulo a medio instalar.
Módulos personalizados: Si has contratado a un desarrollador o has descargado un módulo de un repositorio externo, no aparecerá en el marketplace oficial.
Control total: Al hacerlo manual, sabes exactamente dónde se aloja cada archivo y puedes solucionar conflictos más rápido.

Al usar DirectAdmin PrestaShop módulos, accedes directamente al sistema de archivos de tu hosting, lo que te permite saltarte cualquier restricción del panel de administración. Es como tener la llave maestra de tu tienda.

Requisitos previos: Lo que necesitas antes de empezar

Para que todo funcione sin problemas, asegúrate de tener esto listo:

Acceso a DirectAdmin: Tus credenciales de usuario (nombre de usuario y contraseña) proporcionadas por tu proveedor de hosting.
El archivo del módulo: Debe ser un archivo comprimido en formato .zip o .tar.gz. No lo descomprimas en tu ordenador; lo subiremos tal cual.
Conocimiento de la carpeta raíz de PrestaShop: Normalmente es /public_html o /domains/tudominio.com/public_html. Si no estás seguro, revisa la configuración de tu dominio en DirectAdmin.
Cliente FTP o el Administrador de Archivos de DirectAdmin: Usaremos este último, que es más visual y no requiere programas externos.

[WARNING] IMPORTANTE: Antes de cualquier modificación, haz una copia de seguridad completa de tu tienda (archivos y base de datos). Un módulo mal instalado puede dejar tu web en blanco. Si algo sale mal, podrás restaurar todo en minutos.

Paso a paso: Cómo instalar módulos PrestaShop manualmente en DirectAdmin

Sigue estas instrucciones al pie de la letra. Son universales para cualquier versión de PrestaShop (1.6, 1.7, 8.x) y funcionan en cualquier servidor con DirectAdmin.

1. Accede a DirectAdmin y localiza el Administrador de Archivos

Abre tu navegador y escribe la URL de acceso a DirectAdmin. Normalmente es algo como https://tudominio.com:2222. Introduce tu usuario y contraseña.

Una vez dentro, busca el icono que dice "Administrador de Archivos" (File Manager). Si no lo ves, puede estar en la sección "Avanzado" o "Cuenta de usuario". Haz clic para abrirlo.

2. Navega hasta la carpeta de módulos de PrestaShop

En el Administrador de Archivos, verás una estructura de carpetas similar a la de tu ordenador. Debes llegar a la carpeta donde PrestaShop guarda todos los módulos. La ruta típica es:

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

tuusuario es tu nombre de usuario de hosting.
tudominio.com es el dominio de tu tienda.
public_html es la carpeta raíz web (a veces se llama httpdocs o www).
modules es la carpeta destino.

Si tienes dudas, dentro de public_html busca una carpeta llamada modules. Ahí es donde debes trabajar.

3. Sube el archivo ZIP del módulo

En la carpeta modules, busca el botón "Subir archivos" (Upload). Se abrirá una ventana para seleccionar archivos.

Selecciona el archivo .zip de tu módulo desde tu ordenador.
Espera a que la barra de progreso llegue al 100%. No cierres la ventana hasta que termine.

Verás que el archivo ZIP aparece ahora en la lista de archivos dentro de la carpeta modules.

4. Descomprime el archivo ZIP

DirectAdmin tiene un descompresor integrado. Haz clic derecho sobre el archivo ZIP que acabas de subir y selecciona la opción "Extraer" (Extract) o "Descomprimir".

Se te preguntará dónde extraerlo. Asegúrate de que la ruta de destino sea la misma carpeta modules (suele estar seleccionada por defecto). Haz clic en "Extraer".

El sistema creará automáticamente una nueva carpeta con el nombre del módulo (por ejemplo, ps_googleanalytics, customseo, etc.).

[TIP] Si el módulo no se descomprime correctamente, puede que el archivo ZIP esté dañado o protegido. Prueba a descargarlo de nuevo desde la fuente oficial. También puedes usar un programa como 7-Zip en tu PC para verificar que el ZIP no tenga errores.

5. Verifica la estructura de la carpeta del módulo

Una vez descomprimido, es crucial que la carpeta del módulo contenga los archivos correctos. Dentro de la nueva carpeta (la que se creó al extraer), debe haber al menos:

Un archivo index.php (normalmente en blanco o con una redirección).
Un archivo principal .php con el nombre del módulo (ej: ps_googleanalytics.php).
Una carpeta views o controllers (opcional, pero común).

Si la carpeta contiene solo otro ZIP o una subcarpeta con el mismo nombre, significa que el ZIP estaba anidado. En ese caso, mueve el contenido de la subcarpeta directamente a la carpeta principal del módulo.

6. Instala el módulo desde el backoffice de PrestaShop

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

Ve a Módulos > Gestor de módulos.
En la lista de módulos, busca el que acabas de subir. No aparecerá automáticamente si no se ha refrescado la caché. Para forzarlo, haz clic en el botón "Buscar módulos" o en el icono de "Actualizar" (suele ser una flecha circular).
Una vez que aparezca, verás un botón "Instalar". Haz clic en él.

PrestaShop leerá los archivos, registrará el módulo en la base de datos y te pedirá que configures los permisos básicos. ¡Listo! El módulo ya está activo.

[INFO] Si el módulo no aparece tras actualizar, limpia la caché de PrestaShop desde Parámetros de la tienda > Rendimiento > Limpiar caché. También puedes borrar manualmente la carpeta /var/cache de tu instalación (a través de DirectAdmin) para forzar una recarga completa.

Solución de problemas comunes al instalar módulos PrestaShop manualmente

A veces, aunque sigas los pasos al pie de la letra, pueden surgir errores. Aquí tienes los más frecuentes y cómo resolverlos:

El módulo no aparece en el backoffice

Causa 1: La carpeta del módulo no está en la ruta correcta. Revisa que esté dentro de /public_html/modules y no en una subcarpeta adicional.
Causa 2: El nombre de la carpeta no coincide exactamente con el nombre del módulo en el archivo PHP. Por ejemplo, si el módulo se llama miseo.php, la carpeta debe llamarse miseo (todo en minúsculas, sin espacios).
Solución: Renombra la carpeta desde DirectAdmin para que coincida con el nombre del archivo principal.

Error "No se puede instalar el módulo" o "Archivo no encontrado"

Causa: El archivo ZIP se ha subido incompleto o está corrupto.
Solución: Vuelve a descargar el módulo desde la fuente oficial. Asegúrate de que el peso del archivo en tu PC coincida con el que ves en DirectAdmin (haz clic derecho sobre el ZIP en DirectAdmin y selecciona "Propiedades" para ver el tamaño).

La web se vuelve blanca (pantalla en blanco) tras instalar el módulo

Causa: El módulo tiene un conflicto con otro módulo o con la versión de PHP.
Solución: Accede a DirectAdmin, ve a la carpeta /public_html/modules, localiza la carpeta del módulo problemático y cámbiale el nombre (añade algo como _old al final). Esto lo desactivará forzosamente. Luego, desde el backoffice de PrestaShop, desinstálalo oficialmente.

[WARNING] Si no puedes acceder ni al backoffice, usa DirectAdmin para renombrar la carpeta del módulo. La web debería recuperarse automáticamente. Después, investiga la compatibilidad del módulo con tu versión de PrestaShop.

Preguntas frecuentes (FAQ) sobre módulos PrestaShop manuales

Aquí respondemos las dudas más comunes que nos llegan al soporte técnico:

¿Puedo instalar módulos de pago que compré en otro sitio?

Sí, siempre que tengas el archivo ZIP original. El proceso manual es el mismo. Asegúrate de que el módulo no esté enlazado a un dominio específico (algunos desarrolladores lo hacen). Si es el caso, contacta al vendedor para que te dé una licencia válida para tu dominio.

¿Qué hago si el módulo requiere una versión de PHP específica?

En DirectAdmin, puedes cambiar la versión de PHP desde el panel de "Selector de PHP" (a veces llamado "PHP Version Selector"). Busca esa opción en DirectAdmin, selecciona tu dominio y elige la versión que recomiende el módulo (por ejemplo, 7.4 u 8.1). Guarda los cambios y espera unos minutos.

¿Cómo desinstalo un módulo instalado manualmente?

Desde el backoffice de PrestaShop, ve al módulo y haz clic en "Desinstalar". Luego, desde DirectAdmin, puedes eliminar la carpeta del módulo dentro de /public_html/modules. Esto libera espacio y evita conflictos futuros.

¿Es seguro instalar módulos manualmente?

Sí, siempre que el módulo provenga de una fuente confiable. Al hacerlo manual, evitas errores de subida del backoffice, pero no te libra de módulos mal codificados. Siempre revisa las reseñas y la reputación del desarrollador.

Mi hosting usa Syspanel (HestiaCP) en lugar de DirectAdmin, ¿cambio algo?

Si tu panel es Syspanel (HestiaCP), el proceso es muy similar. La principal diferencia es que el puerto de acceso al panel suele ser el 2106 (ej: https://tudominio.com:2106). Dentro de Syspanel, busca "Administrador de Archivos" y sigue los mismos pasos: navega a /public_html/modules, sube el ZIP y descomprime. El resto es idéntico.

Consejos finales para una gestión eficiente de módulos

Mantén un registro: Lleva una lista de los módulos que instalas manualmente, con su versión y fecha. Esto te ayudará en futuras actualizaciones.
Actualiza con cuidado: Cuando un módulo se actualice, repite el proceso manual: elimina la carpeta antigua (después de desinstalar desde el backoffice) y sube la nueva versión.
Prueba en un entorno de desarrollo: Si tienes un subdominio o una copia de prueba, instala el módulo allí primero. Así evitas sorpresas en tu tienda en producción.
Usa la caché con cabeza: Después de instalar un módulo, limpia la caché de PrestaShop y la del navegador para ver los cambios correctamente.

Conclusión

Instalar módulos PrestaShop manualmente a través de DirectAdmin te da un control absoluto sobre tu tienda, evitando los límites de tamaño y los errores de conexión del backoffice. Aunque al principio pueda parecer un proceso técnico, con esta guía paso a paso verás que es tan sencillo como subir un archivo y descomprimirlo.

Recuerda: la clave está en la paciencia y en seguir la ruta exacta (/public_html/modules). Si en algún momento te sientes perdido, tu proveedor de hosting o el soporte del módulo pueden darte una mano extra. Ahora ya sabes cómo hacerlo, ¡manos a la obra y a personalizar tu tienda sin límites!