IllusionCMS
ES
Manual · 2

Primeros pasos

Iniciar

make run          # compila la app de admin + el servidor y arranca en el puerto 8080

O con un binario ya compilado:

./illusioncms -addr :8080 -data ./data

Abre http://localhost:8080/cms-admin. En el primer arranque creas el acceso de administrador (nombre de usuario y contraseña de al menos 8 caracteres). Después inicias sesión con esos datos.

Una instalación nueva aún no tiene páginas: hasta entonces, cualquier dirección, incluida /, devuelve la página 404. En Páginas creas tu primer sitio web con + Crear sitio web o adoptas uno existente mediante importación.

Todo el contenido está en la carpeta de datos (./data): la base de datos illusion.db y los archivos subidos en media/. Más información en Puesta en marcha.

Probar el sitio de demostración

Para conocerlo, IllusionCMS incluye una demo lista para usar: dos sitios de ejemplo (Bäckerei Morgenrot con un subárbol en inglés y Kulturverein Lindenhof), el constructor de páginas con bloques y un bloque global, Collections con todos los tipos de campo, una fuente REST, Workflows con un node propio, Pens, redirecciones y archivos de ejemplo.

  • Durante la configuración: al crear la primera cuenta de administrador, marca Instalar también el sitio de demostración (desactivado por defecto). En pocos segundos la demo queda importada y la fuente REST apunta automáticamente a la dirección con la que abriste el admin. La casilla solo aparece durante la configuración y solo en builds con la demo integrada: los binarios de las releases la tienen siempre; los que compilas tú, solo después de scripts/build-demo.sh (o make demo).
  • Como descarga: cada release incluye además la demo como archivo illusioncms-vX.Y.Z-demo.icb. Impórtala como bundle en una instancia nueva en Ajustes → Sincronización; atención: un bundle reemplaza todo el contenido (antes IllusionCMS crea una copia de seguridad). Después, la fuente REST termine-api apunta a la dirección de marcador http://demo.invalid: en Fuentes REST introduce la dirección de tu instancia, p. ej. http://localhost:8080/api/v1/collections/termine/items. La solicitud de ejemplo de la Collection en vivo Anfragen solo se incluye si al importar marcas Tomar del bundle también las entradas de Collections con datos en vivo.

El segundo sitio tiene el dominio lindenhof.localhost; Chrome y Firefox lo abren en local en http://lindenhof.localhost:8080/; en un servidor introduces tu propio dominio. Cuando ya no necesites la demo, elimina los sitios en Páginas (después Limpiar quita los archivos sin usar) o reemplázalo todo por tu propio bundle.

El admin de un vistazo

  • Menú principal (a la izquierda): Páginas, Estadísticas, CSS & JS, Snippets, Archivos, Collections, Fuentes REST, Workflows, Pens, Importar, Redirecciones, Manual, Ajustes. Abajo del todo están la apariencia (Claro/Oscuro/Sistema), el idioma (bandera) y la flecha para contraer el menú en una barra estrecha de iconos. Si la ventana es poco alta, solo se desplaza la lista de entradas del menú.
  • Buscar (arriba en el menú, Ctrl+K desde cualquier sitio, también desde el editor de código): la paleta de comandos. Escribe, Enter y listo: encuentra páginas (título o ruta), sitios web, Snippets, CSS/JS, Collections, Workflows, fuentes REST y secciones del manual y de la documentación de la API, y puede ejecutar algunas acciones (vaciar la caché, abrir el sitio web, cerrar sesión). Sin término de búsqueda muestra los últimos resultados abiertos.
  • Instancia (arriba del todo en el menú): Local o una conexión guardada a otro servidor; en ese caso todo el admin trabaja en directo con ese servidor (consulta Varias instancias).
  • Los Ajustes están divididos en secciones que eliges a la izquierda (también con Ctrl+K, p. ej. «Ajustes: Tokens de API»): Sincronización (Bundles, sincronización con un servidor, copias de seguridad; consulta Bundles), Conexiones, Usuarios, Tokens de API, Mi cuenta (contraseña) y Sistema (interruptor del admin, datos de países de las estadísticas, versión instalada, tiempo en marcha, caché de páginas).
  • Abrir sitio web abre la página pública en una pestaña nueva. Si hay varios sitios web, aparece una selección. Si el admin se ejecuta bajo el dominio de un sitio web, los demás se abren a través de su propio dominio; los sitios web sin dominio aparecen entonces en gris, porque el dominio del admin siempre tiene prioridad.
  • Los cambios sin guardar se reconocen por el punto naranja (en el botón de guardar y en las pestañas). Al salir, el CMS pide confirmación.
  • Historial: las páginas, los Snippets, los archivos CSS/JS y los Workflows tienen un botón Historial. Antes de cada guardado, el CMS guarda el estado anterior (guardar varias veces en 2 minutos cuenta como una sola edición; como máximo 100 versiones). En el historial ves el HTML/Head o el código de cada versión y qué campos difieren de la actual; Restaurar la recupera, y antes se guarda también la versión actual. En las páginas, la URL y la publicación se quedan como están. También una reimportación que sobrescribe una página editada deja una versión.
  • ¿Editado a la vez? Si otra persona (o tú en una segunda pestaña) ha guardado una página, un Snippet, un archivo CSS/JS, un Workflow o una entrada de Collection después de que lo abrieras, el CMS pregunta al guardar en lugar de sobrescribir esos cambios sin avisar.

Tu primera página

  1. Páginas → (la primera vez, + Crear sitio web) → seleccionar la página de inicio → + Página.
  2. Introduce el título; el slug (parte de la URL) se propone automáticamente. Si hay diseños de página, eliges uno – si no, se crea una página vacía con un título.
  3. Escribe en la pestaña HTML: la vista previa en vivo de la derecha se actualiza mientras escribes.
  4. Marca Publicada y guarda con Ctrl+S.