Shopware 6.6.0.0

Leitfaden für das Shopware Major Release von 2024

Wie in jedem jährlichen Major Release von Shopware gibt es auch mit Shopware in Version 6.6 wieder spannende Neuerungen aber auch sogenannte Breaking Changes - das ist Teil der Shopware Update-Strategie.

Nach dem Update

Standardlayout für Produktseiten anpassen

Neben den von Shopware nachträglich implementieren Erlebniswelten Layouts für Produktseiten gibt es in allen Shopware Versionen < 6.6 eine Standard Produktseite. Diese Standard Produktseite war nicht Teil der Erlebniswelten und wurde immer dann verwendet, wenn kein Erlebniswelten Layout für Produktseiten zugewiesen wurde. Das war die bisher überwiegend genutzt Darstellung der Produktseite.

Mit Shopware 6.6 ändert sich diese Logik komplett und gleicht sich dem Verhalten von Kategorieseite-Layouts an. Die Standard Produktseite wird abgelöst durch das Standard Produktseite-Layout der Erlebniswelten, welches nun automatisch allen Produkten zugewiesen ist. Die Theme Standard-Ansicht der Produktseite wird also durch das Standard Produktseite-Layout der Erlebniswelten ersetzt.

Die Produktseite Deines Shops wird sich daher in der Darstellung der Storefront verändern, bis Du das Produktseite-Layout der Erlebniswelten nach Deinen Wünschen angepasst hast.

Theme Standard Produktseite (< 6.6)

In der bisherigen Theme Standard-Ansicht lag der Produktname über der rechten Buybox neben der Galerie.

Theme Standard Ansicht

Standard Produktseite-Layout (>= 6.6)

Um die ursprüngliche Darstellung wiederherzustellen, kannst Du Dein eigenes Layout für die Produktseite erstellen. Wir zeigen Dir hier, wie das in nur wenigen Schritten gemacht wird:

Standardlayout

Als zweite Möglichkeit kannst Du unser Demodaten Plugin verwenden ,um das Produktseiten-Layout direkt zu importieren:

Demodaten für Zenit Design ThemesShopware Store

Fehler - Child-Theme kann nicht zugewiesen werden

In Shopware ab Version 6.6.4 kommt es durch einen Shopware Bug bei den Child-Themes ggf. zu einem Fehler bei der Zuweisung zum Verkaufskanal.

Fehlermeldung

Unable to load file "custom/plugins/zenitPlatform{THEME}Set{NUMMER}/src/Resources/app/storefront/dist/storefront/js/zenit-platform-horizon-set1/zenit-platform-{theme}-set{nummer}.js". Did you forget to build the theme? Try running ./bin/build-storefront.sh"). with these parameters: ...

Ursache

Der Fehlerursache geht auf einen sogenannten Breaking-Change im Major-Update auf Shopware 6.6 zurück, bei dem der Pfad zum Storefront Javascript geändert wurde.

shopware/UPGRADE-6.6.md at v6.6.0.0-rc1 · shopware/shopwareGitHub

Dabei war es seitens Shopware geplant, dass bestehende Themes, welche noch auf den alten Javascript-Pfad verweisen keinen Fehler werfen und weiterhin kompatibel sein sollten. Durch eine Änderung in Shopware 6.6.4 erzeugen Child-Themes mit verweis auf die alte Javascript-Struktur nun jedoch einen Fehler und lassen sich nicht mehr zuweisen.

Hintergrund dieser Fehlermeldung ist ein aktuelles Fehlverhalten ab Shopware 6.6.3 bei welchen in der theme.json nach dem neuen Javascript-Pfad gesucht wird, auch wenn dieser nicht referenziert wurde. Child-Themes deren Javascript-Pfad nicht an die neue Shopware 6.6 Struktur angepasst wurde können in diesen Versionen nicht mehr zugewiesen werden.

Seitens Shopware gibt es bereits einen Fix, der es aber bisher (Stand 6.6.5.1) noch nicht in den Shopware Core geschafft hat:

Merge branch 'NEXT-37454/ignore-old-js-paths-in-resolve-files' into '… · shopware/shopware@59675b9GitHub

Beispiele

alte Javascript-Struktur - führt zu Fehler

neue Javascript-Struktur - kompatibel zu Shopware 6.6

beide Javascript-Strukturen - kompatibel mit allen Shopware Versionen

Lösungsvorschlag

Aktualisiere das Child-Theme über den Download auf unserer Webseite, wie unter dem Beitrag Child-Theme Update beschrieben oder warte darauf, dass Shopware das Problem in einer der künftigen Shopware Versionen behebt.

Alle unsere Child-Themes ab Version 4.x wurden mit Erscheinen des Major Release 6.6 von Shopware kompatibel gemacht und zur Verfügung gestellt. Dabei haben wir die neue Ordnerstruktur angelegt und die alte beibehalten - somit sind die Child-Themes für alle Versionen kompatibel.

Beachte, dass Du Deine individuellen Javascript-Programmierungen in die Javascript-Struktur kopierst, damit diese ab Shopware 6.6 ausgeführt werden.