PrestaShop no carga en DirectAdmin: cómo arreglarlo

¡Hola! Soy tu técnico de soporte amigable. Si estás aquí es porque tu tienda PrestaShop no carga y estás usando DirectAdmin como panel de control. No te preocupes, es una situación más común de lo que parece y, por lo general, tiene solución en pocos pasos. En esta guía extensa y muy visual, vamos a desglosar las causas más frecuentes y, lo más importante, las soluciones prácticas para que tu tienda vuelva a funcionar.

Vamos a empezar desde lo más básico hasta lo más técnico, siempre con un lenguaje claro y ejemplos directos. Recuerda que PrestaShop no carga DirectAdmin puede deberse a problemas de permisos, configuración de PHP, base de datos o incluso un simple error de caché. ¡Manos a la obra!

1. Primeros pasos: ¿Qué ha cambiado?

Antes de meterte en configuraciones complejas, hazte estas tres preguntas:

¿Hiciste algún cambio reciente? (Actualizaste PrestaShop, un módulo, o la plantilla).
¿Cambiaste la contraseña de la base de datos o del FTP?
¿Recibiste algún correo de tu proveedor de hosting sobre cambios en el servidor? (Ej: migración a PHP 8.x)

Si la respuesta a alguna es "sí", es muy probable que el problema esté relacionado con ese cambio. Si no, sigue leyendo porque las causas suelen ser recurrentes.

2. Causa #1: Permisos de archivos y carpetas incorrectos

Esta es la causa número uno de un error PrestaShop DirectAdmin. Si los permisos no son los correctos, el servidor web (Apache o Nginx) no puede leer o escribir los archivos necesarios.

¿Cómo solucionarlo desde DirectAdmin?

Accede a DirectAdmin: Ve a tu panel de control (normalmente tudominio.com:2222).
Entra al Administrador de Archivos: Busca el icono "Administrador de Archivos" (File Manager).
Navega a la raíz de tu tienda: Busca la carpeta donde tienes instalado PrestaShop (ej: public_html o prestashop).
Selecciona todo: Marca la casilla de la carpeta raíz (la que contiene index.php, config/, img/, etc.).
Cambia permisos: Busca el botón "Cambiar permisos" (o "Change Permissions").
Aplica la configuración correcta:
- Carpetas (directorios): 755 (rwxr-xr-x)
- Archivos: 644 (rw-r--r--)

[TIP] No marques la opción "Recursivo" si no estás seguro, pero en este caso, para PrestaShop, es necesario aplicarlo a todo. Hazlo con cuidado.

Si después de esto la tienda sigue sin cargar, pasa al siguiente punto.

3. Causa #2: Problemas con la base de datos

Una base de datos corrupta o con la contraseña incorrecta puede dejar tu tienda en blanco. Esto se manifiesta a menudo con una pantalla en blanco o un error de conexión.

Pasos para verificar y reparar desde DirectAdmin

Ve a "MySQL Management" en DirectAdmin.
Accede a phpMyAdmin: Busca el enlace a phpMyAdmin (normalmente está dentro de la sección de bases de datos).
Selecciona tu base de datos: En el panel izquierdo, elige la base de datos de tu PrestaShop.
Revisa las tablas: En la parte inferior, verás un desplegable que dice "Seleccionar todo". Justo al lado, hay otro desplegable. Elige la opción "Verificar tabla".
Repara si es necesario: Si alguna tabla aparece como "error" o "corrupta", repite el paso anterior pero elige "Reparar tabla".

[WARNING] Si el error persiste, puede que la contraseña de la base de datos en tu archivo app/config/parameters.php sea incorrecta. Edita ese archivo (desde el Administrador de Archivos) y asegúrate de que coincida exactamente con la que tienes en DirectAdmin.

4. Causa #3: Versión de PHP incorrecta o incompatible

PrestaShop es exigente con la versión de PHP. Usar una versión demasiado antigua o demasiado nueva puede provocar que PrestaShop no cargue DirectAdmin por completo.

Cómo cambiar la versión de PHP en DirectAdmin

Busca "Select PHP Version" en tu panel de DirectAdmin.
Selecciona la versión recomendada:
- PrestaShop 1.7.x: PHP 7.4 o 8.0 (aunque 8.0 puede dar problemas con algunos módulos).
- PrestaShop 8.x: PHP 8.1 o 8.2.
Habilita las extensiones necesarias: Asegúrate de que estén activadas extensiones como mysqli, gd, curl, mbstring, openssl, pdo_mysql, intl y zip. Márcalas todas si no sabes cuáles son.
Guarda los cambios.

[INFO] Si no ves la opción "Select PHP Version", contacta con tu proveedor de hosting. Algunos planes no permiten cambiar la versión de PHP.

5. Causa #4: Caché de PrestaShop o del servidor

A veces la tienda no carga porque hay una versión en caché corrupta.

Soluciones rápidas

