Theme Speichern Fehler
Beim Speichern des Themes kommt es bei Falscheingaben zu einem 500 Fehler.
Last updated
Beim Speichern des Themes kommt es bei Falscheingaben zu einem 500 Fehler.
Last updated
Gelegentlich kann es vorkommen, dass Du eine Einstellung im Theme oder einer anderen Erweiterung verändert hast und beim Speichern / Kompilieren daraufhin ein Fehler geworfen wird. Häufig sind die Fehlermeldungen von Shopware nicht verständlich und die Suche nach dem Fehler beginnt. Wir möchten Dir hier eine kleine Hilfestellung geben um häufige Fehlerquellen schneller aufzuspüren.
Beim Speichern eines Themes werden die in der Theme-Konfiguration gesetzten Werte angewendet und eine CSS-Datei (Stylesheet) für die Ausgabe in der Storefront erzeugt.
Um die Variablen der Theme-Konfiguration verwenden zu können wird im Hintergrund statt CSS ein sogenannter "Präprozessor" für CSS verwendet. Shopware 6 nutzt hierzu SASS/SCSS. Beim Speichern des Themes werden einzelne SCSS-Dateien in eine einfache CSS-Datei umgewandelt und die Variablen als feste Werte der jeweiligen Eigenschaft hinterlegt.
Existiert eine Variable nicht, ist falsch geschrieben oder liegt ein Syntaxfehler vor, wird dieser Prozess gestoppt und der Fehler erscheint in der Administration.
eine Variable wurde falsch geschrieben
es wurde eine Variable angegeben, die es nicht gibt
es wurde ein Syntaxfehler provoziert (das kann bereits passieren wenn ein Farbwert nur aus 5 statt aus 6 Ziffern besteht. Beispiel: #12345 vs. #123456 )
Eine neue Erweiterung wurde installiert und hat einen Fehler in einer SCSS-Datei
Individuelle Anpassungen im Theme können das Problem auslösen
Der Server hat nicht genug Arbeitsspeicher um die Kompilierung durchzuführen.
Die Ursachenforschung ist der erste Schritt zu Behebung des Fehlers. Oftmals ist nicht klar, ob ein Theme, eine App / ein Plugin oder Shopware selbst Auslöser eines Fehlers ist.
Überlege was zuletzt in der Theme-Konfiguration geändert wurde. Wurden hier eventuell erst kürzlich Anpassungen vorgenommen?
Gelegentlich kommt es vor, dass ein solcher Fehler bereits längere Zeit besteht und erst bei der Installation einer anderen Erweiterung auftaucht.
Du kannst jedes Theme ganz einfach als Ursache identifizieren oder auch ausschließen. Das hilft Dir herauszufinden, ob die Ursache in der Theme-Konfiguration eines Themes liegt. Denn auch Plugins und Apps verwenden oftmals Werte welche beim Speichern des Themes mit dem Kompiler verarbeitet werden. Gehe daher wie folgt vor:
Wähle den Verkaufskanal aus, in welchem das Theme zugewiesen ist, das sich nicht mehr speichern lässt.
Wähle im Reiter "Theme" über den Button "Theme ändern" das Standard-Theme aus
Klicke auf "Theme übernehmen"
Gehe nun in die Theme-Konfiguration und speichere diese einmal erneut
Lässt sich das Standard-Theme ebenfalls nicht speichern liegt der Fehler höchstwahrscheinlich in einem Plugin oder einer App.
Lässt sich das Standard-Theme speichern, liegt die Fehlerquelle in der Theme-Konfiguration oder individuellen Bearbeitungen des anderen Themes
Aktiviere nach der Prüfung wieder das ursprüngliche Theme für den Verkaufskanal
Ist die Fehlerquelle bekannt, sollte je nachdem die Theme-Konfiguration oder die einzelnen Erweiterungen durchgesehen werden.
Immer in kleinen Schritten arbeiten - nicht zu viele Änderungen auf einmal durchführen. Lieber nur wenige Veränderungen durchführen und zwischendurch immer wieder durch Speichern des Themes kompilieren. So kannst Du die Ursache leichter nachverfolgen, sollte eine Deiner Änderungen zu einem Fehler geführt haben.