Theme kaufenThemesSupport

Textbausteine zeigen technischen Namen

Besteht seit Shopware 6.4.17.0

Problembeschreibung

Seit Shopware 6.4.17.0 erhalten wir immer wieder Support-Anfragen über nicht korrekt aufgelöste Textbausteine in der Storefront. Shopware hat seit diesem Update massive Probleme beim Auflösen der Textbausteine in der Theme-Vererbung.

Die Ursache liegt in der fehlerhaften Vererbung von Textbausteinen. Ein Theme, welches eigene Textbausteine enthält, kann diese in bestimmten Konstellationen nicht mehr korrekt an Child-Themes oder Theme Duplikate vererben. Auch werden Textbausteine unterschiedlich gecached was zu Fehlern bei der Verwendung von Produktvergleichen und mehreren Verkaufskanälen führen kann.

Die Fehler sind möglicherweise auf diese Änderung in Shopware auf Version 6.4.17.0 zurückzuführen: https://github.com/shopware/platform/blob/09f3075a9810dddde900207d9a05fd7a7be9f41c/changelog/release-6-4-17-0/2022-08-02-fix-storefront-show-incorrect-snippets.md

Wen betrifft das Problem?

Lösungsvorschläge

Leider lassen sich die meisten Bugs nicht über einen Workaround beheben, sodass wir alle an dieser Stelle auf die Behebung der Issues durch Shopware angewiesen sind. Wir haben jedoch Lösungsvorschläge für die folgenden Situationen zusammengestellt:

Shops mit veralteten Child-Themes

Bei Shops mit veralteten Child-Themes ist es weniger ein Fehler, sondern eine nun fehlende Voraussetzung im Child-Theme. Grundsätzlich lässt sich bei der Verwendung unserer Child-Themes das Problem daher relativ einfach beheben.

Führe ein Child-Theme Update auf Version 2.11.0 oder höher durch. Darin enthalten ist ein neuer Vermerk für die Vererbung von Theme-Konfigurationen und auch der Snippets.

Folge dazu einfach unserem Update Guide: https://themedocs-sw6.zenit.design/update-guides/theme-2.11.0#2.-child-theme-aktualisieren

Ein toller Nebeneffekt ist, dass durch die neue Konfigurations-Vererbung künftig keine Child-Theme Updates mehr notwendig sind!

Solltest Du ein eigenes Child-Theme verwenden, kannst Du auch die configInheritance selbst hinterlegen. Eine Anleitung dazu findest Du hier: https://developer.shopware.com/docs/guides/plugins/themes/theme-configuration#config-inheritance

Shops mit Duplikat-Themes von einem Child-Theme

Manche Shops verwenden auch die Shopware-eigene Funktion der Theme-Duplikate. Auch hier lässt sich das Problem beobachten. Bisher konnte das Problem bei Shops mit einem Duplikat eines Child-Themes beobachten. Beispiel:

Theme Stratus > Theme Stratus Set XY > Theme Duplikat

Ein Duplikat-Theme von einem Child-Theme erbt nicht Textbausteine aus dem gekauften Haupt-Theme. Das Problem lässt sich lösen, indem die Textbausteine aus dem gekauften Haupt-Theme in das Child-Theme kopiert wurden. Das Theme-Duplikat vom Child-Theme findet dann wieder die Textbausteine.

Gehe dazu wie folgt vor:

  • Schalte dich per FTP auf Deinen Server auf

  • Navigiere in das Verzeichnis ausgehend vom Shopware Hauptverzeichnis: custom/plugins/zenitPlatform{THEMENAME}/src/Resources

  • kopiere den Ordner snippet in das Verzeichnis des Child-Themes, z.B. custom/plugins/zenitPlatform{THEMENAME}Set{X}/src/Resources

  • Fertig

Last updated