Shopware 6.5.0.0

Leitfaden für das Shopware Major Release von 2023

Nach dem Update

Kontrast Schwellenwert anpassen

Es gibt im Theme bestimmte Bereiche, deren Vordergrundfarbe anhand der Hintergrundfarbe ermittelt wird. Das ist beispielsweise bei den Primärbuttons der Fall. Das Kontrastverhältnis bestimmt, wann die Helligkeit der Farbe von "dunkel" zu "hell" wechselt.

Beispiel:

In Shopware 6.5 wurde die Berechnungsgrundlage auf die Web Content Accessibility Guidelines (WCAG) angepasst. Durch diesen neuen Standard kann es sein, dass die Vordergrundfarbe auf den Buttons nun anders dargestellt wird.

Du kannst den Schwellenwert unter Typografie & Farben > Theme-Farben > Grundeinstellungen in der neuen Konfiguration Kontrast Schwellenwert (1) anpassen.

Pfade lokaler Schriften aktualisieren

Solltest Du individuelle Schriften durch eine kleine Programmierung in Deinen Shop mit Hilfe eines Child-Themes implementiert haben, solltest Du nun die Implementierung erneut prüfen.

CSS Implementierungen von Schriften ohne Child-Theme über den public/fonts Ordner sind hiervon nicht betroffen.

Mit dem Update auf Shopware 6.5 hat Shopware die Theme-Assets überarbeitet. Assets wie zum Beispiel Schriften können nicht mehr wie in Shopware 6.4 über den relativen Pfad ../assets/font/ angesprochen werden. In SCSS kann nun mit einer Variable #{$app-css-relative-asset-path} auf die Pfade der Schriften zugegriffen werden.

Passe daher Deine Pfade wie in diesem Beispiel an:

Mehr zum Thema "Linking to assets" findest Du in der Shopware Doku: https://developer.shopware.com/docs/guides/plugins/themes/add-assets-to-theme.html#linking-to-assets

Warum wird die neue Theme Version 3.0.0 nicht angezeigt?

Wird in der Administration kein Update angezeigt, obwohl im Store bereits eine neue Version aufgeführt wird, ist Deine aktuelle Shopware Version noch nicht mit dem neuen Update kompatibel. Das betrifft aktuell alle Shopware Shops mit einer Version 6.4.x.x und kleiner.

Unsere Themes sind grundsätzlich mit der aktuellsten Shopware Version kompatibel. Dabei bemühen wir uns, neue Version immer auch für ältere Shopware Versionen bereitzustellen. Mit den Änderungen von Shopware in Version 6.5.x.x war dies leider auf Grund von strukturellen Änderungen (von Shopware "Breaking Changes" genannt) der Shopsoftware so nicht möglich.

Ursache

Theme Versionen 2.x.x sind kompatibel mit Shopware 6.4.x.x aber nicht 6.5.x.x Theme Versionen 3.x.x sind kompatibel mit Shopware 6.5.x.x aber nicht 6.4.x.x

Daher wird vor dem Update auf Version 6.5.x.x auch noch kein Update des Themes auf Version 3.x.x angezeigt und umgekehrt erscheint die aktuell installierte Version des Themes 2.x.x als nicht kompatibel.

Lösungsvorschlag

Aktualisiere Shopware auf die aktuelle Shopware 6.5.x.x auf gewohntem Weg. Nach dem Update steht Dir die neue Theme Version über die Administration zum Download und Update wie gewohnt zur Verfügung.

Shopware schlägt vor, inkompatible Apps / Themes während des Update-Vorgangs zu deaktivieren. In unseren eigenen Demos haben wir das mit unseren Themes nicht gemacht. Aus Sicht unserer Themes ist das nicht notwendig, jedoch kann dies bei anderen Erweiterungen durchaus notwendig sein.

Wenn Du sicher gehen willst, deaktiviere das Theme vorübergehend und aktualisiere es nach erfolgtem Update.

Eine Sicherung des Shops ist wie bei jedem Update notwendig.

Last updated