# Textbausteine zeigen technischen Namen

### Problembeschreibung

Seit Shopware 6.4.17.0 erhalten wir immer wieder Support-Anfragen über nicht korrekt aufgelöste Textbausteine in der Storefront. Shopware hat seit diesem Update massive Probleme beim Auflösen der Textbausteine in der Theme-Vererbung.

Die Ursache liegt in der fehlerhaften Vererbung von Textbausteinen. Ein Theme, welches eigene Textbausteine enthält, kann diese in bestimmten Konstellationen nicht mehr korrekt an Child-Themes oder Theme Duplikate vererben. Auch werden Textbausteine unterschiedlich gecached was zu Fehlern bei der Verwendung von Produktvergleichen und mehreren Verkaufskanälen führen kann.

Die Fehler sind möglicherweise auf diese Änderung in Shopware auf Version 6.4.17.0 zurückzuführen: <https://github.com/shopware/platform/blob/09f3075a9810dddde900207d9a05fd7a7be9f41c/changelog/release-6-4-17-0/2022-08-02-fix-storefront-show-incorrect-snippets.md>

#### Wen betrifft das Problem?

* Shops mit mehreren Verkaufskanälen (<https://issues.shopware.com/issues/NEXT-24057>) - **Teilweise gelöst in 6.4.18.0**
* Shops mit Produktvergleich Verkaufskanälen (<https://issues.shopware.com/issues/NEXT-24692>) - **Ungelöst**
* Shops mit Duplikat-Themes (<https://issues.shopware.com/issues/NEXT-24692>) - **Ungelöst**
* Shops mit **veralteten** Child-Themes - **Lösung weiter unten**
* und weitere:
  * <https://issues.shopware.com/issues/NEXT-24159> - **ungelöst**
  * <https://issues.shopware.com/issues/NEXT-24678> - **gelöst**
  * <https://issues.shopware.com/issues/NEXT-24764> - **backlog**

### Lösungsvorschläge

Leider lassen sich die meisten Bugs nicht über einen Workaround beheben, sodass wir alle an dieser Stelle auf die Behebung der Issues durch Shopware angewiesen sind. Wir haben jedoch Lösungsvorschläge für die folgenden Situationen zusammengestellt:

#### Shops mit veralteten Child-Themes

Bei Shops mit veralteten Child-Themes ist es weniger ein Fehler, sondern eine nun fehlende Voraussetzung im Child-Theme. Grundsätzlich lässt sich bei der Verwendung unserer Child-Themes das Problem daher relativ einfach beheben.

Führe ein Child-Theme Update auf Version 2.11.0 oder höher durch. Darin enthalten ist ein neuer Vermerk für die Vererbung von Theme-Konfigurationen und auch der Snippets.

Folge dazu einfach unserem Update Guide: <https://themedocs-sw6.zenit.design/update-guides/theme-2.11.0#2.-child-theme-aktualisieren>

{% hint style="success" %}
Ein toller Nebeneffekt ist, dass durch die neue Konfigurations-Vererbung künftig keine Child-Theme Updates mehr notwendig sind!
{% endhint %}

Solltest Du ein eigenes Child-Theme verwenden, kannst Du auch die `configInheritance` selbst hinterlegen. Eine Anleitung dazu findest Du hier: <https://developer.shopware.com/docs/guides/plugins/themes/theme-configuration#config-inheritance>

#### Shops mit Duplikat-Themes von einem Child-Theme

Manche Shops verwenden auch die Shopware-eigene Funktion der Theme-Duplikate. Auch hier lässt sich das Problem beobachten. Bisher konnte das Problem bei Shops mit einem Duplikat eines Child-Themes beobachten. Beispiel:

Theme Stratus > Theme Stratus Set XY > Theme Duplikat

Ein Duplikat-Theme von einem Child-Theme erbt nicht Textbausteine aus dem gekauften Haupt-Theme. Das Problem lässt sich lösen, indem die Textbausteine aus dem gekauften Haupt-Theme in das Child-Theme kopiert wurden. Das Theme-Duplikat vom Child-Theme findet dann wieder die Textbausteine.

Gehe dazu wie folgt vor:

* Schalte dich per FTP auf Deinen Server auf
* Navigiere in das Verzeichnis ausgehend vom Shopware Hauptverzeichnis: `custom/plugins/zenitPlatform{THEMENAME}/src/Resources`
* kopiere den Ordner `snippet` in das Verzeichnis des Child-Themes, z.B. `custom/plugins/zenitPlatform{THEMENAME}Set{X}/src/Resources`
* Fertig


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://themedocs.zenit.design/faq/fehler/textbausteine-zeigen-technischen-namen.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
