Shopware 6.6.0.0

Guide for the Shopware Major Release of 2024

As in every annual major release of Shopware, Shopware version 6.6 also includes exciting innovations but also so-called breaking changes - this is part of Shopware's update strategy.

After the update

Adjust default layout for product pages

In addition to the shopping experience layouts for product pages that Shopware subsequently implements, there is a standard product page in all Shopware versions < 6.6. This standard product page was not part of the shopping experiences and was always used when no shopping experience layout was assigned for product pages. This was the predominantly used representation of the product page so far.

With Shopware 6.6, this logic changes completely and adapts to the behavior of category page layouts. The standard product page is replaced by the standard product page layout of the shopping experiences, which is now automatically assigned to all products. The theme standard view of the product page is replaced by the Default product page Layout of the shopping experiences.

The product page of your shop will therefore change in the display of the storefront until you have adjusted the product page layout of the shopping experiences.

Theme default layout (< 6.6)

In the default product detail layout of the theme, the product name is placed in the buy box.

Theme Standard Ansicht

Shopping experience default layout (>= 6.6)

To restore the original display, you can create your own layout for the product page. We'll show you how to do this in just a few steps:

Default layout

As a second option, you can use our demodata plugin to directly import the product page layout:

Demodata for Zenit Design themesShopware Store

Error - Could not assign child-theme

In Shopware from 6.6.4 versions, a Shopware bug in the child themes may cause an error when assigning the sales channel.

Error message

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

Cause

The cause of the error goes back to a so-called breaking change in the major update to Shopware 6.6, in which the path to the storefront JavaScript was changed.

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

Shopware had planned that existing themes that still reference the old JavaScript path would not throw an error and would continue to be compatible. However, due to a change in Shopware 6.6.4, child themes that reference the old JavaScript structure now generate an error and can no longer be assigned.

The reason for this error message is a current malfunction starting with Shopware 6.6.3, where the theme.json is searched for the new JavaScript path, even if it has not been referenced. Child themes whose JavaScript path has not been adapted to the new Shopware 6.6 structure can no longer be assigned in these versions.

Shopware already has a fix, but it has not yet made it into the Shopware Core (as of 6.6.5.1):

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

Examples

old Javascript structure - leads to error

new Javascript structure - compatible with Shopware 6.6

both Javascript structures - compatible with all Shopware versions

Proposed solution

Update the child theme via the download on our website as described in the Child Theme Update article or wait for Shopware to fix the problem in one of the future Shopware versions.

All of our child themes from version 4.x onwards were made compatible and made available with the release of the major release 6.6 of Shopware. We created the new folder structure and retained the old one - so the child themes are compatible for all versions.

Please note that you have to copy your individual Javascript programming into the Javascript structure so that it will be executed from Shopware 6.6 onwards.