Handbuch · 2

Erste Schritte

Starten

make run          # baut Admin-App + Server und startet auf Port 8080

Oder mit einem fertigen Binary:

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

Öffne http://localhost:8080/cms-admin. Beim allerersten Start legst du den Admin-Zugang an (Benutzername, Passwort mit mindestens 8 Zeichen). Danach meldest du dich mit diesen Daten an.

Eine neue Installation hat noch keine Seiten – jede Adresse, auch /, liefert bis dahin die 404-Seite. Unter Seiten legst du mit + Website anlegen deine erste Website an oder übernimmst eine bestehende per Import.

Alle Inhalte liegen im Datenordner (./data): die Datenbank illusion.db und die Uploads unter media/. Mehr dazu in Betrieb.

Demo-Website ausprobieren

Zum Kennenlernen bringt IllusionCMS eine fertige Demo mit: zwei Beispiel-Websites (Bäckerei Morgenrot mit englischem Unterbaum und Kulturverein Lindenhof), Seitenbaukasten mit Bausteinen und globalem Block, Collections mit allen Feldtypen, eine REST-Quelle, Workflows samt eigenem Node, Pens, Weiterleitungen und Beispieldateien.

Bei der Einrichtung: Setze beim Anlegen des ersten Admin-Zugangs den Haken Demo-Website mitinstallieren (standardmäßig aus). Nach wenigen Sekunden ist die Demo eingespielt, und die REST-Quelle zeigt automatisch auf die Adresse, unter der du das Admin geöffnet hast. Den Haken gibt es nur bei der Einrichtung und nur in Builds mit eingebetteter Demo – die Release-Binaries haben sie immer, selbst gebaute erst nach scripts/build-demo.sh (bzw. make demo).
Als Download: Jeder Release enthält die Demo zusätzlich als Datei illusioncms-vX.Y.Z-demo.icb. Spiele sie in einer frischen Instanz unter Einstellungen → Synchronisation als Bundle ein – Achtung, ein Bundle ersetzt den kompletten Inhalt (vorher legt IllusionCMS ein Backup an). Danach zeigt die REST-Quelle termine-api auf den Platzhalter http://demo.invalid: Trage unter REST-Quellen die Adresse deiner Instanz ein, z. B. http://localhost:8080/api/v1/collections/termine/items. Die Beispiel-Anfrage der Live-Collection Anfragen kommt nur mit, wenn du beim Einspielen Auch die Einträge von Collections mit Live-Daten aus dem Bundle übernehmen anhakst.

Die zweite Website hat die Domain lindenhof.localhost; Chrome und Firefox öffnen sie lokal unter http://lindenhof.localhost:8080/, auf einem Server trägst du eine eigene Domain ein. Brauchst du die Demo nicht mehr, löschst du die Websites unter Seiten (danach entfernt Aufräumen die ungenutzten Dateien) oder ersetzt alles durch ein eigenes Bundle.

Der Admin im Überblick

Hauptmenü (links): Seiten, Statistik, CSS & JS, Snippets, Dateien, Collections, REST-Quellen, Workflows, Pens, Import, Weiterleitungen, Handbuch, Einstellungen. Ganz unten sitzen Darstellung (Hell/Dunkel/System), Sprache (Flagge) und der Pfeil zum Einklappen in eine schmale Icon-Leiste. Bei wenig Fensterhöhe scrollt nur die Liste der Menüpunkte.
Suchen (oben im Menü, Strg+K von überall – auch aus dem Code-Editor): die Befehlspalette. Tippen, Enter, fertig – sie findet Seiten (Titel oder Pfad), Websites, Snippets, CSS/JS, Collections, Workflows, REST-Quellen und Abschnitte aus Handbuch und API-Doku und kann ein paar Aktionen ausführen (Cache leeren, Website öffnen, Abmelden). Ohne Suchbegriff zeigt sie die zuletzt geöffneten Treffer.
Instanz (ganz oben im Menü): Lokal oder eine gespeicherte Verbindung zu einem anderen Server – dann arbeitet das ganze Admin live mit diesem Server (siehe Mehrere Instanzen).
Einstellungen sind in Bereiche gegliedert, die du links auswählst (auch per Strg+K, z. B. „Einstellungen: API-Tokens“): Synchronisation (Bundles, Abgleich mit einem Server, Backups – siehe Bundles), Verbindungen, Benutzer, API-Tokens, Mein Konto (Passwort) und System (Admin-Schalter, Länderdaten der Statistik, installierte Version, Laufzeit, Seiten-Cache).
Website öffnen öffnet die öffentliche Seite in einem neuen Tab. Bei mehreren Websites erscheint eine Auswahl. Läuft das Admin unter der Domain einer Website, öffnen die anderen über ihre eigene Domain – Websites ohne Domain sind dann ausgegraut, weil die Domain des Admins immer Vorrang hat.
Ungespeicherte Änderungen erkennst du am orangefarbenen Punkt (am Speichern-Button und an den Tabs). Beim Verlassen fragt das CMS nach.
Verlauf: Seiten, Snippets, CSS/JS-Dateien und Workflows haben einen Knopf Verlauf. Vor jedem Speichern sichert das CMS den bisherigen Stand (mehrfaches Speichern innerhalb von 2 Minuten zählt als ein Bearbeitungsgang, höchstens 100 Stände). Im Verlauf siehst du HTML/Head bzw. Code jedes Stands und welche Felder sich vom aktuellen unterscheiden; Wiederherstellen holt ihn zurück – der jetzige Stand wird vorher selbst gesichert. Bei Seiten bleiben URL und Veröffentlichung dabei, wie sie sind. Auch ein Re-Import, der eine bearbeitete Seite überschreibt, hinterlässt eine Version.
Gleichzeitig bearbeitet? Hat jemand anderes (oder du in einem zweiten Tab) eine Seite, ein Snippet, eine CSS/JS-Datei, einen Workflow oder einen Collection-Eintrag gespeichert, nachdem du sie geöffnet hast, fragt das CMS beim Speichern nach, statt diese Änderungen still zu überschreiben.

Deine erste Seite

Seiten → (beim ersten Mal + Website anlegen) → Startseite auswählen → + Seite.
Titel eingeben, der Slug (URL-Teil) wird automatisch vorgeschlagen. Gibt es Seitenlayouts, wählst du eins aus – sonst entsteht eine leere Seite mit Überschrift.
Im HTML-Tab schreiben – die Live-Vorschau rechts aktualisiert sich beim Tippen.
Veröffentlicht anhaken, Strg+S speichern.