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
- Als Plattform-Admin anmelden und Plattform-Admin → Darstellung (
/admin/appearance) öffnen. - Unter Template hochladen die ZIP-Datei wählen und Template hochladen klicken. Das Feld Schlüssel bleibt leer – dann gilt
keyaustheme.json. Ein eingetragener Schlüssel ersetzt ihn (praktisch, um eine Kopie unter neuem Namen anzulegen). - Das Theme erscheint in der Liste mit dem Hinweis Hochgeladen. Mit Verwenden wird es für alle Besucher aktiv.
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.
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 unterpublic/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.