Text modules show technical name

Exists since Shopware 6.4.17.0

Problem description

Since Shopware 6.4.17.0 we keep receiving support requests about not correctly resolved text snippets in the storefront. Shopware has had massive problems resolving the text snippets in the theme inheritance since this update.

The cause lies in the incorrect inheritance of text snippets. A theme that contains its own text snippets can no longer inherit them correctly to child themes or theme duplicates in certain constellations. Text snippets are also cached differently, which can lead to errors when using product comparisons and multiple sales channels.

The errors may be due to this change in Shopware to version 6.4.17.0: https://github.com/shopware/platform/blob/09f3075a9810dddde900207d9a05fd7a7be9f41c/changelog/release-6-4-17-0/2022-08-02-fix-storefront-show-incorrect-snippets.md

Who does the problem affect?

• Stores with multiple sales channels (https://issues.shopware.com/issues/NEXT-24057) - Partially solved in 6.4.18.0

• Stores with product comparison sales channels (https://issues.shopware.com/issues/NEXT-24692) - Unsolved

• Stores with duplicate themes (https://issues.shopware.com/issues/NEXT-24692) - Unsolved

• Stores with outdated child themes - Solution below

• something else:

  • https://issues.shopware.com/issues/NEXT-24159 - Unsolved

  • https://issues.shopware.com/issues/NEXT-24678 - Solved

  • https://issues.shopware.com/issues/NEXT-24764 - Backlog

Possible solutions

Unfortunately, most bugs cannot be fixed via a workaround, so we all have to rely on Shopware to fix the issues at this point. However, we have compiled suggested solutions for the following situations:

Shops with outdated child themes

For shops with outdated child themes, it is not so much an error, but a now missing requirement in the child theme. Basically, when using our child themes, the problem can therefore be fixed easily.

Perform a child theme update to version 2.11.0 or higher. This includes a new entry for inheritance of theme configurations and also the snippets.

Just follow our update-guide.

A great side effect is that the new configuration inheritance will eliminate the need for child theme updates in the future!

If you want to use your own child theme, you can also use the configInheritance yourself. You can find instructions here: https://developer.shopware.com/docs/guides/plugins/themes/theme-configuration#config-inheritance

Stores with duplicate themes from a child theme

Some stores also use Shopware's own theme duplicates feature. The problem can be observed here as well. So far, the problem could be observed with stores using a duplicate of a child theme.

Example:

Theme Stratus > Theme Stratus Set XY > Theme Duplicate

A duplicate theme from a child theme does not inherit text snippets from the purchased main theme. The problem can be solved by copying the text snippets from the purchased main theme to the child theme. The theme duplicate from the child theme will then find the text snippets again.

Proceed as follows:

• Connect to your server via FTP

• Navigate to the directory starting from the Shopware main directory: custom/plugins/zenitPlatform{THEMENAME}/src/Resources

• copy the folder snippet into the child theme directory, e.g.B.custom/plugins/zenitPlatform{THEMENAME}Set{X}/src/Resources