Ein Theme legt fest, wie die gesamte Plattform aussieht: Farben, Schriften, Rundungen, Logo, Favicon und App-Icons – auf allen Seiten, in allen Communities, im hellen und im dunklen Modus. Es besteht nur aus statischen Dateien (JSON, CSS, Bilder, Schriften) und kommt ohne Programmcode aus. Eigene Themes laden Sie als ZIP-Datei im Plattform-Admin hoch; sie liegen dann im Speicher Ihrer Installation. Updates der Plattform lassen ein Theme unberührt, solange es sich an die hier beschriebenen Schnittstellen hält. In der Oberfläche und in den Umgebungsvariablen heißt ein Theme Template (Plattform-Admin → Darstellung, 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

Am schnellsten geht ein eigenes Theme mit dem Theme-Editor: Farben, Rundungen, Schriften und Logo wählen, Vorschau ansehen, speichern. Das Ergebnis lässt sich als ZIP-Datei herunterladen und mit eigenem CSS weiter verfeinern.
Ausgangspunkt für ein eigenes Theme ist das ausführlich kommentierte Beispiel: beispiel-theme.zip herunterladen (Theme-Schlüssel beispiel, 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:
  1. ZIP-Datei entpacken und das Verzeichnis umbenennen, z. B. in meine-marke (nur Kleinbuchstaben, Ziffern und Bindestrich, höchstens 40 Zeichen).
  2. In theme.json den Wert key auf denselben Namen setzen, name und description anpassen.
  3. Farben und Rundungen in theme.css ändern, logo.svg, logo-dark.svg und favicon.svg ersetzen.
  4. 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.css ist ausführlich kommentiert und ein guter Ausgangspunkt für ein dunkles Theme; arena, verein, schuetzen und business zeigen, wie weit die Gestaltung mit Schriften, Emblem und data-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.
Für einen anderen Schlüssel genügt beim Hochladen das Feld Schlüssel – theme.json wird dann angepasst.

Aufbau

Als ZIP-Datei dürfen die Dateien direkt in der ZIP-Datei oder in genau einem Ordner liegen. Hochgeladen liegt das Theme im Speicher der Installation und wird unter /themes/_u/<key>/<version>/… ausgeliefert; die mitgelieferten Themes liegen im Image unter public/themes/<key>/ (Adresse /themes/<key>/…). Regeln:
  • key in theme.json ist 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.json sind 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

  1. Theme hochladen (siehe Theme installieren) – Fehler im Paket zeigt der Plattform-Admin sofort beim Hochladen.
  2. Im Plattform-Admin unter Darstellung das Theme mit Verwenden aktivieren. Ist APP_TEMPLATE gesetzt, ist die Auswahl gesperrt – dann APP_TEMPLATE=<key> setzen und die Anwendung neu starten.
  3. 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.
  4. In den Entwicklerwerkzeugen des Browsers (Konsole und Netzwerk) dürfen keine CSP-Verstöße und keine Fehler 404 auf /themes/… erscheinen.
  5. Auf dem Smartphone prüfen: Kopfleiste, Navigation, Knöpfe und Dialoge bei schmaler Breite.
Ein fehlerhaftes Paket wird beim Hochladen abgelehnt; der Plattform-Admin listet alle gefundenen Fehler. Häufige Meldungen: 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 unter public/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.