Borra la caché de PrestaShop manualmente: Conéctate por FTP o usa el Administrador de Archivos. Dentro de la carpeta var/cache/, borra todo el contenido (no la carpeta en sí, sino los archivos y subcarpetas que hay dentro).
Limpia la caché del navegador: Prueba en modo incógnito después de borrar la caché del servidor.
Desactiva temporalmente el CDN: Si usas Cloudflare u otro CDN, pausa su proxy por unos minutos para descartar que esté sirviendo una versión antigua.

6. Causa #5: Archivo .htaccess corrupto o incorrecto

El archivo .htaccess es el que gestiona las redirecciones y URLs amigables. Si está mal configurado, tu PrestaShop dará error 500 o no cargará.

Cómo solucionarlo

Renombra el archivo: En el Administrador de Archivos, busca el archivo .htaccess en la raíz de tu tienda. Cámbiale el nombre a .htaccess_backup.
Prueba la tienda: Si ahora carga (aunque sin URLs amigables), el problema era ese.
Regenera el .htaccess:
- Accede al back office de PrestaShop (si puedes).
- Ve a Configuración -> Parámetros de la tienda -> Tráfico y SEO.
- Sin cambiar nada, haz clic en "Guardar". Esto regenerará el archivo automáticamente.

[WARNING] Si no puedes acceder al back office, puedes generar un .htaccess básico. Busca en Google "PrestaShop .htaccess default" y copia el contenido en un nuevo archivo.

7. Causa #6: Problemas con el tema o módulos (error 500)

Un tema o módulo defectuoso puede romper toda la tienda. Esto es muy común tras una actualización.

Solución: Desactivar todo desde la base de datos

Accede a phpMyAdmin (como vimos en la sección 3).
Selecciona tu base de datos.
Busca la tabla ps_configuration (el prefijo ps_ puede variar).
Ejecuta esta consulta SQL (pestaña SQL en phpMyAdmin):
```
UPDATE ps_configuration SET value = '0' WHERE name = 'PS_THEME' LIMIT 1;
```
Esto desactivará el tema actual y forzará a PrestaShop a usar el tema predeterminado (Classic).
Limpia la caché (borra la carpeta var/cache/).

Si la tienda carga, el problema es tu tema. Contacta con el desarrollador.

8. Causa #7: Error de memoria PHP (memory limit)

Si tu tienda tiene muchos productos o módulos, puede que el límite de memoria sea insuficiente.

Cómo aumentarlo en DirectAdmin

Ve a "Select PHP Version".
Haz clic en "Switch to PHP Options" (o "Opciones de PHP").
Busca memory_limit y cámbialo a 256M o 512M.
Guarda los cambios.

[TIP] Si no tienes esta opción, crea un archivo php.ini en la raíz de tu tienda con el siguiente contenido:
memory_limit = 256M
max_execution_time = 300

9. Preguntas Frecuentes (FAQ)

¿Qué hago si veo una pantalla en blanco?

Es el famoso "White Screen of Death". Las causas más comunes son:

Permisos incorrectos (solución en sección 2).
Límite de memoria excedido (solución en sección 8).
Error de PHP (revisa los logs de error en DirectAdmin > Log Viewer).

¿Por qué aparece "Error 500 Internal Server Error"?

Generalmente por un .htaccess corrupto (sección 6) o un módulo que falla al cargar. Prueba a renombrar el .htaccess.

¿Cómo veo los logs de error en DirectAdmin?

Ve a "Log Viewer" o "Error Log" en DirectAdmin.
Busca la sección de errores del dominio (a veces dice "Error Log for tudominio.com").
Los errores más recientes están al final. Copia el texto y búscalo en Google o envíalo a tu soporte.

Mi tienda carga lento, ¿puede ser por esto?

Sí, una mala configuración de PHP o permisos incorrectos pueden ralentizar la tienda. Revisa especialmente el límite de memoria y la versión de PHP.

¿Y si uso Syspanel (HestiaCP)?

Si tu panel es Syspanel (antes HestiaCP), el proceso es similar pero accedes por el puerto 2106 (ej: tudominio.com:2106). Las soluciones son las mismas, solo cambia la interfaz del panel.

Conclusión: Resumen rápido para solucionar PrestaShop caído

Reinicia todo: A veces un reinicio del servicio web (desde DirectAdmin > Servicios) soluciona problemas temporales.
Verifica permisos: 755 para carpetas, 644 para archivos.
Revisa la base de datos: Verifica y repara en phpMyAdmin.
Cambia la versión de PHP a la recomendada.
Borra la caché (var/cache/).
Renombra .htaccess para descartarlo.
Aumenta el límite de memoria a 256M.

Si después de todo esto PrestaShop no carga DirectAdmin sigue siendo un problema, no dudes en contactar con el soporte de tu hosting. Diles exactamente qué pasos has seguido y, si puedes, comparte el error exacto que ves en la pantalla o en los logs. ¡Estoy seguro de que lo solucionarán rápido!

Espero que esta guía te haya sido de gran ayuda. Recuerda, la paciencia es clave. ¡Tu tienda volverá a estar online en poco tiempo!