Solución de problemas

Esta página de solución de problemas de Éclair parte de lo que ves: un mensaje, un error 404, un correo que no llega. Empieza por la tabla de diagnóstico rápido y después abre la sección del síntoma. Cada solución se basa en la guía oficial y en el código de Éclair 1.8.0; los mensajes se citan tal como aparecen en pantalla.

Diagnóstico rápido: la solución de problemas en una tabla

Problemas de instalación

Estos casos aparecen en los primeros minutos, antes incluso de iniciar sesión por primera vez en la administración.

«Éclair a besoin de PHP 8.1 ou plus récent»

Este mensaje, que siempre aparece en francés, significa «Éclair necesita PHP 8.1 o superior». La página muestra también tu versión actual. Cambia la versión de PHP en el área de cliente de tu proveedor (a menudo con un clic) y recarga la página. Apunta a PHP 8.3: el asistente de instalación aconseja actualizar si tienes una versión inferior a la 8.2, y la página Seguridad solo valida «Versión de PHP con soporte» a partir de la 8.2. El calendario de soporte de las versiones se publica en php.net.

Un punto aparece en rojo o en naranja en el asistente

Si aparece el mensaje «Activa JavaScript para instalar Éclair.», permite JavaScript en tu navegador. Desde la 1.8.0, zlib es imprescindible: las pantallas de la administración se entregan comprimidas.

«Instalación bloqueada»

Por seguridad, la instalación debe hacerse en las 2 horas siguientes a la primera visita: si no, cualquiera podría hacerse con el control de un sitio subido y olvidado. Para volver a abrir la ventana, borra el archivo data/install-window.php con tu programa FTP o con el gestor de archivos de tu proveedor y recarga la página.

Errores 404, 500 y páginas de error

Error 404 en todas las páginas salvo la de inicio

El archivo .htaccess no se ha subido (es un archivo oculto) o la reescritura de direcciones está desactivada. Activa la visualización de los archivos ocultos en tu programa FTP, vuelve a subir el .htaccess a la raíz de Éclair y recarga. Si tu proveedor lo exige, quita el comentario de la línea RewriteBase /. Con Nginx, el .htaccess se ignora: reproduce las reglas descritas en Archivos, carpetas y direcciones.

Error 500 justo después de la subida

Tu proveedor rechaza una directiva del .htaccess. Es muy poco habitual: Éclair solo usa directivas admitidas en los hostings compartidos. Elimina el bloque en cuestión, o pregunta a tu proveedor cuál da problemas.

«Oups, un court-circuit.»

Esta página, que siempre aparece en francés («Vaya, un cortocircuito»), indica un error inesperado y muestra una Référence (referencia). Inicia sesión en la administración: la página Seguridad lista los Últimos errores técnicos con esa referencia, el mensaje y la ubicación. El botón Reconstruir el índice y vaciar la caché, que aparece en esa sección, reconstruye el índice de los contenidos (data/index.php) y vacía la caché.

Mostrar el detalle de los errores

Es la herramienta básica de la solución de problemas cuando un fallo de Éclair se resiste. Crea un archivo eclair-config.php en la raíz, a partir de eclair-config.exemple.php, con la línea define('ECLAIR_DEBUG', true);. Los errores se mostrarán entonces en detalle. Este modo también desactiva la caché estática: borra la línea en cuanto el problema esté resuelto.

Inicio de sesión y cuentas

¿Qué hacer si olvidas la contraseña o pierdes la 2FA?

Si existe otro administrador, abre tu cuenta en Usuarios y hace clic en Restablecer la contraseña (se genera una contraseña temporal) o en Desactivar la 2FA. Con la 2FA activa, uno de tus 8 códigos de recuperación también sustituye al código del móvil.

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

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

1. Sustituye la segunda línea por el correo de tu cuenta y la tercera por tu nueva contraseña.
2. En las 24 horas siguientes, inicia sesión con ese correo y esa nueva contraseña.
3. La contraseña se sustituye, la verificación en dos pasos de la cuenta se desactiva, tus demás sesiones se cierran y el archivo se borra automáticamente.

Nadie más puede activar este rescate: hay que conocer el contenido del archivo. Un archivo sin la primera línea, o creado hace más de 24 horas, se rechaza y se borra. La nueva contraseña debe cumplir las reglas habituales (10 caracteres como mínimo, que no sea una contraseña común); si no, el registro de seguridad indica «Restablecimiento por FTP rechazado».

