Documentación
Índice
- ¿Dónde leer la documentación oficial?
- Las 13 secciones de la guía oficial
- Descargar el archivo oficial
- ¿Cómo se organiza la documentación de Éclair en la academia?
- Quiero…: ¿dónde está en la administración?
- ¿Cuál es la versión actual de Éclair?
- ¿Cómo conseguir ayuda?
- ¿Por dónde empezar según tu nivel?
- Preguntas frecuentes
La documentación de Éclair está en dos sitios. En GitHub, la guía oficial y el README describen todo el CMS, en 7 idiomas. Aquí, las páginas de referencia de la academia detallan cada bloque, cada ajuste y cada archivo, con las etiquetas exactas de la administración. Esta página te lleva a la fuente adecuada según tu pregunta.
Lo que encontrarás aquí
La guía oficial
Instalación, funciones, seguridad, actualización y solución de problemas, en 7 idiomas en GitHub.
Las páginas de referencia
Los 18 bloques, todos los ajustes, los archivos, las carpetas y las direcciones generadas.
La ayuda del día a día
Solución de problemas por síntoma, glosario, trucos verificados y preguntas frecuentes.
¿Dónde leer la documentación oficial?
El repositorio de GitHub de Éclair contiene dos documentos oficiales: el README, que presenta el CMS y sus funciones, y la guía completa (docs/GUIDE.md), que explica la instalación, cada función, la seguridad, la actualización y la solución de problemas. Los dos existen en los 7 idiomas de la administración.
| Idioma | Guía completa | README |
|---|---|---|
| Francés | GUIDE.md | README.md |
| Inglés | GUIDE.en.md | README.en.md |
| Español | GUIDE.es.md | README.es.md |
| Alemán | GUIDE.de.md | README.de.md |
| Italiano | GUIDE.it.md | README.it.md |
| Portugués (Brasil) | GUIDE.pt-BR.md | README.pt-BR.md |
| Chino simplificado | GUIDE.zh-CN.md | README.zh-CN.md |
Las 13 secciones de la guía oficial
- Instalación: requisitos, pasos, los 4 tipos de sitio, primeros pasos.
- Funciones en detalle: velocidad, SEO, GEO, editor de bloques.
- Uso diario: la tabla «Quiero… / Dónde» y los atajos.
- Modo Visual.
- Direcciones de arte, con «Imagina mi dirección con la IA» y la puntuación de diseño.
- Temas.
- Tienda: apertura, fichas de producto, Stripe, PayPal, Revolut Business, Google Shopping.
- Asistente IA, con «Crear una página con IA».
- Conector MCP (Claude y ChatGPT).
- Seguridad.
- Actualizar, hacer copias de seguridad, mudarse.
- Solución de problemas, con la configuración de Nginx.
- Para desarrolladores: estructura de carpetas, pruebas, creación del archivo de descarga.
Descargar el archivo oficial
El archivo ZIP eclair-cms-1.8.0.zip pesa 480 KB. Contiene la carpeta eclair (su contenido es lo que subes a tu hosting), un archivo LISEZ-MOI.txt en francés que resume la instalación en tres pasos, la licencia MIT (LICENSE.txt) y los avisos de los componentes de terceros (THIRD-PARTY-NOTICES.txt). El paso a paso completo está en Instalar Éclair paso a paso.
¿Cómo se organiza la documentación de Éclair en la academia?
Las lecciones de las rutas te enseñan a hacer las cosas, paso a paso. Las páginas de referencia sirven cuando buscas un detalle concreto: un campo, un archivo, una dirección o un mensaje de error.
| Página | Lo que encontrarás |
|---|---|
| Referencia de los 18 bloques | La función de cada bloque, sus campos exactos, el buen uso, la trampa que evitar, los atajos de teclado y el pegado inteligente. |
| Referencia de los ajustes | Las 8 pestañas de los Ajustes campo por campo, y después Mi perfil, Usuarios, Seguridad, Menús, Redirecciones y Categorías. |
| Archivos, carpetas y direcciones | La estructura de eclair/, el contenido de data/, eclair-config.php, el .htaccess explicado, Nginx, las copias de seguridad y las direcciones generadas. |
| Solución de problemas | Los problemas conocidos clasificados por síntoma, con una tabla de diagnóstico rápido. |
| Glosario | 50 términos de la web, el SEO, el GEO, la seguridad y la IA, definidos en una o dos frases. |
| Historial de versiones | Lo que ha cambiado de la 1.0.0 a la 1.8.0, y el procedimiento de actualización. |
| Trucos y consejos | Trucos verificados, clasificados por tema, cada uno enlazado a su lección. |
| Preguntas frecuentes | 25 respuestas breves sobre Éclair y sobre la academia. |
Quiero…: ¿dónde está en la administración?
Esta tabla retoma la de la guía oficial y la completa. La última columna indica la lección que explica la tarea paso a paso.
| Quiero… | Dónde | Lección |
|---|---|---|
| Escribir un artículo | Panel › Escribir un artículo | Primer artículo |
| Pedirle a la IA un artículo, una página o una imagen | Campo ¿Qué quieres crear hoy? del panel, o Asistente IA (Ctrl+J) | Asistente IA |
| Hacer que la IA componga una página completa | Nueva página › Crear con IA | Crear con IA |
| Editar una página tal como se ve | Editor › Visual | Modo Visual |
| Editar una página desde el sitio | Botón ✏️ Editar, visible solo cuando has iniciado sesión | Administración |
| Cambiar el tema, el logo, el color o las fuentes | Ajustes › Apariencia | Temas |
| Elegir una dirección de arte | Ajustes › Apariencia › Dirección de arte | Direcciones de arte |
| Añadir mi propio CSS | Ajustes › Apariencia › CSS personalizado | CSS |
| Abrir la tienda | Ajustes › Tienda | Tienda |
| Añadir un producto | Contenidos › + Producto | Tienda |
| Elegir la página de inicio | Ajustes › General | Páginas y menús |
| Permitir o bloquear las IA | Ajustes › IA & GEO | GEO |
| Activar el asistente IA | Ajustes › Asistente IA | Asistente IA |
| Conectar Claude o ChatGPT | Ajustes › Asistente IA › Permitir conexiones MCP | Claude |
| Conectar Google Search Console | Ajustes › SEO | Ajustes esenciales |
| Añadir un enlace al menú | Menús | Páginas y menús |
| Redirigir una dirección antigua | Redirecciones | SEO |
| Crear una categoría | Categorías | Blog y categorías |
| Enlazar dos traducciones | Editor › Documento › Traducción de… | Multilingüe |
| Restaurar una versión anterior | Editor › Historial de versiones | Primer artículo |
| Leer los mensajes del formulario | Mensajes | Formulario |
| Invitar a un redactor | Usuarios › Invitar a alguien | Seguridad |
| Activar la verificación en dos pasos | Mi perfil › Verificación en dos pasos (2FA) | Seguridad |
| Descargar una copia de seguridad | Seguridad › Copia de seguridad | Seguridad |
| Vaciar la caché | Ajustes › Avanzado › Vaciar la caché | Mantenimiento |
| Cambiar la dirección de la administración | Ajustes › Avanzado › Dirección de la administración | Mantenimiento |
¿Cuál es la versión actual de Éclair?
La versión actual es la 1.8.0, publicada el 1 de noviembre de 2026. Trae 12 direcciones de arte, «Imagina mi dirección con la IA», la puntuación de diseño, una puntuación Lighthouse de 100 en las cuatro categorías con cuatro direcciones y un archivo de 480 KB. Todas las novedades desde la 1.0.0 están en el historial de versiones.
La administración no muestra el número de versión. Para conocerlo, abre el archivo index.php en la raíz de tu sitio (por FTP o con el gestor de archivos de tu proveedor de hosting): la línea define('ECLAIR_VERSION', '1.8.0'); lo indica.
¿Cómo conseguir ayuda?
- Busca tu síntoma en Solución de problemas: cada mensaje de error conocido tiene allí su solución.
- Recorre las preguntas frecuentes, y el glosario si un término te frena.
- Anota la referencia del error: la página «Oups, un court-circuit.», que siempre aparece en francés, muestra una Référence que encontrarás también en Seguridad › Últimos errores técnicos.
- Abre una solicitud en las issues del repositorio de GitHub con tu versión de Éclair, tu versión de PHP, tu proveedor de hosting, lo que hiciste, lo que pasó y la referencia del error.
¿Un error o un fragmento poco claro en una lección de la academia? Avísanos desde la página de Contacto.
¿Por dónde empezar según tu nivel?
- Ruta Principiante: 9 lecciones, desde la preparación del hosting hasta los ajustes previos al lanzamiento.
- Ruta Intermedia: 10 lecciones sobre el modo Visual, el diseño, el SEO, el GEO, los sitios multilingües, la tienda y la seguridad.
- Ruta IA y MCP: 7 lecciones sobre el asistente integrado y sobre cómo gestionar tu sitio desde Claude o ChatGPT.
- Ruta Experto: 8 lecciones sobre la arquitectura, Nginx, el rendimiento, la migración y el trabajo en agencia.
- Para elegir dónde alojar tu sitio: Elegir tu alojamiento.
Preguntas frecuentes
¿Existe la documentación oficial de Éclair en español?
Sí. La guía completa y el README existen en español y en otros 6 idiomas: francés, inglés, alemán, italiano, portugués (Brasil) y chino simplificado. Los enlaces directos están en la tabla del principio de esta página.
¿Dónde informo de un fallo de Éclair?
En las issues del repositorio de GitHub de Éclair. Indica tu versión de Éclair y de PHP, tu proveedor de hosting y la referencia del error, pero nunca una contraseña ni una clave de API.
¿Las páginas de referencia sustituyen a las lecciones?
No. Las lecciones te enseñan a hacer las cosas, paso a paso; la documentación de Éclair sirve para comprobar un detalle concreto. Si estás descubriendo Éclair, empieza por la ruta Principiante.