FAQ: Problemas de compatibilidad de módulos PrestaShop en DirectAdmin

¿Por qué mi módulo de PrestaShop no funciona en DirectAdmin? Preguntas frecuentes

Si estás leyendo esto, probablemente te has encontrado con algún problema al instalar o ejecutar un módulo de PrestaShop en tu servidor con DirectAdmin. No te preocupes, es una situación muy común. Los entornos de hosting como DirectAdmin tienen configuraciones específicas que a veces chocan con lo que espera PrestaShop. Vamos a resolver las dudas más frecuentes sobre la compatibilidad PrestaShop DirectAdmin para que puedas tener tu tienda funcionando sin dolores de cabeza.

¿Qué causa los problemas de compatibilidad de módulos PrestaShop en DirectAdmin?

La mayoría de los problemas vienen de diferencias en la configuración del servidor. PrestaShop y sus módulos esperan ciertos valores de PHP, permisos de archivos y extensiones de servidor que no siempre están activados por defecto en DirectAdmin. Aquí te explico los factores más comunes.

1. Versión de PHP incorrecta o incompatible

Cada módulo de PrestaShop está diseñado para funcionar con una versión específica de PHP. Si tu DirectAdmin tiene una versión diferente, el módulo puede dar errores o simplemente no instalarse.

[INFO] PrestaShop 1.7 y versiones superiores requieren PHP 7.1 como mínimo, pero se recomienda PHP 7.4 u 8.0. Algunos módulos antiguos solo funcionan con PHP 5.6 o 7.0.

¿Cómo revisarlo?
En DirectAdmin, ve a "PHP Selector" o "PHP Version" en el panel de tu cuenta. Ahí puedes cambiar la versión de PHP para tu dominio.

2. Extensiones de PHP desactivadas

Los módulos suelen necesitar extensiones como curl, gd, mbstring, openssl o pdo_mysql. Si alguna falta, el módulo no cargará correctamente.

¿Cómo solucionarlo?
Desde el "PHP Selector" de DirectAdmin, puedes activar o desactivar extensiones individuales. Busca la lista y marca las que necesites.

3. Permisos de archivos y carpetas

PrestaShop y sus módulos necesitan permisos de escritura en ciertas carpetas (como cache, config, modules, themes). En DirectAdmin, a veces los permisos están muy restrictivos.

[WARNING] No pongas permisos 777 en todas las carpetas. Es un riesgo de seguridad. Usa 755 para carpetas y 644 para archivos, y solo da permisos de escritura donde sea necesario.

4. Limitaciones de memoria PHP (memory_limit)

Algunos módulos pesados (como los de importación de productos o generación de mapas de sitio) requieren más memoria de la que permite el servidor por defecto. Si ves errores como "Allowed memory size exhausted", es por esto.

¿Cómo aumentarlo?
En DirectAdmin, puedes crear o modificar un archivo php.ini local en la raíz de tu tienda. Añade la línea: memory_limit = 256M (o 512M si el módulo lo pide).

¿Cómo sé si un módulo es compatible con mi DirectAdmin?

Antes de comprar o instalar un módulo, revisa estos puntos clave:

• Requisitos del módulo: La ficha del módulo debe indicar la versión de PrestaShop y PHP que necesita.
• Compatibilidad con el servidor: Pregunta al desarrollador si ha sido probado en DirectAdmin. Algunos módulos están optimizados para cPanel o Plesk.
• Extensiones necesarias: Busca en la documentación del módulo si requiere extensiones especiales (por ejemplo, imagick o soap).

[TIP] Si el módulo es de pago, muchos desarrolladores ofrecen una versión de prueba o reembolso si no funciona. Aprovecha eso para probar en tu entorno.

Preguntas frecuentes (FAQ) sobre módulos PrestaShop DirectAdmin

Aquí tienes las dudas más comunes que resuelvo a diario. Léelas con calma.

1. "El módulo se instala pero no se muestra en el back office"

Esto suele pasar por un error de permisos o porque el módulo no se ha copiado correctamente.

Pasos para solucionarlo:

1. Verifica la carpeta del módulo: Ve a /public_html/modules/ y asegúrate de que la carpeta del módulo tenga el nombre exacto (sin espacios ni mayúsculas extrañas).
2. Permisos: La carpeta debe tener permisos 755 y los archivos dentro 644.
3. Limpia la caché: En el back office de PrestaShop, ve a "Parámetros avanzados" > "Rendimiento" y limpia la caché.
4. Reinstala el módulo: Desinstálalo desde "Módulos" > "Módulos instalados" y vuelve a instalarlo.

2. "El módulo da error 500 después de instalarlo"

Un error 500 (Internal Server Error) es genérico, pero suele deberse a un conflicto de PHP o a un archivo corrupto.

Diagnóstico rápido:

• Revisa el log de errores: En DirectAdmin, ve a "Logs" > "Error Log" y busca la línea que menciona tu módulo.
• Cambia la versión de PHP: Prueba con una versión anterior (por ejemplo, de PHP 8.0 a 7.4).
• Desactiva módulos conflictivos: Temporalmente desactiva otros módulos para ver si hay conflicto.

