Preguntas frecuentes: Módulos PrestaShop en DirectAdmin

Introducción: ¿Por qué una FAQ sobre módulos en PrestaShop y DirectAdmin?

Si tienes una tienda online con PrestaShop, sabes que los módulos son el alma de tu negocio. Te permiten añadir funcionalidades como pasarelas de pago, envíos, SEO, marketing o personalización del diseño. Sin embargo, la configuración de estos módulos puede volverse un dolor de cabeza si no sabes cómo acceder a los archivos del servidor o gestionar los permisos. Aquí entra DirectAdmin, un panel de control de hosting que te da acceso directo a los archivos de tu tienda. En esta FAQ, resolveremos las dudas más comunes sobre cómo instalar y configurar módulos en PrestaShop usando DirectAdmin. Todo explicado paso a paso, sin tecnicismos complicados.

[INFO] Esta guía está pensada para usuarios que ya tienen PrestaShop instalado y acceso a DirectAdmin. Si todavía no tienes tu tienda montada, primero completa la instalación básica.

¿Qué es DirectAdmin y por qué lo necesito para mis módulos de PrestaShop?

DirectAdmin es un panel de control que usan muchos proveedores de hosting para gestionar servidores. Con él puedes subir archivos, crear bases de datos, gestionar correos y, lo más importante para nosotros, acceder al directorio raíz de tu PrestaShop. Al instalar o configurar módulos, a veces necesitas modificar archivos manualmente (por ejemplo, .htaccess, config/defines.inc.php o carpetas de módulos). DirectAdmin te da las herramientas para hacerlo de forma segura.

¿Qué puedo hacer con DirectAdmin para mis módulos?

Subir módulos manualmente cuando la instalación automática falla.
Editar archivos de configuración (como parameters.php o settings.inc.php).
Cambiar permisos de carpetas para que los módulos puedan escribir archivos.
Ver logs de errores si un módulo no funciona.

[TIP] Si tu hosting usa Syspanel (HestiaCP), el acceso es similar pero con puerto 2106. En este artículo nos centramos en DirectAdmin, pero los pasos son casi idénticos.

Pregunta 1: ¿Cómo instalar módulos en PrestaShop desde DirectAdmin?

La forma más común de instalar un módulo es desde el backoffice de PrestaShop (menú "Módulos" > "Módulos y servicios"). Pero a veces el módulo no aparece en el marketplace o necesitas una versión personalizada. Ahí es donde DirectAdmin te salva.

Paso a paso para instalar un módulo manualmente con DirectAdmin

Descarga el módulo: Normalmente viene en un archivo .zip o .tar.gz. Asegúrate de que sea compatible con tu versión de PrestaShop.
Accede a DirectAdmin: Abre tu navegador, escribe la URL de tu panel (ejemplo: tudominio.com:2222) e inicia sesión con tus credenciales de hosting.
Ve al gestor de archivos: Busca la opción "File Manager" o "Administrador de archivos". Se abrirá una ventana con la estructura de carpetas de tu hosting.
Localiza la carpeta de módulos: En PrestaShop, los módulos se guardan en public_html/modules/ (o www/modules/ si tu servidor usa otra estructura). Navega hasta allí.
Sube el módulo: Haz clic en "Subir" y selecciona el archivo .zip. DirectAdmin lo descomprimirá automáticamente. Si no, usa la opción "Extraer" después de subirlo.
Verifica los permisos: La carpeta del módulo debe tener permisos 755 (lectura y ejecución para todos, escritura solo para el usuario). Si ves 644 o 777, cámbialo desde el menú de propiedades del archivo.
Instala desde el backoffice: Ve a tu PrestaShop, en "Módulos" > "Módulos y servicios", busca el módulo recién subido y haz clic en "Instalar".

[WARNING] Si el módulo no aparece en el backoffice, revisa que el nombre de la carpeta coincida exactamente con el nombre del módulo (sin espacios ni caracteres extraños). También verifica que el archivo index.php esté presente.

Pregunta 2: ¿Cómo configurar un módulo de PrestaShop después de instalarlo?

