Ein Theme ist ein Verzeichnis mit statischen Dateien (siehe Themes), verpackt als ZIP-Datei. Sie laden es im Plattform-Admin hoch; die Anwendung legt es im Speicher der Installation ab – dort, wo auch Logos, Bilder und Anhänge liegen (lokales Volume uploads oder S3-kompatibler Speicher). Image, Stack-Datei und Server bleiben unverändert, Updates lassen hochgeladene Themes unberührt. Als Beispiel dient im Folgenden das Beispiel-Theme mit dem Schlüssel beispiel – es lässt sich unverändert hochladen.

Im Plattform-Admin hochladen

  1. Als Plattform-Admin anmelden und Plattform-Admin → Darstellung (/admin/appearance) öffnen.
  2. Unter Template hochladen die ZIP-Datei wählen und Template hochladen klicken. Das Feld Schlüssel bleibt leer – dann gilt key aus theme.json. Ein eingetragener Schlüssel ersetzt ihn (praktisch, um eine Kopie unter neuem Namen anzulegen).
  3. Das Theme erscheint in der Liste mit dem Hinweis Hochgeladen. Mit Verwenden wird es für alle Besucher aktiv.
Die Anwendung prüft das Paket vollständig, bevor sie etwas speichert. Ist etwas falsch, bleibt alles beim Alten und die Seite zeigt alle gefundenen Fehler mit Datei und – bei CSS – Zeile, z. B. theme.css, Zeile 12: url(https://fonts.example/a.woff2) verweist auf eine fremde oder absolute Adresse. Die Regeln stehen unter Anforderungen an das Paket.
Der Schlüssel eines mitgelieferten Themes (quicktribe, mitternacht, arena, verein, schuetzen, reiterhof, parcours, business) lässt sich nicht überschreiben. Wer eines davon abwandeln möchte, lädt mit Kopie herunterladen eine Fassung mit eigenem Schlüssel (mein-mitternacht) herunter, ändert sie und lädt sie wieder hoch.

Neue Fassung, vorige Fassung, löschen

  • Neue Fassung: Eine ZIP-Datei mit demselben Schlüssel ersetzt das vorhandene Theme. Ist es aktiv, sehen Besucher die neue Fassung beim nächsten Seitenaufruf – ohne Neustart und ohne Cache-Probleme, weil sich die Adressen aller Theme-Dateien mit dem Inhalt ändern.
  • Vorige Fassung wiederherstellen: Die letzten fünf Fassungen bleiben als Archiv erhalten. Die Schaltfläche stellt die jüngste davon wieder her; die ersetzte Fassung wandert dabei ins Archiv. Zweimal hintereinander geklickt ist also wieder die Ausgangsfassung aktiv.
  • Herunterladen: liefert das Theme als ZIP-Datei – derselbe Inhalt lässt sich auf einer anderen Installation wieder hochladen. Bei mitgelieferten Themes heißt die Schaltfläche Kopie herunterladen (Schlüssel mein-<name>, Name mit „(Kopie)“).
  • Löschen: entfernt das Theme samt Archiv. War es aktiv, gilt sofort wieder das Standard-Theme quicktribe; die Seite weist darauf hin.
Alle Aktionen stehen im Protokoll des Plattform-Admins (platform.appearance.theme_uploaded, …theme_restored, …theme_deleted).

Per Konsole

Für Automatisierung, Installationen ohne Browserzugang oder wenn der Plattform-Admin gerade nicht erreichbar ist, gibt es dieselben Funktionen als Konsolenbefehle mit denselben Prüfregeln. Die ZIP-Datei muss dafür im Container liegen:
Alle Optionen stehen in der Referenz unter Betrieb → Konsole, Beispiele für den Alltag im Handbuch unter Konsole. Bei Portainer und Coolify laufen die Befehle in der Konsole des Containers app; die Datei kommt z. B. per docker cp auf dem Docker-Host in den Container. Bei einer Installation ohne Docker heißt der Aufruf runuser -u www-data -- php bin/console app:theme:import … im Verzeichnis current/. Der Benutzer, unter dem der Befehl läuft, spielt seit 1.7.3 keine Rolle: Läuft er als root (Standard bei docker compose exec), übergibt app:theme:import – wie jeder Konsolenbefehl, der in den lokalen Speicher schreibt – die geschriebenen Dateien und Verzeichnisse an den Eigentümer des Speicherverzeichnisses (im Image www-data), damit der Webserver sie ausliefern kann. Bei S3-kompatiblem Speicher entfällt das.

Anforderungen an das Paket

Hinweis für Entwickler: Theme im Image

Mitgelieferte Themes liegen im Image unter public/themes/<key>/ und werden vom Webserver statisch ausgeliefert. Für die Arbeit an der Anwendung selbst oder für ein eigenes, abgeleitetes Image kann ein Theme dort liegen (COPY themes/meine-marke /var/www/public/themes/meine-marke); sein Schlüssel ist dann wie bei den mitgelieferten reserviert, und es erscheint auf jeder Installation mit diesem Image in der Auswahl. Für den Betrieb ist der Upload der vorgesehene Weg – er übersteht Updates ohne Neubau und braucht keinen Zugriff auf den Server.