[WARNING] Si el error persiste, contacta al desarrollador del módulo. Ellos conocen mejor su código.

3. "El módulo no se conecta a servicios externos (API, pasarelas de pago)"

Esto es común con módulos de pago o envío que necesitan llamar a APIs externas.

Causas frecuentes:

• Firewall o bloqueo de puertos: DirectAdmin a veces bloquea puertos de salida. Contacta a tu proveedor de hosting.
• cURL desactivado: Asegúrate de que la extensión curl esté activa en el PHP Selector.
• SSL incorrecto: Si el módulo usa HTTPS, verifica que tu certificado SSL esté bien instalado.

4. "Al actualizar PrestaShop, los módulos dejan de funcionar"

Las actualizaciones mayores de PrestaShop (por ejemplo, de 1.6 a 1.7) suelen romper módulos antiguos.

Consejos:

• Actualiza los módulos primero: Antes de actualizar PrestaShop, asegúrate de que todos tus módulos tengan versiones compatibles.
• Prueba en un entorno de staging: Crea una copia de tu tienda en un subdominio o carpeta para probar la actualización.
• Revisa la documentación: El desarrollador del módulo suele publicar notas sobre compatibilidad.

5. "El módulo funciona en local pero no en DirectAdmin"

Esto es muy común. En tu ordenador de desarrollo tienes configuraciones flexibles, pero el servidor es más restrictivo.

Diferencias típicas:

• PHP version: En local usas PHP 8.0, pero el servidor tiene 7.4. Ajusta la versión en DirectAdmin.
• Extensiones: En local tienes todas las extensiones, en el servidor faltan algunas.
• Permisos: En local los archivos son de tu usuario, en el servidor pueden ser de nobody o apache. Ajusta los permisos.

¿Cómo configurar DirectAdmin para máxima compatibilidad con PrestaShop?

Aquí tienes una guía paso a paso para preparar tu servidor.

Paso 1: Selecciona la versión de PHP correcta

1. Entra a DirectAdmin y ve a "PHP Selector" (o "PHP Version").
2. Elige la versión recomendada por PrestaShop (por ejemplo, PHP 7.4 o 8.0).
3. Aplica los cambios y espera unos segundos.

Paso 2: Activa las extensiones necesarias

En el mismo "PHP Selector", busca la pestaña "Extensions" o "PHP Extensions". Activa al menos:

• curl
• gd
• mbstring
• openssl
• pdo_mysql
• json
• xml
• zip
• fileinfo

[INFO] Si tu módulo requiere alguna extensión específica (como imagick para imágenes), actívala también.

Paso 3: Aumenta los límites de PHP

Crea o edita un archivo php.ini en la carpeta raíz de tu tienda (donde está index.php). Añade estas líneas:

memory_limit = 256M
upload_max_filesize = 64M
post_max_size = 64M
max_execution_time = 120
max_input_time = 120

Paso 4: Configura los permisos de archivos

Desde el administrador de archivos de DirectAdmin (o FTP), establece:

• Carpetas: 755 (rwxr-xr-x)
• Archivos: 644 (rw-r--r--)
• Carpetas especiales: cache, config, modules, themes y img pueden necesitar 777 temporalmente para instalación, pero luego vuelve a 755.

Paso 5: Habilita el modo de depuración (opcional)

Si sigues teniendo problemas, activa el modo de depuración de PrestaShop. En el archivo config/defines.inc.php, cambia:

define('_PS_MODE_DEV_', true);

Esto mostrará errores detallados. No lo dejes activado en producción porque expone información sensible.

¿Qué hago si nada funciona?

Si después de seguir todos estos pasos el módulo sigue sin funcionar, tienes varias opciones.

1. Contacta al desarrollador del módulo: Ellos son los que mejor conocen su código y pueden darte una solución específica.
2. Pide ayuda en foros de PrestaShop: La comunidad es muy activa. Busca en los foros oficiales o en grupos de Facebook.
3. Considera un hosting especializado: Algunos proveedores de hosting optimizan sus servidores para PrestaShop, lo que evita muchos problemas de compatibilidad PrestaShop DirectAdmin.
4. Prueba con un módulo alternativo: Si el módulo es muy problemático, busca otro que haga la misma función pero sea más compatible.

[TIP] Si tu hosting usa Syspanel (antes HestiaCP), recuerda que el puerto de acceso es el 2106 y la configuración de PHP se hace de forma similar a DirectAdmin, pero con algunas diferencias en la interfaz. Consulta la documentación de Syspanel para más detalles.

Conclusión

Los problemas de módulos PrestaShop DirectAdmin son normales, pero casi siempre tienen solución. La clave está en revisar la configuración del servidor (PHP, extensiones, permisos) y en leer bien los requisitos del módulo antes de instalarlo. Con esta FAQ, espero haberte ayudado a resolver las dudas más comunes. Si te queda alguna pregunta, recuerda que siempre puedes escribirme. ¡Buena suerte con tu tienda!