Layouts
Ein Layout ist eine HTML-Vorlage, die den Rahmen um den Seiteninhalt definiert — Header, Navigation, Footer, gegebenenfalls auch CSS- und JavaScript-Einbindungen. Pro Seite (und pro Sprache) wird ein Layout ausgewählt; der Seiteninhalt wird beim Ausspielen in das Layout eingebettet.
Die Layout-Verwaltung ist eher Admin-Aufgabe — Layout-Änderungen wirken sich auf alle Seiten aus, die das Layout verwenden.
Aufruf
Im Bereich Busapp Einstellungen finden Sie eine Sektion Layouts mit der Liste aller im CMS hinterlegten Layouts. Jedes Layout hat:
- Eine Nummer (ID)
- Einen Name — frei wählbar, z.B. „Standard", „Startseite", „Textkästchen 2 Spalten".
- Einen Typ, der bestimmt, wo das Layout eingesetzt werden kann:
- Normales Layout (Seitenlayout): der Rahmen einer ganzen Seite. Nur solche Layouts lassen sich einer Seite zuweisen.
- Multipage-Sektion (Sektionslayout): der Rahmen eines einzelnen Abschnitts auf einer Multipage-Seite.
- Zonenlayout: wird von einem anderen Layout eingebettet, um dessen Inhaltsbereich in mehrere Zonen zu teilen.
- Status (Aktiv/Inaktiv).
- Verwendung — frei beschreiben, wofür das Layout gedacht ist. Der Hinweis hilft der Redaktion und dem KI-Assistenten, das passende Layout zu wählen.
- Versionen: CMS-Stand (aktivcms) und Online-Stand (aktivonline).
Was ein Layout enthält
Pro Layout pflegen Sie zwei HTML-Blöcke:
- Layout Start (layoutstart) — alles, was vor dem Seiteninhalt kommt (öffnende Tags, Header, Navigation).
- Layout Ende (layoutende) — alles, was nach dem Seiteninhalt kommt (Footer, schliessende Tags, ggf.
<script>-Blöcke).
Nur bei Typ Multipage-Sektion erscheinen zusätzlich:
- Editzonen — Anzahl Editierbereiche in dieser Sektion. Bei 1 (Standard) ein Block; bei 2 oder 3 mehrere nebeneinander (z.B. Textkästchen).
- Zonenlayout — optional: Referenz auf ein Sub-Layout für jede Zone.
Über das Claude-Plugin lassen sich zusätzlich die optionalen Varianten busapplayoutstart / busapplayoutende setzen; im Layout-Editor gibt es dafür keine Felder.
Details siehe Layout-Aufbau.
CSS und JavaScript zum Layout
Layouts allein reichen nicht — sie brauchen passende CSS- und JavaScript-Dateien, die das Aussehen und Verhalten bestimmen. Diese werden im CMS über den Asset-Editor direkt bearbeitet, mit Syntax-Highlighting durch CodeMirror. Siehe CSS/JS-Asset-Editor.
Layout-Versionen und Online-Stand
Wie bei Inhalten gilt für Layouts das Trennprinzip:
- Speichern eines geänderten Layouts erzeugt eine neue Version (aktivcms).
- Erst durch Publizieren wird sie zum Online-Stand. Bis dahin sieht das Frontend weiterhin die alte Version.
- Beim Publizieren wirken sich Änderungen sofort auf alle Seiten aus, die das Layout verwenden — entsprechend vorsichtig testen.
Siehe Layout publizieren.
Zonenlayouts
Ein spezieller Layout-Typ (Typ Zonenlayout) für die Verwendung als Sub-Layout in einer Multipage-Sektion. Siehe Zonenlayouts.
Layout-Zuweisung pro Seite
Welches Layout eine Seite verwendet, stellen Sie nicht hier, sondern in den Eigenschaften der jeweiligen Seite (Sprachblock → Auswahl-Feld Layout). Eine Seite kann pro Sprache ein anderes Layout haben. Zur Auswahl stehen nur aktive Seitenlayouts — Sektions- und Zonenlayouts erscheinen dort bewusst nicht.
Anders als der Layout-Inhalt ist die Zuweisung nicht versioniert: Sie greift sofort für Entwurf und Online-Stand und lässt sich nicht per Rollback zurückholen.
Ein Layout löschen
Ab CMS v3.7.15 steht im Layout-Editor unten ein Button Layout löschen — aber nur, wenn das Layout nachweislich nirgends verwendet wird. Andernfalls erscheint an dieser Stelle ein Hinweis, wo es überall im Einsatz ist.
Geprüft wird dreierlei:
- ob dem Layout Seiten zugewiesen sind,
- ob es von einem anderen Layout als Zonenlayout eingebettet wird,
- ob es in Multipage-Sektionen vorkommt — dabei zählen auch alte Inhaltsversionen.
Der letzte Punkt ist Absicht: Ein Rollback auf eine ältere Inhaltsversion soll nie auf ein Layout zeigen, das es nicht mehr gibt. In der Praxis heisst das: Ein Layout, das einmal produktiv im Einsatz war, bleibt dauerhaft löschgeschützt. Für solche Layouts ist der Status inaktiv der richtige Weg — sie verschwinden damit aus der Auswahl, ohne dass bestehende Inhalte gefährdet werden.
Hinweise
- Eingebettetes JS und iframes: Der Layout-Editor ist ein reines Textfeld;
<script>- und<iframe>-Blöcke tragen Sie dort direkt als HTML ein. - Test vor Publish: ein fehlerhaftes Layout kann viele Seiten gleichzeitig beschädigen. Nach dem Speichern in der Vorschau prüfen, erst dann publizieren.
- Über das Claude-Plugin: Layouts lassen sich auch über den MCP-Server verwalten —
layouts_list,layouts_read,layouts_write,layouts_create,layouts_update,layouts_deletesowiepages_setLayoutfür die Zuweisung.layouts_getUsagebeantwortet vorab dieselbe Frage wie der Löschbutton. Siehe Claude-Plugin (MCP).
Weiterführend: Layout-Aufbau · CSS/JS-Asset-Editor · Layout publizieren · Zonenlayouts
