Solución de problemas

Esta guía de solución de problemas de Éclair CMS reúne los problemas más frecuentes y su solución, desde la contraseña olvidada hasta el error 404. Cada sección corresponde a un mensaje o a un síntoma concreto: usa el índice para ir directo al tuyo. La mayoría se arreglan en dos minutos, con tu programa FTP o con el gestor de archivos de tu hosting.

¿Has olvidado tu contraseña o perdido el móvil de la verificación en dos pasos?

Empieza por las soluciones más sencillas:

• Existe otro administrador: en Usuarios, puede hacer clic en Restablecer la contraseña (se crea una contraseña provisional) o en Desactivar la 2FA de tu cuenta.
• Has perdido el móvil, pero no tus códigos: inicia sesión con uno de tus 8 códigos de recuperación en lugar del código de 6 cifras.

Si eres el único administrador, usa el rescate por FTP. Crea un archivo data/reset.php que contenga exactamente estas tres líneas:

<?php exit; ?>
tu-direccion@ejemplo.es
TuNuevaClave2026

En las 24 horas siguientes, inicia sesión con ese correo y esa nueva contraseña. La contraseña se sustituye, la verificación en dos pasos de esa cuenta se desactiva, tus demás sesiones se cierran y el archivo se borra automáticamente.

«Instalación bloqueada»: ¿qué hacer?

Por seguridad, la instalación debe hacerse en las 2 horas siguientes a la primera visita: si no, cualquiera podría apropiarse de un sitio subido y olvidado. Pasado ese plazo, borra el archivo data/install-window.php por FTP y recarga la página: se abre una nueva ventana de 2 horas.

¿Qué significa «Dirección del sitio sin verificar» en la página Seguridad?

Tu servidor no consigue llamarse a sí mismo en la dirección del sitio: cortafuegos del proveedor, DNS aún sin propagar, dominio en proceso de transferencia… El sitio funciona con normalidad, pero sin redirección a la dirección oficial (con o sin www, de http a https). Haz clic en Verificar la dirección del sitio cuando el dominio esté listo.

¿Por qué hay un error 404 en todas las páginas salvo la de inicio?

El archivo .htaccess no se ha subido, porque es un archivo oculto, o la reescritura de URL está desactivada. Activa «Mostrar archivos ocultos» en tu programa FTP y vuelve a subirlo a la raíz del sitio. Si tu proveedor lo exige, quita el comentario de la línea RewriteBase / del .htaccess.

¿Qué hacer ante un error 500 justo después de subir los archivos?

Tu proveedor rechaza una directiva del .htaccess. Es muy raro: solo se usan directivas admitidas en los hostings compartidos. Elimina el bloque en cuestión o contacta con tu proveedor. Si aparece la página «Oups, un court-circuit.» (en francés, «Vaya, un cortocircuito») con una referencia, el detalle del error está en Seguridad › Últimos errores técnicos.

¿Por qué no se convierten las imágenes a WebP?

En tu hosting falta la extensión PHP GD, o su compatibilidad con WebP. Actívala en el panel PHP de tu proveedor. Mientras tanto, tus imágenes se quedan en JPG o PNG: el sitio funciona, solo es un poco menos ligero.

¿Por qué no recibo los correos del formulario?

No te preocupes: los mensajes también se guardan en la administración, en el menú Mensajes. Revisa después la dirección de recepción, en el campo Recibir los mensajes en de Ajustes › Contacto; por defecto, es el correo del primer administrador. Algunos proveedores exigen que el remitente pertenezca al dominio del sitio: crea una dirección de correo en tu dominio si hace falta.

¿Cómo activar el modo de depuración?

Crea un archivo eclair-config.php en la raíz del sitio, junto a index.php, siguiendo el modelo de eclair-config.exemple.php:

<?php
defined('ECLAIR') || exit;

// Mostrar el detalle de los errores mientras resuelves el problema.
define('ECLAIR_DEBUG', true);

Los errores se muestran entonces con todo detalle y la caché estática se desactiva. Borra este archivo en cuanto el problema esté resuelto: el detalle de los errores no debe ser visible para todo el mundo.

Todas las direcciones IP son iguales: ¿está tu sitio detrás de un proxy?

Si el registro de seguridad muestra la misma dirección IP para todos los visitantes, tu sitio probablemente se sirve detrás de un proxy o de una CDN, como Cloudflare. Los límites de intentos, que se aplican por red, afectan entonces a todo el mundo a la vez. En Ajustes › Avanzado › «Sitio detrás de un proxy / CDN», elige la cabecera que transmite la dirección real: CF-Connecting-IP para Cloudflare, X-Forwarded-For o X-Real-IP según tu proveedor.

¿Éclair dice que necesita PHP 8.1 o superior?

Si la página muestra «Éclair a besoin de PHP 8.1 ou plus récent» (en francés, «Éclair necesita PHP 8.1 o superior»), tu hosting usa una versión de PHP demasiado antigua. Cámbiala en el área de cliente de tu proveedor, a menudo con un clic, y recarga la página. Éclair funciona de PHP 8.1 a 8.5; elige 8.3 o superior si puedes. La guía Instalar Éclair en o2switch muestra dónde está este ajuste en cPanel.

¿El asistente IA no responde?

Clave rechazada, crédito agotado, presupuesto del mes alcanzado, conexiones salientes bloqueadas: cada mensaje tiene su solución en la guía del asistente IA.

¿Tu problema no está en esta guía de solución de problemas de Éclair CMS?

Anota el mensaje de error exacto, tu proveedor de hosting y tu versión de PHP, y escríbeme a través de la página de Contacto. También puedes comunicar un problema en GitHub: su resolución servirá para mejorar esta guía de solución de problemas de Éclair CMS para todos los usuarios.