Die Optionen in diesem Abschnitt sollten nur von erfahrenen Anwendern bearbeitet werden, da sie die Funktionalitäten der Webseite einschränken können. Alle Informationen in diesem Abschnitt setzen ein Verständnis für die Funktionsweise der ⟶Nitro CMS-Integration von Flyo voraus.
Für das Verwalten der CMS Seiten müssen in diesem Menü keine Anpassungen vorgenommen werden.
Du findest die Konfiguration im CMS Editor im Tab Konfiguration. Jeder Bereich klappt mit einem Klick auf.
1 → Domains & Umgebungen
- Domain: die Domain der Webseite (z.B.
flyo.ch). Sie wird auch verwendet, um im Inhalt unter «Ansehen» die Adresse der Detailseite zu bilden und um Draft-Links für Inhalte zu erzeugen, die offline sind. - Webseite ist online: Wenn eingeschaltet, kann die Webseite öffentlich erreicht werden, und in jedem Inhalt erscheinen unter «Ansehen» automatisch die Adressen seiner Detailseiten.
- Vorproduktionsumgebung: Diese Adressen ermöglichen eine Vorschau der Änderungen im CMS Editor in Echtzeit. Pro Adresse wählst du den Token-Typ (Development oder Production) und ein Label, das unter der Vorschau als Umschalter erscheint. Die Applikation muss den Development Token verwenden. Details unter Preview-URLs.
2 → Seitencontainer
Seitencontainer sind ein übergeordnetes Element, in denen einzelne CMS Seiten der Website organisiert werden. Sie dienen dazu, die Struktur der Webseite logisch zu ordnen und bestimmte wiederkehrende Elemente zusammenzufassen.
Beispiel für Seitencontainer:
- Navigation: Enthält alle Menüpunkte und deren Struktur
- Header: Bereich mit Logo, Hauptmenü oder Suchfunktion
- Footer: Bereich mit rechtlichen Informationen, Links oder Kontaktangaben
In Flyo können diese Seitencontainer flexibel gestaltet und per API in das Frontend (Webseite) eingebunden werden.
Hinweis:
Aus Sicherheitsgründen und um die Funktionalität der Webseite zu gewährleisten, können nur leere Seitencontainer (ohne CMS Seiten) umbenannt oder gelöscht werden.
3 → Inhaltselemente (Komponenten)
⟶Inhaltselemente (Komponenten) sind Bausteine aus denen eine CMS Seite aufgebaut wird.Beispiel für Inhaltselemente (Komponenten):
- Hero-Bereich: Baustein mit Elementen wie Titelbild, Überschrift und einem Button
- Galerie: Baustein mit einer dreispaltigen Darstellung von Bildern
Die Liste zeigt jedes Inhaltselement mit Titel, Hilfetext und dem Komponenten-Identifier, mit dem das Frontend es erkennt (z.B. HeroBanner). Über den Griff links änderst du die Reihenfolge, in der die Elemente im Seiteneditor angeboten werden.
Bestehendes Inhaltselement bearbeiten
Ein Klick auf das Stift-Symbol öffnet das Inhaltselement:
- Titel, Hilfetext, Farbe und Icon: wie das Element im Seiteneditor erscheint
- Technischer Identifier und Komponenten Identifier: die Namen, unter denen das Element über die API ausgeliefert wird. Wird ein Element bereits verwendet, lässt sich der Identifier nicht mehr anpassen (Schloss-Symbol), damit die Webseite nicht bricht.
- Inhalte: die Felder, die Redaktorinnen und Redaktoren im Element ausfüllen (in der API
content) - Optionen: optionale Darstellungsvarianten des Elements, z.B. «Farbe» oder «Grösse» (in der API
config) - Platzhalter Verschachtelung: Platzhalter (Slots), in die weitere Elemente eingefügt werden können, siehe Inhaltselemente
- Verbinden: ein Content Pool, dessen Einträge das Element ausgibt (Mapping Content Pool, in der API
items), siehe Content-Pool-Inhalte eines Blocks
Neues Inhaltselement erstellen
Klicke unter der Liste auf Inhaltselement hinzufügen. Du wählst zwischen zwei Arten:
- Neues globales Inhaltselement: aus den Feldern der Organisation zusammengestellt und danach auf jeder Webseite der Organisation verfügbar
- Inhaltselement nur für diese Website: erscheint nicht bei den globalen Inhaltselementen und lässt sich auf keiner anderen Webseite verwenden
Gibt es bereits globale Inhaltselemente, wählst du sie im selben Dialog aus und fügst sie mit Einfügen dieser Webseite hinzu. Vergib danach Titel und Identifier und definiere die Felder unter «Inhalte». Die Darstellung programmiert der Webentwickler im Frontend unter demselben Komponenten-Identifier.
Hinweis:
Die Darstellung der Inhaltselemente erfolgt im Frontend (Webseite), siehe Inhaltselemente und den Kickstart-Guide.
4 → Globale Inhalte
Globale Inhalte sind Daten, die auf jeder Seite der Website verfügbar sind und nicht an eine einzelne Seite gebunden sind. Es gibt drei Bereiche:
Statische Inhalte
Schlüssel-Wert-Paare für globale Konfigurationsvariablen (z.B. Footer-Text, Copyright-Hinweis, Firmenname). Jeder Eintrag kann einzeln als mehrsprachig markiert werden, sodass pro Sprache ein eigener Wert hinterlegt werden kann.
Meta
Standard-Meta-Beschreibung und Standard-Meta-Bild, die verwendet werden, wenn eine Seite keine eigenen Meta-Informationen definiert hat.
Content Pool Inhalte
Ermöglicht das Mappen von Inhalten aus Content Pools auf globale Variablen. Die gemappten Daten stehen auf jeder Seite über den Config-Endpunkt zur Verfügung. Typische Anwendungsfälle sind Standortlisten im Footer oder Partner-Logos im Header.
5 → Seiteneigenschaften
Seiteneigenschaften sind benutzerdefinierte Eigenschaften, die an einzelne CMS-Seiten angehängt werden können. Jede Eigenschaft hat einen Identifier, einen Typ und optionale Einstellungen:
- In Navigation sichtbar: Wenn aktiviert, wird die Eigenschaft auch in den Navigationseinträgen des Config-Endpunkts im
properties-Objekt mitgeliefert. - Vererbung (Propagation): Wenn aktiviert, erbt eine untergeordnete Seite den Wert automatisch von der übergeordneten Seite, sofern kein eigener Wert gesetzt ist.
Typische Anwendungsfälle: Hintergrundfarbe pro Seite, ein Header-Bild oder ein Flag wie «Seite im Vollbildmodus anzeigen».
6 → Detailseiten
Definiert, ob und wie Entitäten als Detailseiten über die API abrufbar sind. Für jede Entität (Schema) können folgende Einstellungen vorgenommen werden:
- Felder: Welche Felder der Entität über die API ausgegeben werden und unter welchem Namen (
variableName). - Routes: URL-Templates für die Detailseiten, z.B.
/blog/{entity_slug}. Verfügbare Platzhalter:{entity_unique_id},{entity_slug},{entity_type_id},{language}. - Breadcrumbs: Hierarchische Navigationspfade für die Detailseite.
Jede Entität zeigt ihre Type-ID, die du im Frontend für das Routing brauchst. Unter Mapping ordnest du die Felder der Entität den Variablen zu, die über die API ausgegeben werden (z.B. long_text → «Beschreibungstext»).
7 → Inhalt indexieren
Standardmässig werden nur Entitäten indexiert, die als Inhalt in Komponenten (Blöcken) verwendet werden. Mit dieser Funktion können zusätzliche Content Pools erzwungen in den Index aufgenommen werden, damit deren Einträge auch als Detailseiten abrufbar sind.
Achtung
Das erzwungene Indexieren verlangsamt den Synchronisationsprozess erheblich und erhöht die Dauer des Prozesses. Diese Funktion sollte daher nur begrenzt und gezielt eingesetzt werden.