Schritt-Tabs (Reusable)

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.

Unsichtbar: Schritt taucht im Frontend nicht auf. Sinnvoll für Schritte, die rein als logische Verzweigung dienen.
Unsichtbare Schritte brauchen zwingend eine Vorauswahl, da der Kunde sonst nicht weiterkommt.
Vorauswahl: Eine Möglichkeit, die initial markiert ist. Im Strukturbaum erkennen Sie sie am Stern-Icon.
Nicht-Selektierbare zeigen: Wenn aktiv, werden alle Möglichkeiten angezeigt — auch die, die durch Abhängigkeiten gerade nicht wählbar sind. Mit Tooltip „Nicht Selektierbar".
Während ein Schritt aufbaut, sind noch nicht fertige Möglichkeiten kurz gesperrt. Sie werden bedienbar, sobald sie geladen sind — auf langsamen Verbindungen ist das einen Moment sichtbar.
Nicht-Selektierbar Infotext: Tooltip-Text, der bei nicht selektierbaren Möglichkeiten erscheint. Bitte kurz halten.

Durch Kunde abwählbar

Wenn aktiv, sieht der Kunde im Frontend eine Skip-Checkbox.

Standardmäßig abgewählt

Wenn aktiv, ist die Skip-Checkbox initial gesetzt — der Kunde muss aktiv eine Möglichkeit wählen, um den Schritt zu nutzen.

Zusammen mit ausgeschaltetem „Durch Kunde abwählbar" ergibt das einen dauerhaft abgewählten Schritt: es gibt keine Checkbox, mit der er sich einschalten ließe. Das ist zulässig und liefert weder Positionen im Warenkorb noch einen Preis — brauchbar etwa, um einen Schritt vorübergehend stillzulegen, ohne ihn aus der Konfiguration zu nehmen. Bedingungen der Form step['…'].deSelected treffen für ihn zu.

Checkbox-Text

Text neben der Skip-Checkbox („Ich möchte diese Auswahl überspringen").

Abgewählt-Info-Text

Begleittext, der eingeblendet wird, sobald der Kunde den Schritt skipt — z.B. „Sie haben kein Zubehör gewählt".

Möglichkeiten trotz Abwahl zeigen

Normalerweise verschwindet der Inhalt eines abgewählten Schritts vollständig. Mit dieser Einstellung bleibt er sichtbar — Kundinnen und Kunden sehen, worauf sie verzichten.

Die Möglichkeiten sind dabei nicht auswählbar: sie werden gezeigt, reagieren aber nicht auf Klicks, und der Schritt bleibt abgewählt. Am Warenkorb und am Preis ändert sich nichts, ein abgewählter Schritt liefert weiterhin keine Positionen. Wer wieder auswählen will, hebt zuerst die Abwahl auf.

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.

Last modified: 10 September 2026