Zusatzfeld in der Erlebniswelt ausgeben

Zusatzfelder sind eine Grundfunktion von Shopware 6 und bieten dir die Möglichkeit, Produkte, Kategorien oder Hersteller individuell zu erweitern. Mit Zusatzfeldern kannst du flexibel zusätzliche Informationen speichern und bei Bedarf in der Storefront ausgeben.

Da weder Shopware noch ThemeWare® wissen können, in welche Datei bzw. in welchem Twig-Block dein individuelles Zusatzfeld integriert werden soll, müssen individuelle Zusatzfelder manuell in die Storefront eingebunden werden.

Dies geht entweder mit einem CMS-Element in einem Erlebniswelt-Layout oder über eine individuelle Template-Anpassung.

CMS-Element

• Vorteile

  • Umsetzung ist sehr einfach

• Nachteile

  • erst ab Shopware 6.6.9 verfügbar

  • keine Abfrage ob ein Zusatzfeld leer ist möglich

Template-Anpassung

• Vorteile

  • schon vor Shopware 6.6.9 verfügbar

  • eine Abfrage ob ein Zusatzfeld leer ist möglich

• Nachteile

  • Umsetzung ist recht komplex

In dieser Anleitung erklären wir dir wie du Zusatzfelder mit einem CMS-Element in der Storefront ausgeben kannst.

Hinweis: Wie du ein Zusatzfeld mit einer Template-Anpassung in der Storefront ausgeben kannst, erfährst du in der Anleitung Zusatzfelder in der Storefront ausgeben.

Hinweis: Individuelle Zusatzfelder werden ab Shopware 6.6.9 in das CMS-System integriert. Vor Shopware 6.6.9 kannst du individuelle Zusatzfelder nur mit einer Template-Anpassung in der Storefront ausgeben: Zusatzfelder in der Storefront ausgeben

---

Zusatzfeld mit einem CMS-Element ausgeben

Dank der Integration von individuellen Zusatzfeldern in das CMS-System von Shopware 6 lassen sich Zusatzfelder nahtlos in Textfelder einbinden.

In der folgenden Schritt-für-Schritt-Anleitung binden wir das individuelle Zusatzfeld "Sicherheitshinweis" mit einem CMS-Block auf der Produktdetailseite in der Storefront ein.

Tipp: Wie du ein individuelles Zusatzfeld anlegst, erfährst du in der Anleitung Zusatzfelder (Custom Fields)

Zusatzfeld einem CMS-Block zuordnen

1) Erlebniswelt bearbeiten

Wechsel in die Erlebniswelt-Verwaltung:

"Inhalte" => "Erlebniswelten"

Öffne dort das CMS-Layout deiner Produktdetailseiten um das Layout zu bearbeiten.

2) CMS-Block einfügen

Füge nun in dein Layout einen CMS-Block aus der Kategorie "Text" ein.

3) Einstellungen des CMS-Elements öffnen

Klicke auf das "Zahnrad"-Icon oben rechts im entsprechenden Text-Element um die Element-Einstellungen zu öffnen.

CMS-Slot ⇒ Aktions-Buttons

Hinweis: Das Zahnrad-Icon erscheint wenn du den CMS-Block angeklickt hast und sich die Maus innerhalb des Blocks befindet.

4) Zusatzfeld einfügen

Zum einfügen hast du in Shopware 6.6.9.0 zwei Möglichkeiten:

• Datenzuordnung (siehe 4.1)

• Variable (siehe 4.2)

4.1) Zusatzfeld zuordnen

Die ist die unkompliziertere Variante, das einfügen von weiteren Zusatzfeldern oder Texten in das CMS-Element ist hierbei aber nicht möglich.

Klicke auf den Link "Datenzuordnung" (1) und wähle dein Zusatzfeld (2) aus.

z.B. product.customFields.custom_gpsr_sicherheitshinweis

Zusatzfeld ⇒ Datenzuordnung

Hinweis: Ist ein Zusatzfeld nicht in der Liste verfügbar, versuche es einmal auf die nachfolgende, manuelle Methode.

4.2) Zusatzfeld als Variable einfügen

In dieser Variante kannst du auch mehrere Zusatzfelder und Text in das CMS-Element einfügen.

Klicke auf den Button "Variable einfügen" (1) und wähle dein Zusatzfeld (2) aus.

z.B. product.customFields.custom_gpsr_sicherheitshinweis

Zusatzfeld ⇒ Variable

Alternativ kannst du das Zusatzfeld als Variable auch direkt im HTML-Editor einfügen:

<h3>Sicherheitshinweis:</h3>
<div>
    {{ product.customFields.custom_gpsr_sicherheitshinweis }}
</div>

Das CMS-Element sieht im Editor nun wie folgt aus:

CMS-Element mit Zusatzfeld

Hinweis: Ein Hersteller-Zusatzfeld kannst du mit folgendem Syntax ausgeben: {{ product.manufacturer.customFields.DEINZUSATZFELD }}

5) Speicher deine Änderung

Das Zusatzfeld wird nun in der Storefront ausgegeben – sofern es im entsprechenden Produkt befüllt wurde.

6) Cache leeren

Leere abschließend einmal den Shopware- sowie deinen Browser-Cache damit die Änderung auch in der Storefront korrekt angezeigt wird.

Beispiel

Zusatzfeld in einer Erlebniswelt

Tipp: Füge ggf. die CSS-Klasse twt-cms-block-reset im entsprechenden CMS-Block ein um das ThemeWare® CMS-Styling für diese Block zu deaktivieren.

---

Weiterführende Informationen

Mehr Informationen zum Thema "Zusatzfelder" findest du in folgendem Artikel:

Zusatzfelder (Custom Fields)