Shopware 6.5.0.0
Guide for the Shopware Major Release of 2023
Last updated
Was this helpful?
Guide for the Shopware Major Release of 2023
Last updated
Was this helpful?
There are certain areas in the theme whose foreground color is determined based on the background color. This is the case with the primary buttons, for example. The contrast ratio determines when the brightness of the color changes from "dark" to "light".
Example:
In Shopware 6.5, the calculation basis has been adapted to the Web Content Accessibility Guidelines (WCAG). Due to this new standard, the foreground color on the buttons may now be displayed differently.
You can adjust the threshold under Typo & colors > Theme colors > Basic settings in the new configuration Contrast Threshold (1).
If you have implemented individual fonts into your shop through a little programming, you should now check the implementation again.
CSS implementations of fonts without child themes via the public/fonts folder are not affected by this.
With the update to Shopware 6.5, Shopware has revised the theme assets. Assets such as fonts can no longer be accessed via the relative path ../assets/font/ as in Shopware 6.4. In SCSS, the font paths can now be accessed with a variable #{$app-css-relative-asset-path}.
So adjust your paths like this example:
If no update is displayed in the administration, although a new version is already listed in the store, your current Shopware version is not yet compatible with the new update. This currently affects all Shopware stores with a version 6.4.x.x and lower.
Our themes are always compatible with the latest Shopware version. Thereby we try to provide new version always also for older Shopware versions. With the changes of Shopware in version 6.5.x.x this was unfortunately not possible due to structural changes (called "breaking changes" by Shopware) of the shop software.
Theme versions 2.x.x are compatible with Shopware 6.4.x.x but not with 6.5.x.x Theme version 3.x.x are compatible with Shopware 6.5.x.x but not with 6.4.x.x
Therefore, before the update to version 6.5.x.x, no update of the theme to version 3.x.x is displayed and vice versa, the currently installed version of the theme 2.x.x appears as incompatible.
Update Shopware to the current Shopware 6.5.x.x in the usual way. After the update, the new theme version is available for download and update via the administration as usual.
Shopware suggests disabling incompatible apps/themes during the update process. In our own demos we did not do this with our themes. From the point of view of our themes, this is not necessary, however, this may well be necessary for other extensions.
If you want to be sure, disable the theme temporarily and update it after the shop update is done.
A backup of the store is necessary as with every update.
You can find out more about this in the Shopware update guide:
You can find out more about “Linking to assets” in the Shopware documentation:
