Shopware 6: Theme kompilieren, wenn CSS-Änderungen nicht ankommen
Ahmad Jarkas · Shopware-Entwickler, ErlangenShopware 6 baut aus SCSS und JavaScript fertige Dateien für die Storefront. Wer am Theme arbeitet, muss diesen Build anstoßen – sonst bleibt alles beim Alten. Drei Befehle, eine Reihenfolge.
Der Standardfall
bin/console theme:compile
Kompiliert alle zugewiesenen Themes für alle Verkaufskanäle. Dauert je nach Server einige Sekunden bis Minuten. Danach Cache leeren, falls alte Dateien noch ausgeliefert werden.
Wenn sich die Theme-Konfiguration geändert hat
bin/console theme:refresh bin/console theme:compile
theme:refresh liest die theme.json neu ein – nötig, wenn Sie Felder, Farben oder Schriften in der Konfiguration ergänzt haben, nicht bei reinen SCSS-Änderungen.
Theme einem Verkaufskanal zuweisen
bin/console theme:change
Fragt interaktiv Verkaufskanal und Theme ab. Im Admin geht dasselbe unter Verkaufskanäle → Theme.
Im Admin statt Konsole
Unter Inhalte → Themes → Theme öffnen → Änderungen speichern löst Shopware das Kompilieren selbst aus. Das reicht für Farb- und Logoänderungen über die Oberfläche. Für Änderungen an Dateien im Theme-Ordner braucht es die Konsole.
Fehlerbilder und Ursachen
| Fehler | Ursache |
|---|---|
| Build bricht mit Speicherfehler ab | memory_limit zu klein – 512 MB sind Minimum, 1 GB entspannt |
| Storefront ohne Styles | Kompilieren abgebrochen, public/theme leer – erneut kompilieren |
| JS-Änderung nicht sichtbar | JavaScript wird separat gebaut (bin/build-storefront.sh), nicht über theme:compile |
| Nur ein Kanal aktualisiert | Theme ist dem anderen Kanal nicht zugewiesen |
public/theme/. Sie werden beim nächsten Kompilieren überschrieben. Änderungen gehören ins Theme oder Plugin.Theme-Fehler nach einem Update gehören zu den häufigsten Notfällen – meist ist es die Vererbung, nicht der Build.
Shopware-Entwickler aus Erlangen. Shopware 5 und 6 Advanced Developer.
Über uns