Schritt-Typ: Felder

Ein Felder-Schritt sammelt Eingaben vom Kunden — z.B. Maße, Stückzahlen oder Beschriftungen. Die eingegebenen Werte können in Preisformeln weiterverwendet werden.

Übersicht

Eigenschaft	Wert
Hat Möglichkeiten	Nein
Hat Felder	Ja, beliebig viele
Duplizierung ermöglichen	Optional — Kunde kann die Feldsammlung im Frontend mehrfach ausfüllen
Preise	Pro Feld definiert (siehe Feld-Editor)

Tab „Informationen"

Informationen-Tab eines Felder-Schrittes

Hier definieren Sie die Basis des Schritts:

Name: Wird im Frontend als Schritt-Überschrift angezeigt. Übersetzbar.
Beschreibungstext: Optionaler Beschreibungstext über der Auswahl. WYSIWYG-Editor von Shopware mit HTML-Sanitizer. Stilanweisungen aus dem Konfigurator- Theme überschreiben die Inline-Styles, sofern Sie nicht das CSS-Klassenattribut no-reboot verwenden.
Position: Sortierreihenfolge im Frontend. Akzeptiert Nachkomma-Werte, um Schritte zwischen anderen einzufügen — siehe Schritte.
Typ: Festgelegt beim Anlegen, nachträglich nicht änderbar.

Duplizierung ermöglichen

Schaltet die Mehrfach-Eingabe der Feldsammlung frei. Wenn aktiv, kann der Kunde im Frontend dieselbe Feldsammlung beliebig oft ausfüllen — pro Ausfüllung entsteht ein eigener Eintrag im Cart, mit eigenem Wertesatz für jedes Feld der Sammlung.

Praktisches Beispiel: ein Felder-Schritt „Beschriftung" mit den Feldern Text und Position. Mit aktivierter Duplizierung kann der Kunde eine, zwei oder zehn Beschriftungen eingeben — jede mit eigenem Text und eigener Position.

Tab „Abhängigkeiten"

Abhängigkeiten-Tab eines Felder-Schrittes

Mit Abhängigkeiten verknüpfen Sie diesen Schritt mit Auswahlen aus früheren Schritten. Ist die Abhängigkeit nicht erfüllt, wird der gesamte Schritt im Frontend übersprungen.

Abhängigkeiten verknüpfen ein Element (einen Schritt oder ein Feld) mit einer oder mehreren Auswahlen aus anderen Schritten. Sie entscheiden, ob das Element im Frontend überhaupt zur Auswahl steht.

Bedingung als Ausdruck

Neben der Auswahl-Liste kann jedes Element eine Bedingung tragen. Beide werden UND-verknüpft — eine leere Bedingung ändert nichts.

step['<step-id>'].selected['<item-id>']          // diese Möglichkeit ist gewählt
step['<step-id>'].count > 0                      // im Schritt ist irgendetwas gewählt
step['<step-id>'].deSelected                     // der Schritt wurde übersprungen
step['<step-id>'].valid                          // Felder des Schritts sind gültig
product.productNumber == 'SW-10001'              // gewähltes Basis-Produkt
any(step['<id>'].entries[*].fields['<id>'].values[0] > 100)

Adressierung über IDs

Schritte, Möglichkeiten und Felder werden über ihre ID angesprochen. Namen sind übersetzbar und taugen nicht zur Adressierung; sie lassen sich aber vergleichen (.name == '…') — dann gegen die aktuell gerenderte Sprache. Mehrsprachig heißt: selbst verodern.

Wiederholbare Einträge

Ein Felder-Schritt kann mehrere Einträge haben. entries[*] liefert eine Liste; any(…) bzw. all(…) falten sie zu einer Ja/Nein-Antwort. Eine Liste ohne any/all wird abgelehnt — sie wäre immer wahr.

Der eigene Eintrag

Hängt ein Feld an einem anderen Feld desselben Schritts, ist this.entry gemeint: der Eintrag, in dem das Feld selbst steht. Im Baukasten ist das der Baustein Feldwert (aktueller Eintrag) — er nennt keinen Schritt, weil es immer der eigene ist.

this.entry.fields['<field-id>'].values[0] == '<option-id>'

Der Baustein Feldwert adressiert dagegen einen fremden Schritt über entries[0] — bei mehreren Einträgen träfe er dort immer den ersten.

Fehlende Verweise

Zeigt ein Vergleich auf etwas, das es nicht gibt — ein gelöschtes Feld, eine falsche ID —, gilt er als nicht erfüllt. Ein Tippfehler blendet nichts heimlich ein.

Klammern

&& bindet stärker als ||. Bei gemischten Ausdrücken selbst klammern.

Felder anlegen

Im Sidebar-Tree fügen Sie unter dem Schritt über das Drei-Punkte-Menü einen neuen Feld-Knoten hinzu. Den Feldtyp und alle Detail-Einstellungen pflegen Sie unter Felder.

Last modified: 10 September 2026