Shopware 6.5.0.0

Guide for the Shopware Major Release of 2023

After the update

Adjust contrast threshold

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).

Update local font paths

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}.

You can find out more about this in the Shopware update guide: https://github.com/shopware/shopware/blob/v6.5.6.0/UPGRADE-6.5.md#storefront-theme-asset-refactoring

So adjust your paths like this example:

// Old
@font-face {
  font-display: swap; /* Check https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face/font-display for other options. */
  font-family: 'Raleway';
  font-style: normal;
  font-weight: 400;
  src: url('raleway-v29-latin-regular.woff2') format('woff2'); /* Chrome 36+, Opera 23+, Firefox 39+, Safari 12+, iOS 10+ */
}

// New
/* raleway-regular - latin */
@font-face {
  font-display: swap; /* Check https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face/font-display for other options. */
  font-family: 'Raleway';
  font-style: normal;
  font-weight: 400;
  src: url('raleway-v29-latin-regular.woff2') format('woff2'); /* Chrome 36+, Opera 23+, Firefox 39+, Safari 12+, iOS 10+ */
}

You can find out more about “Linking to assets” in the Shopware documentation: 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?

Why is the new theme version 3.0.0 not displayed?

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.

Reason

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.

Solution

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.

Last updated 2 months ago