// Shopware-Hilfe
Die Storefront sieht plötzlich ungestaltet aus, oder der Theme-Manager meldet beim Speichern einen Fehler? Dann kann Shopware das Theme nicht kompilieren, meist wegen eines Fehlers in den Styles eines Themes oder Plugins.
Kann Shopware das Theme nicht kompilieren, sieht die Storefront ungestaltet aus oder der Theme-Manager meldet einen Fehler. Meist steckt ein Fehler in den SCSS-Styles eines Themes oder Plugins dahinter, oft nach einem Update, bei dem sich Variablen oder Pfade geändert haben. Seltener sind fehlende Schreibrechte, ein voller Speicher oder ein Zeitlimit beim Kompilieren über den Browser. Über die Kommandozeile zeigt Shopware die genaue Datei und Zeile des Fehlers.
// Ursachen
Ein Tippfehler, eine fehlende Klammer oder ein Import, der ins Leere zeigt, stoppt das ganze Kompilieren.
Plugins bringen eigene SCSS-Dateien mit. Passt eines nach einem Update nicht mehr, scheitert das Theme als Ganzes.
Neue Shopware-Versionen entfernen oder benennen Variablen um, auf die ältere Themes noch zugreifen.
Beim Kompilieren über den Browser greifen die Limits des Servers. Große Themes brechen dann ab.
Shopware kann die fertigen Dateien nicht in den öffentlichen Ordner schreiben.
Nach Änderungen an Plugins kennt Shopware die neuen Theme-Dateien noch nicht.
Diese Schritte sind gefahrlos und grenzen die Ursache ein, bevor jemand am Shop etwas ändert.
Wer per SSH auf den Server kommt, kann die häufigsten Ursachen direkt angehen. Vorher Datenbank und Dateien sichern.
bin/console theme:compile kompiliert ohne das Zeitlimit des Browsers und zeigt die genaue Datei und Zeile des Fehlers.bin/console theme:refresh liest Themes und Plugins neu ein, etwa nach Änderungen an Plugins.bin/console assets:install spielt Bilder, Schriften und andere Dateien der Plugins neu ein.bin/console cache:clear leert danach den Cache.bin/console theme:compile nennt bei einem Fehler die betroffene Datei und meist auch die Zeile. Drei Arten von Meldungen kommen besonders häufig vor:
@import zeigt auf eine Datei, die verschoben wurde oder fehlt, etwa weil ein Plugin deaktiviert ist, auf dessen Styles das Theme aufbaut.Steht in der Meldung ein Pfad unter custom/plugins oder vendor, wissen Sie sofort, welches Plugin oder Theme der Auslöser ist.
Shopware kompiliert die Styles des Themes und aller aktiven Plugins zu einer gemeinsamen Datei. In der Datei theme.json legt das Theme fest, in welcher Reihenfolge Shopware-Standard, Plugins und eigene Styles geladen werden. Ein einzelner Fehler in irgendeinem Teil bricht deshalb den ganzen Vorgang ab, auch wenn das Plugin mit dem Design scheinbar nichts zu tun hat.
Stimmt das Design, aber Menü, Warenkorb-Fenster oder Filter funktionieren nicht mehr, fehlen meist die JavaScript-Dateien eines Plugins. Beim Kompilieren übernimmt Shopware nur Skripte, die ein Plugin fertig gebaut mitliefert. Fehlen sie, muss die Storefront mit bin/build-storefront.sh neu gebaut werden. Dafür braucht der Server Node.js, das viele einfache Hosting-Tarife nicht bieten.
vendor ändern. Beim nächsten Update sind die Änderungen weg, und der Fehler kommt zurück.Vor jedem größeren Update auf einer Kopie theme:compile ausführen: Läuft das ohne Fehler durch, ist die größte Hürde für den Live-Shop genommen. In unserer laufenden Shopware-Wartung gehört dieser Test zu jedem Update dazu.
Wenn die Fehlermeldung auf ein gekauftes Theme oder ein Plugin zeigt, das Sie nicht selbst anpassen können, oder wenn der Shop gerade ohne Design verkauft. Wir beheben den Fehler und verlagern Anpassungen so, dass sie Updates überstehen. Dauerhaft ruhiger wird es mit einem eigenen, updatefesten Theme.
// Soforthilfe
Schicken Sie uns kurz, was passiert ist und was sich zuletzt geändert hat, gern mit Screenshot. Ist der Shop down, helfen wir über den 24/7 Notfallservice innerhalb von 30 Minuten.
// Häufige Fragen
Weil das Theme nach dem Update nicht neu kompiliert werden konnte. Meist passt ein Theme oder Plugin nicht zu geänderten Variablen der neuen Version.
Technisch funktioniert der Shop oft weiter, er wirkt aber unseriös, und manche Schaltflächen sind schwer zu finden. Das Problem sollte Vorrang haben.
Am zuverlässigsten beim Kompilieren über die Kommandozeile. Im Admin erscheint oft nur eine allgemeine Meldung.
Mit einem Theme, das die Vorlagen von Shopware erweitert statt ersetzt, und mit Updates, die vorher auf einer Kopie getestet werden.
Meist nicht von Hand. Beim Aktivieren oder Aktualisieren eines Plugins kompiliert Shopware das Theme in der Regel selbst. Scheitert das, bleibt das Design kaputt, bis die Ursache behoben und das Theme erneut kompiliert ist.
Weil das Kompilieren über den Browser an das Zeitlimit des Servers gebunden ist und oft nur eine allgemeine Fehlermeldung zeigt. Über die Kommandozeile läuft es ohne dieses Limit und nennt die genaue Datei und Zeile.