«Demasiados intentos. Por seguridad, vuelve a intentarlo en unos minutos.»

Tras 10 intentos fallidos en 15 minutos desde una misma red, el inicio de sesión se bloquea 15 minutos; tras 30 intentos fallidos en una hora contra una misma cuenta, esa cuenta se bloquea una hora para los dispositivos desconocidos. Tu dispositivo habitual tiene su propio contador: un atacante que falla a propósito no lo bloquea. Otro administrador puede levantar un bloqueo en Seguridad › Sesiones y bloqueos › Desbloquear.

Se rechaza el código de verificación en dos pasos

El mensaje «Código incorrecto. Comprueba la hora de tu móvil o usa un código de recuperación.» casi siempre se debe a un reloj desajustado: el código cambia cada 30 segundos. Pon la hora del móvil en automático. Tras 10 códigos erróneos, la verificación en dos pasos de la cuenta se bloquea 15 minutos y se avisa a su titular por correo electrónico.

«Token de seguridad caducado» o «Sesión caducada»

La página ha estado abierta demasiado tiempo, o la sesión ha terminado tras el tiempo de inactividad (240 minutos por defecto, configurable en Ajustes › Avanzado). Recarga la página o vuelve a iniciar sesión en otra pestaña. En el editor no se pierde nada: al volver a abrirlo, un borrador local de respaldo propone «Se ha encontrado una versión sin guardar. ¿Restaurarla?».

«Primero elige tu propia contraseña»

Una cuenta creada o restablecida por un administrador recibe una contraseña temporal. Mientras no la sustituyas en Mi perfil, el resto de la administración sigue cerrado.

Dirección de la administración olvidada

Descarga el archivo data/site.php por FTP y ábrelo en un editor de texto, sin modificarlo. El valor que sigue a "admin_path" es tu dirección: "admin_path": "mi-oficina" corresponde a https://tu-sitio.es/mi-oficina.

Dirección, HTTPS y caché

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… El sitio funciona con normalidad, pero sin redirección a la dirección oficial (con o sin www). Cuando el dominio esté listo, haz clic en Verificar la dirección del sitio. Si falla, aparece el mensaje «Verificación imposible: tu servidor no consigue conectar con…»; pregunta a tu proveedor si están bloqueadas las peticiones del servidor hacia su propio dominio.

«Activa primero HTTPS en tu hosting…»

Este mensaje aparece si marcas Forzar HTTPS cuando has iniciado sesión con http://. Activa el certificado en tu hosting, vuelve a iniciar sesión con https:// y marca la opción: la dirección oficial pasa entonces a https://.

¿Por qué mis cambios no aparecen en el sitio?

1. Comprueba el estado: un Borrador nunca es visible; un contenido Programado se publica a la hora del sitio (zona horaria de Ajustes › General).
2. Un producto publicado sigue invisible mientras la tienda esté cerrada.
3. La caché de Éclair se vacía con cada cambio. Si hay un CDN o un proxy delante de tu sitio, vacía también su caché.
4. Como último recurso: Ajustes › Avanzado › Vaciar la caché, y recarga la página.

Imágenes, correos y formulario

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

Falta la extensión GD (o su soporte de WebP). La biblioteca de medios lo indica: «Tu hosting no tiene la extensión GD: las imágenes se guardan tal cual.» Activa GD en el panel PHP de tu proveedor. Las variantes WebP se crean al subir las imágenes: vuelve a subir después las importantes, porque las anteriores se quedan en JPG o PNG.

Se rechaza la subida de una imagen

¿Por qué no llegan los correos del formulario?

• Abre Mensajes: los mensajes se guardan ahí si está marcada la opción Guardar también los mensajes en la administración, como ocurre por defecto.
• Un mensaje marcado como Probable spam se guarda, pero no se envía por correo. Ocurre si contiene más de 3 enlaces o si llega sin el token del formulario.
• Comprueba Recibir los mensajes en en Ajustes › Contacto; si está vacío, se usa el correo del primer administrador.
• Éclair envía con la función mail() de PHP, desde no-reply@ seguido del dominio de la Dirección oficial del sitio. Comprueba esa dirección en Ajustes › General. Algunos proveedores exigen un remitente del dominio y otros limitan mail(): infórmate con el tuyo.
• Mira en tu carpeta de correo no deseado.

