CSS/JS-Asset-Editor
Der Asset-Editor ist der eingebaute Code-Editor des CMS für CSS- und JavaScript-Dateien. Sie bearbeiten damit die Stildateien Ihrer Website direkt im Browser — ohne FTP oder Dateimanager.
Aufruf
Unter Busapp Einstellungen › Ausgabe › Assets finden Sie die Asset-Liste — alle aktiven CSS- und JS-Dateien. Dieselbe Liste gibt es unter Domains für einzelne Domains. Jede Zeile hat:
- Den Pfad (z.B.
/css/main.css), bei CSS zusätzlich ein optionales Feld für eine Media-Query. - Die Aktionen ↑ (Datei hochladen (überschreibt Ziel)) und ✎ (Inhalt bearbeiten).
- Einen Knopf zum Entfernen und Pfeile zum Sortieren.
Mit + CSS-Datei bzw. + JS-Datei fügen Sie eine neue Zeile hinzu.
Eine Datei bearbeiten
- Klicken Sie in der Asset-Liste auf ✎ der gewünschten Zeile.
- Die Datei wird geladen und im Editor angezeigt. Oben sehen Sie, ob sie global oder für eine bestimmte Domain gilt.
- Der Editor ist ein CodeMirror-Editor mit:
- Syntax-Highlighting (CSS bzw. JavaScript).
- Zeilennummern.
- Auto-Einrückung.
- Theme passend zum CMS-Theme (Dracula bei Dark, Eclipse bei Light).
- Vollbild-Knopf oben rechts.
- Ändern Sie den Code.
- Speichern Sie auf einem der zwei Wege (siehe unten).
Entwurf oder sofort live
- Als Entwurf speichern — Die Datei auf der Website bleibt unverändert. Der Entwurf ist nur in der Vorschau sichtbar. Für kontrollierte Änderungen ist das der empfohlene Weg.
- Speichern — schreibt direkt in die Datei und wirkt sofort auf der öffentlichen Website.
Besteht ein Entwurf, zeigt der Editor ihn an und bietet zusätzlich:
- Online-Stand anzeigen / Entwurf anzeigen — zwischen beiden Ständen umschalten.
- Entwurf online stellen — ersetzt die Datei auf der Website. Das gilt für alle Domains, die dieses Web-Verzeichnis nutzen.
- Entwurf verwerfen — löscht den Entwurf, die Datei auf der Website bleibt unverändert.
Neue Datei anlegen
Tragen Sie in einer neuen Zeile den Zielpfad ein und klicken Sie auf ↑, um eine lokale Datei hochzuladen. Wahlweise legen Sie sie direkt im Editor an: Klicken Sie auf ✎ — der Editor zeigt dann Neu erstellen — und tippen Sie den Inhalt ein. Beim Speichern wird sie neu erstellt.
Datei ersetzen
Vorhandene Datei durch eine lokale Variante austauschen: ↑ verwenden, die alte Version wird überschrieben.
Was sollte ich nicht tun?
- Eine CSS-Datei mit fehlerhafter Syntax mit Speichern sichern — das Layout der Website wird sofort gestört.
- JavaScript-Dateien ohne Testen produktiv setzen — ein Fehler kann das ganze Frontend brechen.
Verzeichnis-Konventionen
Standardverzeichnisse pro Domain:
/css/— Stylesheets./js/— JavaScript./fonts/— Webfonts./img/— statische Bilder, die zum Layout gehören (Logos, Icons; nicht: Bilder im Inhalt — die liegen unter/images/).
Aktive CSS/JS-Liste
Welche Dateien in welcher Reihenfolge auf der Frontend-Seite eingebunden werden, steht in der System-Konfiguration. Sie gilt global oder für eine einzelne Domain — sie wird im Frontend in den Layout-Head bzw. Layout-Body eingesetzt.
Wenn Sie eine neue CSS-Datei dauerhaft auf der Seite einbinden möchten, muss sie zusätzlich in dieser Liste eingetragen werden. Die Aktualisierung der aktiven Liste passiert in der oben beschriebenen Asset-Liste.
Änderungen an der Liste und Reinit
Hier gibt es einen Unterschied, der leicht für Verwirrung sorgt:
- Ändern Sie den Inhalt einer CSS- oder JS-Datei mit Speichern, ist das sofort im Frontend sichtbar (allenfalls muss der Browser-Cache geleert werden).
- Die Liste der aktiven Dateien hält das Frontend im Anwendungs-Speicher und liest sie nicht bei jedem Seitenaufruf neu aus der Datenbank. Beim Speichern in den Einstellungen lädt das CMS sie automatisch neu.
Erscheint eine neu aktivierte Datei trotzdem nicht im Quelltext, rufen Sie die Website einmal mit dem Parameter ?reinit=app auf, zum Beispiel https://ihre-domain.ch/?reinit=app. Damit lädt das Frontend seine Konfiguration neu.
Wurde die Liste über das Claude-Plugin mit assets_updateActiveFiles geändert, prüfen Sie das Ergebnis und rufen Sie im Zweifel ebenfalls ?reinit=app auf.
Zurück zu: Layouts
