APP_TEMPLATE). Gemeint ist dasselbe.
Mitgelieferte Themes
Alle haben eine helle und eine dunkle Variante mit WCAG-AA-Kontrasten.
arena, verein, schuetzen, reiterhof, parcours und business sind vollständige Beispiele für die Gestaltung über data-ui-Haken: eigene Schriften (variabel, SIL Open Font License, Lizenz unter fonts/OFL.txt), SVG-Emblem, App-Icons, umgefärbte Palette je Modus, Hero-Flächen als „Inseln“ mit eigener Palette, Animationen nur ohne prefers-reduced-motion. Ihre theme.css ist kommentiert, die Kontrastwerte stehen dabei.
Die mitgelieferten Themes stehen auf jeder Installation immer zur Auswahl, dazu die dort hochgeladenen und im Theme-Editor gestalteten. Gewählt wird das Theme vom Plattform-Admin unter Darstellung (/admin/appearance, siehe Darstellung) oder fest über die Umgebungsvariable APP_TEMPLATE (siehe Konfiguration). Es gilt für die ganze Installation. Communities können darin nur ein eigenes Logo und eine eigene Primärfarbe festlegen (ab 2.1, siehe Communities mit eigener Farbe und eigenem Logo); Schriften, Flächen und Rundungen kommen immer aus dem Theme. Mitglieder können weiterhin selbst zwischen hell und dunkel umschalten.
Beispiel-Theme herunterladen
Ausgangspunkt für ein eigenes Theme ist das ausführlich kommentierte Beispiel: beispiel-theme.zip herunterladen (Theme-Schlüsselbeispiel, frei verwendbar)
Es zeigt alle wichtigen Bausteine: Farben für hell und dunkel, eine eigene Überschriften-Schrift ohne Schriftdateien, weichere Rundungen, Logo für hell und dunkel, Favicon, dezente Gestaltung über data-ui-Haken und auskommentierte Rezepte zum Ausprobieren. Die ZIP-Datei lässt sich unverändert im Plattform-Admin hochladen (siehe Theme installieren).
Aus dem Beispiel ein eigenes Theme machen:
- ZIP-Datei entpacken und das Verzeichnis umbenennen, z. B. in
meine-marke(nur Kleinbuchstaben, Ziffern und Bindestrich, höchstens 40 Zeichen). - In
theme.jsonden Wertkeyauf denselben Namen setzen,nameunddescriptionanpassen. - Farben und Rundungen in
theme.cssändern,logo.svg,logo-dark.svgundfavicon.svgersetzen. - Das Verzeichnis wieder als ZIP-Datei packen (z. B. Rechtsklick → „Komprimieren“ bzw.
zip -r meine-marke.zip meine-marke), im Plattform-Admin hochladen, wählen und prüfen (siehe Testen).
Kopie eines vorhandenen Themes als Startpunkt
Im Plattform-Admin unter Darstellung hat jedes Theme eine Schaltfläche zum Herunterladen:- Kopie herunterladen bei den mitgelieferten Themes (
quicktribe,mitternacht,arena,verein,schuetzen,reiterhof,parcours,business): Die ZIP-Datei trägt bereits einen eigenen Schlüssel (mein-quicktribe,mein-arena…) und den Namen mit „(Kopie)“ – sie lässt sich sofort als eigenes Theme wieder hochladen und dann anpassen.mitternacht/theme.cssist ausführlich kommentiert und ein guter Ausgangspunkt für ein dunkles Theme;arena,verein,schuetzenundbusinesszeigen, wie weit die Gestaltung mit Schriften, Emblem unddata-ui-Haken gehen kann. - Herunterladen bei hochgeladenen Themes: genau die Dateien der aktuellen Fassung, etwa um sie zu bearbeiten oder auf eine andere Installation zu übertragen.
theme.json wird dann angepasst.
Aufbau
/themes/_u/<key>/<version>/… ausgeliefert; die mitgelieferten Themes liegen im Image unter public/themes/<key>/ (Adresse /themes/<key>/…).
Regeln:
keyintheme.jsonist der Schlüssel des Themes: Kleinbuchstaben, Ziffern, Bindestrich, höchstens 40 Zeichen, am Anfang ein Buchstabe oder eine Ziffer. Er muss eindeutig sein; die Schlüssel der mitgelieferten Themes sind vergeben. Der Ordnername in der ZIP-Datei spielt keine Rolle, sollte aber zur Übersicht gleich heißen.- Alle Dateiangaben in
theme.jsonsind relativ zum Theme-Verzeichnis, höchstens ein Unterverzeichnis tief (fonts/datei.woff2), ohne... - Ein Theme enthält kein JavaScript. Schriften, Bilder und CSS kommen ausschließlich aus dem Theme-Verzeichnis (siehe Sicherheitsregeln).
theme.json
Vollständiges Beispiel mit allen Feldern:
Weitere Felder in
theme.json werden ignoriert – etwa private aus älteren Versionen.
Ein hochgeladenes Logo (Plattform-Admin → Darstellung) hat Vorrang vor Logo, Favicon und App-Icons des Themes. Der Plattformname aus dem Plattform-Admin bzw. APP_NAME erscheint neben dem Logo, im Seitentitel und als Name der installierten App.
Testen
- Theme hochladen (siehe Theme installieren) – Fehler im Paket zeigt der Plattform-Admin sofort beim Hochladen.
- Im Plattform-Admin unter Darstellung das Theme mit Verwenden aktivieren. Ist
APP_TEMPLATEgesetzt, ist die Auswahl gesperrt – dannAPP_TEMPLATE=<key>setzen und die Anwendung neu starten. - Hell und dunkel ansehen (Schalter in der Kopfleiste) und dabei mindestens diese Seiten aufrufen: Startseite, Anmeldung, Landingpage einer Community, Feed, Beitrag, Kurs mit Lektion, Kalender, Mitglieder, Nachrichten, Einstellungen, Plattform-Admin. Auch die Wartungsseite (Zugangsseite) und die Zertifikatsseite eines Kurses nutzen das Theme; Zertifikate drucken immer hell.
- In den Entwicklerwerkzeugen des Browsers (Konsole und Netzwerk) dürfen keine CSP-Verstöße und keine Fehler 404 auf
/themes/…erscheinen. - Auf dem Smartphone prüfen: Kopfleiste, Navigation, Knöpfe und Dialoge bei schmaler Breite.
Eine neue Fassung wirkt beim nächsten Seitenaufruf. Die Adressen aller Dateien eines hochgeladenen Themes enthalten eine Version, die sich aus dem Inhalt ergibt – Browser laden nach jeder Änderung die neue Fassung, auch Schriften und Bilder, die
theme.css relativ einbindet. Bis dahin dürfen sie die Dateien dauerhaft zwischenspeichern.
Eigene Themes auf mehreren Installationen
Eigene Themes kommen per Upload (siehe Theme installieren) oder aus dem Theme-Editor auf eine Installation. Sie liegen im Speicher dieser Installation – jede Installation hat ihre eigenen und zeigt in der Auswahl nur diese und die mitgelieferten. Soll dasselbe Theme auf mehreren Installationen laufen, laden Sie dieselbe ZIP-Datei auf jeder hoch (oder laden es auf der ersten herunter und auf den anderen hoch). Wer ein eigenes Image baut, kann Themes auch unterpublic/themes/ ins Image legen (siehe Hinweis für Entwickler). Solche Themes erscheinen auf jeder Installation mit diesem Image immer in der Auswahl.
Frühere Versionen kannten das Feld
"private": true und die Umgebungsvariable APP_TEMPLATES, um Themes im Image erst nach Freischaltung anzuzeigen. Beides gibt es nicht mehr: Das Feld wird ignoriert (ältere Pakete lassen sich unverändert hochladen), die Variable ebenfalls.