Theme anlegen & aktivieren

Von theme:create bis theme:change

Vom leeren Verzeichnis zum aktiven Theme sind es nur wenige Schritte. Shopware bringt dafür eigene CLI-Befehle mit.

Theme erzeugen

Der schnellste Start ist der Generator – er legt die Grundstruktur samt theme.json an:

bin/console theme:create MyTheme

Das Ergebnis liegt unter custom/plugins/MyTheme/ mit der zentralen Konfiguration in src/Resources/theme.json.

Erkennen und installieren

Ein Theme ist technisch ein Plugin, wird also wie eines installiert:

bin/console plugin:refresh                 # neues Theme/Plugin erkennen
bin/console plugin:install --activate MyTheme
bin/console cache:clear

Einem Sales Channel zuweisen

Ein installiertes Theme wirkt erst, wenn es einem Verkaufskanal zugewiesen ist. Interaktiv geht das per CLI:

bin/console theme:change

Der Befehl fragt nacheinander Verkaufskanal und Theme ab und verknüpft beide. Alternativ übernimmt das der Theme Manager in der Administration.

Kompilieren

Nach Änderungen an SCSS oder theme.json müssen die Assets neu gebaut werden:

bin/console theme:compile

Ohne Kompilieren bleiben Style-Änderungen in der Storefront unsichtbar – ein häufiger Stolperstein am Anfang.

Die wichtigsten Befehle im Überblick

Befehl	Zweck
`theme:create`	Grundgerüst anlegen
`plugin:refresh`	Theme erkennen
`plugin:install --activate`	installieren + aktivieren
`theme:change`	Theme einem Verkaufskanal zuweisen
`theme:compile`	Assets neu bauen

Kurz: anlegen (theme:create), installieren (plugin:install), einem Kanal zuweisen (theme:change), bauen (theme:compile). Danach ist das Theme live.