«No se pudo enviar. Revisa los campos e inténtalo de nuevo.»

El visitante ve este mensaje cuando los campos están incompletos (el mensaje debe tener al menos 5 caracteres) o cuando se ha alcanzado un límite antispam: 5 mensajes por red cada 10 minutos y 100 al día para todo el sitio. Si se supera, el formulario rechaza los envíos durante 30 minutos para esa red, o durante 6 horas para el sitio.

Asistente IA

La cuota de Solicitudes por persona y por día (60 por defecto) se configura en el mismo sitio que el presupuesto. La puesta en marcha completa está en Activar el asistente IA integrado.

Conector MCP

• La IA no consigue conectar con el sitio, o la autorización falla: comprueba que el sitio está en HTTPS y que la dirección termina en /_eclair/mcp. En Apache, mantén actualizado el .htaccess de Éclair: transmite la cabecera de autorización que algunos hostings eliminan.
• Éclair está instalado en una subcarpeta: algunas aplicaciones buscan la autorización en la raíz del dominio. Instala Éclair preferiblemente en la raíz de un dominio o de un subdominio.
• Cortafuegos o protección contra robots (Cloudflare…): deja pasar /_eclair/ y /.well-known/.
• Las direcciones del conector responden 404: es normal mientras Permitir conexiones MCP no esté marcado.
• Una propuesta ya no se aplica: el contenido ha cambiado desde entonces («Este contenido ha cambiado desde la propuesta…»); vuelve a pedirle el cambio a la IA.
• Se ha revocado el acceso: cambiar la contraseña o cerrar la sesión en todos tus dispositivos desconecta las aplicaciones conectadas, y tras 60 días sin uso tienes que volver a dar tu permiso.

Los pasos de conexión están en Conectar Claude a tu sitio y Conectar ChatGPT a tu sitio.

Tienda

• «La tienda sigue cerrada: publica primero estas páginas…»: publica tu aviso legal y tus condiciones generales de venta, y elígelos en Ajustes › Tienda antes de marcar Tienda abierta.
• «Esta dirección ya está en uso: elige otra.»: una página ya ocupa la dirección prevista para la tienda; elige otra Dirección de la tienda.
• El botón «Comprar» sigue desactivado: la ficha no tiene enlace de pago. El análisis lo señala; pega el enlace de Stripe, PayPal o Revolut Business en la ficha del producto.
• El botón de una variante sigue desactivado: una variante con otro precio no hereda el enlace del producto, porque el proveedor de pagos cobraría un importe equivocado. Créale su propio enlace de pago, como recuerda el análisis.
• Los productos no aparecen en el sitio: ni las fichas ni el bloque Productos se muestran mientras la tienda esté cerrada.

La puesta en marcha completa está en Vender con la tienda ligera.

Fuente de las direcciones de arte

Tu servidor descarga una sola vez la fuente de los títulos de una dirección de arte, desde Fontsource (dirección cdn.jsdelivr.net), y después la sirve tu propio sitio. Si tu proveedor bloquea las conexiones salientes, un mensaje te avisa y el sitio usa una fuente de reserva de la misma familia (con serifa, condensada…). Vuelve a intentarlo más tarde guardando de nuevo Ajustes › Apariencia, o pide a tu proveedor que autorice esa dirección.

Según tu proveedor de hosting

Buena parte de la solución de problemas de Éclair depende de lo que permita tu proveedor. Los cinco puntos que debes comprobar:

• Archivos ocultos: activa su visualización en tu programa FTP o en el gestor de archivos antes de subir Éclair.
• Versión de PHP: casi siempre se cambia con un clic en el área de cliente.
• Conexiones salientes: las necesitan el asistente IA, la fuente de las direcciones de arte, IndexNow y la verificación de la dirección.
• Envío de correos: algunos proveedores exigen un remitente del dominio o limitan mail().
• Nginx: hay que reproducir las reglas del .htaccess en la configuración del servidor.

Las particularidades de cada proveedor se explican en Elegir tu alojamiento y en el método universal para cPanel, Plesk y DirectAdmin.