Doku · 04 Varianten-Generator

Varianten-Generator · 100 Varianten in 10 Sekunden

Varianten visuell erzeugen - Eigenschaften wählen, Optionen anklicken, Muster definieren, generieren. Mit vereinheitlichter Suche, Pattern-Akkordeons und der neuen Variantenmatrix für die Bulk-Pflege.

Eigenschafts- und Optionsauswahl

Der Generator zeigt einen zweispaltigen Selector:

Links: alle Eigenschaften deines Shops (z.B. Farbe, Größe, Material)
Rechts: die Optionen der gerade gewählten Eigenschaft als Chips

Per Klick werden Optionen zur Variantenliste hinzugefügt. Auch mit 40+ Optionen pro Eigenschaft bleibt der Selector übersichtlich - mit Suche und „Alle auswählen"-Button pro Eigenschaft.

Vereinheitlichte Suche

Eine einzige Suche oben durchsucht Eigenschaften und Optionen gleichzeitig. Tippst du „rot", bleiben alle Eigenschafts-Gruppen sichtbar, die irgendwo die Option „rot" haben - und in der rechten Spalte werden die Treffer hervorgehoben.

Das spart einen separaten Wechsel zwischen zwei Suchfeldern und macht die Suche nach speziellen Werten („XL", „matt", „glas") deutlich schneller.

Muster für Artikelnummer und Variantenname

Pro Variante können Artikelnummer und Name automatisch erzeugt werden anhand eines Musters.

Verfügbare Variablen

{number} - Artikelnummer des Stammartikels
{parentName} - Name des Stammartikels
{option1}, {option2}, … - Wert der gewählten Optionen (in Klick-Reihenfolge)
{group1}, {group2}, … - Name der Eigenschafts-Gruppe
{counter}, {counter:03} - fortlaufende Nummer mit oder ohne führende Nullen

Pattern-Akkordeons

Statt zwei nackter Inputs nebeneinander: zwei eigenständige Akkordeons - eines für die Artikelnummer, eines für den Variantennamen.

Eingeklappt zeigen sie das aktuelle Pattern als Code-Chip rechts
Aufgeklappt erscheinen das Eingabefeld plus klickbare Variable-Chips
Klick auf einen Chip fügt die Variable direkt ins aktive Pattern ein
Fokus springt automatisch in das richtige Feld

Beispiele

Nummer: {number}-{option1}-{option2} → SW-1001-rot-S
Name: {parentName} ({option1}, {option2}) → T-Shirt Basic (rot, S)

Live-Vorschau

Während der Konfiguration zeigt eine Tabelle die ersten 8 Kombinationen mit konkretem SKU und Name. Bei mehr als 8 Varianten erscheint ein „+ X weitere"-Hinweis. Vor dem Erzeugen wird die exakte Gesamtanzahl angezeigt.

Standard-Muster in der Konfigmatrix

SKU- und Name-Muster lassen sich global in der Konfigmatrix als Default setzen. Pro Produkt ist ein Override möglich - abweichende Muster werden im Produktdetail unter „Varianten-Generator" gespeichert.

Storefront-Ausspielung & mehrsprachige Namen

Nach dem Generieren setzt das Plugin die Storefront-Ausspielung automatisch wie im Shopware-Standard („Einzelprodukt anzeigen → Variante"). Eine vorhandene Vorauswahl bleibt maßgeblich; sonst wird die Variante mit der kleinsten Artikelnummer zur Vorauswahl (inkl. Listing-Konfiguration, Position oben, Audit-Log-Eintrag).

Stammartikel als Vorauswahl: In der Toolbar der Variantenliste gibt es einen Button mit Stern-Symbol „Stammartikel als Vorauswahl". Er setzt den Stammartikel selbst als Storefront-Listing (variantListingConfig.displayParent = true) statt einer einzelnen Variante - z.B. wenn im Listing der Hauptartikel mit Varianten-Auswahl erscheinen soll. Erneuter Klick entfernt es wieder. Das Setzen einer Varianten-Vorauswahl wechselt automatisch zurück, und die Varianten-Generierung überschreibt ein bewusst gesetztes Stammartikel-Listing nicht mehr.

Varianten-Namen werden pro Sprache aufgelöst: Eltern-Name, Options- und Gruppennamen werden mit ihren Übersetzungen geladen und das Namens-Pattern je Sprache angewendet (Fallback auf den aktuellen Namen, wenn eine Übersetzung fehlt). So landen z.B. keine deutschen Optionsnamen mehr im englischen Variantennamen.

Variantenmatrix · Bulk-Preise und Bestand

Bei einem Variant-Produkt mit vielen Optionen ist die Preis- und Bestandspflege zeilenweise mühsam. Die Variantenmatrix legt alle Varianten in einer Tabelle übereinander:

Eine Achse zeigt die erste Eigenschaft (z.B. Farbe)
Die andere die zweite Eigenschaft (z.B. Größe)
Pro Zelle stehen Preis und Bestand zum direkten Editieren
Sortierung der Eigenschaften per Drag-and-Drop
Optional: Werte aus dem Stammartikel auf alle leeren Zellen anwenden

Funktioniert sowohl im Varianten-Tab eines einzelnen Produkts als auch über das Quickview-Icon bei Variant-Produkten im Listing.

Sicheres Löschen mit Order-Check

Beim Löschen von Varianten prüft das Plugin auf offene Bestellungen.

Modus „Sicher" (empfohlen): Varianten mit offenen Bestellungen werden nicht gelöscht, sondern nur deaktiviert. Daten bleiben erhalten für Buchhaltung und Reklamationen.
Modus „Vollständig": Varianten werden gelöscht - auch wenn Bestellungen vorliegen.

Empfehlung: Immer im Modus „Sicher" arbeiten. „Vollständig" nur bei kompletter Sortimentsbereinigung.

Eigenschaften und Bilder auf Varianten übertragen

Die Vererbung in Shopware wirkt pro Feld nach dem Prinzip alles-oder-nichts: Sobald eine Variante einen eigenen Wert hat, erbt sie in diesem Feld nichts mehr vom Stammartikel. Das erklärt die beiden häufigsten Überraschungen - im Frontend erscheinen weniger Eigenschaften als gepflegt, oder im Listing fehlt das Bild. Drei Schaltflächen lösen das auf.

„Eigenschaften auf Varianten übertragen" (Reiter Eigenschaften): Ergänzt bei Varianten mit eigenen Eigenschaften die fehlenden des Stammartikels. Varianten ohne eigene Eigenschaften erben ohnehin alles und bleiben unangetastet.
„Bilder auf Varianten übertragen" (Stammdaten → Bilder & Medien): Legt für jede Variante ohne eigene Bilder eigene Bildzuordnungen auf dieselben Mediendateien an, inklusive Reihenfolge, und setzt das Titelbild. Varianten mit eigenen Bildern bleiben unverändert und werden in der Meldung ausgewiesen.
Sichtbare Abweichungen: Eigenschaften, die nur an Varianten hängen, werden orange hervorgehoben, betroffene Gruppen bekommen einen orangen Punkt, und die Zählleiste nennt die Anzahl. Gruppen mit abgeschaltetem „Auf Produktdetailseite anzeigen" werden als „Nicht in Storefront" markiert.

Berechtigung: Die drei Schaltflächen lassen sich über die Konfigmatrix-Berechtigung „Auf Varianten übertragen" steuern. Standardmäßig eingeschaltet; ausgeschaltet sehen nur Superadmins sie.

Duplizieren mit wählbarer Vererbung

Beim Duplizieren eines Varianten-Artikels fragt ein Dialog, welche Felder die Varianten vom Hauptartikel erben sollen: Bilder, Name, Preis, Gewicht und EAN. Geerbte Felder übernehmen spätere Änderungen am Hauptartikel automatisch, nicht geerbte werden als eigener Wert kopiert. Bestand und Artikelnummer bleiben systembedingt variantenspezifisch, bei einfachen Artikeln ohne Varianten erscheint die Abfrage nicht. Der neue Stammartikel bekommt dabei eine eigene, korrekte SEO-URL nach Kanal-Vorlage - statt über die Hauptvariante auf das Original zu zeigen.

Vollständigkeit bei Varianten

Varianten erben Name, Beschreibung, Preis, Titelbild, Hersteller, Kategorien und Eigenschaften vom Stammartikel. Die Vollständigkeitsberechnung löst diese Vererbung auf: Hat die Variante keinen eigenen Wert, zählt der des Stammartikels - im Listing wie im Dashboard. Artikelnummer und Bestand bleiben bewusst variantenspezifisch. Auch der Aktiv-Status wird korrekt aufgelöst: ein eigener Wert der Variante gewinnt, sonst gilt der Status des Stammartikels.

Weiter geht's

Weiter zur Kategorien-Verwaltung, um den Kategoriebaum samt Texten und SEO zu pflegen.