Una vez instalado, la configuración suele hacerse desde el backoffice, pero algunos módulos requieren ajustes en archivos del servidor. Por ejemplo, módulos de pago o envío pueden necesitar claves API o rutas de archivos.

Configuración básica desde DirectAdmin

Editar archivos de configuración del módulo: Algunos módulos tienen un archivo config.xml o config.php dentro de su carpeta. Ábrelo con el editor de texto de DirectAdmin (haz clic derecho sobre el archivo y selecciona "Edit").
Cambiar permisos de carpetas temporales: Módulos que generan imágenes o PDFs (como facturas) necesitan escribir en public_html/img/ o public_html/modules/. Asegúrate de que la carpeta tenga permisos 755 o 777 temporalmente.
Revisar logs de errores: Si un módulo no funciona, ve a "Logs" en DirectAdmin y busca errores relacionados con PHP o el módulo. Esto te dará pistas.

Ejemplo práctico: Configurar un módulo de pago

Instala el módulo (por ejemplo, PayPal) siguiendo los pasos anteriores.
Ve al backoffice de PrestaShop, en "Módulos" busca PayPal y haz clic en "Configurar".
Allí te pedirá credenciales (Client ID, Secret). Si el módulo no te deja guardar, puede ser por falta de permisos en la carpeta config/ del módulo.
Accede a DirectAdmin, ve a public_html/modules/paypal/ y cambia los permisos de la carpeta config/ a 755.
Vuelve al backoffice y prueba a guardar la configuración.

[TIP] Si el módulo te pide una clave API, búscala en el panel de tu proveedor (PayPal, Stripe, etc.) y cópiala exactamente. Los errores de configuración suelen deberse a claves mal copiadas.

Pregunta 3: ¿Qué hago si un módulo no se instala desde el backoffice?

Esto es más común de lo que parece. Puede deberse a límites de memoria PHP, problemas de permisos o incompatibilidad de versiones.

Soluciones desde DirectAdmin

Aumentar la memoria PHP: En DirectAdmin, ve a "PHP Settings" o "Selector de PHP". Busca la opción memory_limit y cámbiala a 256M o 512M. Guarda los cambios.
Verificar la versión de PHP: PrestaShop 1.7 requiere PHP 7.1 o superior. En DirectAdmin, en "PHP Settings", asegúrate de que la versión sea compatible con tu módulo.
Forzar la instalación manual: Si el backoffice no responde, sube el módulo manualmente como explicamos en la Pregunta 1. Luego, desde el backoffice, ve a "Módulos" y busca el módulo en la lista de "Módulos no instalados". Si no aparece, prueba a refrescar la página o limpiar la caché de PrestaShop (Ajustes > Rendimiento > Limpiar caché).

[WARNING] No subas módulos de fuentes no oficiales. Pueden contener malware o ser incompatibles. Siempre descarga desde el marketplace de PrestaShop o del sitio del desarrollador.

Pregunta 4: ¿Cómo actualizar un módulo de PrestaShop usando DirectAdmin?

Las actualizaciones suelen hacerse desde el backoffice, pero a veces fallan por problemas de permisos. Aquí te enseño a hacerlo manualmente.

Pasos para actualizar un módulo

Descarga la nueva versión del módulo desde el sitio oficial.
Haz una copia de seguridad de la carpeta del módulo actual. En DirectAdmin, selecciona la carpeta (ejemplo: public_html/modules/mimodulo/) y haz clic en "Comprimir" para crear un .zip. Guárdalo en tu PC.
Elimina la carpeta antigua desde el gestor de archivos de DirectAdmin.
Sube la nueva versión como en la instalación manual (Pregunta 1).
Actualiza la base de datos (si es necesario): Algunos módulos requieren ejecutar consultas SQL. Ve a "phpMyAdmin" desde DirectAdmin, selecciona tu base de datos y ejecuta las consultas que vienen en el archivo install.sql del módulo.
Prueba la funcionalidad en el backoffice.

[INFO] Si el módulo tiene una opción de "Actualizar" en el backoffice, úsala primero. Solo recurre a la actualización manual si falla.

Pregunta 5: ¿Cómo solucionar errores comunes de módulos con DirectAdmin?

