Theme Speichern Fehler

Beim Speichern des Themes kommt es bei Falscheingaben zu einem 500 Fehler.

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.

Was beim Speichern passiert

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.

Häufige Ursachen sind:

1. eine Variable wurde falsch geschrieben

2. es wurde eine Variable angegeben, die es nicht gibt

3. es wurde ein Syntaxfehler provoziert (das kann bereits passieren wenn ein Farbwert nur aus 5 statt aus 6 Ziffern besteht. Beispiel: ❌ #12345 vs. ✅ #123456 )

4. Eine neue Erweiterung wurde installiert und hat einen Fehler in einer SCSS-Datei

5. Individuelle Anpassungen im Theme können das Problem auslösen

6. Der Server hat nicht genug Arbeitsspeicher um die Kompilierung durchzuführen.

Was kannst Du tun?

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.

Bearbeitungen prüfen

Überlege was zuletzt in der Theme-Konfiguration geändert wurde. Wurden hier eventuell erst kürzlich Anpassungen vorgenommen?

Seit wann existiert der Fehler

Gelegentlich kommt es vor, dass ein solcher Fehler bereits längere Zeit besteht und erst bei der Installation einer anderen Erweiterung auftaucht.

Theme als Ursache identifizieren

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.