Error: "No se puede escribir en la carpeta de módulos"

Esto es típico cuando los permisos son incorrectos. En DirectAdmin:

Ve a public_html/modules/.
Selecciona la carpeta del módulo problemático.
Haz clic en "Change Permissions" y pon 755 (o 777 si es necesario, pero solo temporalmente).
Si el error persiste, revisa que el propietario de la carpeta sea el usuario de tu hosting (no "root").

Error: "Módulo no compatible con la versión de PrestaShop"

Verifica la versión de PrestaShop en el backoffice (Ajustes > Información).
Busca una versión del módulo compatible. Si no existe, contacta al desarrollador.
Como último recurso, puedes editar el archivo config.xml del módulo y cambiar la etiqueta <version> para que coincida con la tuya (no recomendado, puede romper la tienda).

Error: "La página no carga después de instalar un módulo"

Esto puede deberse a un conflicto con otros módulos o a un error de PHP. En DirectAdmin:

Revisa los logs de errores en "Logs" > "Error Log".
Desactiva el módulo desde el backoffice (si puedes acceder) o renombra la carpeta del módulo desde DirectAdmin (por ejemplo, cambia public_html/modules/mimodulo a public_html/modules/mimodulo_desactivado).
Limpia la caché de PrestaShop desde el backoffice o eliminando manualmente la carpeta public_html/var/cache/ (si usas PrestaShop 1.7).

[WARNING] No elimines archivos sin hacer una copia de seguridad. Un error puede dejar tu tienda inaccesible.

Pregunta 6: ¿Cómo gestionar módulos de pago o envío con DirectAdmin?

Los módulos de pago y envío suelen requerir integraciones externas (API, webhooks). Aquí tienes algunos consejos:

Módulos de pago: Necesitan claves API. Guárdalas en el backoffice. Si el módulo no las guarda, edita el archivo config.php del módulo desde DirectAdmin y añádelas manualmente (busca variables como $api_key).
Módulos de envío: A veces necesitan rutas de archivos para etiquetas o facturas. Asegúrate de que la carpeta public_html/modules/mimodulo/pdf/ tenga permisos de escritura.
Webhooks: Si el módulo necesita recibir notificaciones de un servicio externo (por ejemplo, confirmación de pago), configura la URL en el panel del proveedor. La URL suele ser https://tudominio.com/modules/mimodulo/validation.php.

[TIP] Para probar si un webhook funciona, usa herramientas como "RequestBin" o revisa los logs de DirectAdmin en tiempo real.

Pregunta 7: ¿Qué hacer si no tengo acceso a DirectAdmin pero sí a Syspanel (HestiaCP)?

Si tu hosting usa Syspanel (HestiaCP), el proceso es similar pero con algunas diferencias:

Puerto de acceso: En lugar de :2222, usa :2106 (ejemplo: tudominio.com:2106).
Gestor de archivos: Se llama "File Manager" o "Administrador de archivos", igual que en DirectAdmin.
Permisos: La interfaz puede variar, pero los comandos de permisos (755, 777) son los mismos.
Base de datos: En Syspanel, busca "phpMyAdmin" en el menú de bases de datos.

[INFO] Si tu proveedor te da acceso a Syspanel, los pasos de esta FAQ son 100% aplicables. Solo cambia la URL de acceso.

Conclusión: Domina la configuración de módulos en PrestaShop con DirectAdmin

Configurar módulos en PrestaShop no tiene por qué ser un dolor de cabeza. Con DirectAdmin, tienes el control total de los archivos de tu tienda, lo que te permite instalar, actualizar y solucionar problemas de forma rápida. Recuerda siempre:

Haz copias de seguridad antes de modificar archivos.
Usa permisos 755 para carpetas de módulos (777 solo temporalmente).
Revisa los logs de errores si algo falla.
Si tu hosting usa Syspanel (HestiaCP), el puerto es el 2106.

Con esta FAQ, ya tienes las respuestas a las dudas más comunes. Si te surge algún problema específico, no dudes en consultar la documentación oficial de PrestaShop o contactar con tu proveedor de hosting. ¡Buena suerte con tu tienda online!