Variantengruppen

Variantengruppen verknüpfen eigenständige Produkte, die sich in Größe, Material oder einer anderen Dimension unterscheiden. Auf der Produktseite sehen Kunden dann eine Auswahlleiste und können direkt zur gewünschten Variante navigieren.

Unterschied zu Variantenoptionen: Variantenoptionen (im Produktformular) sind Kombinationen eines einzelnen Produkts mit eigenen Preisen und Lagerbeständen. Variantengruppen verbinden separate Produkte mit eigenen URLs miteinander.

Überblick: Der Ablauf

Erkennungsregeln konfigurieren
        ↓
„Varianten erkennen" ausführen
        ↓
Vorschläge prüfen und bestätigen
        ↓
Variantenauswahl erscheint im Shop

Alternativ können Gruppen jederzeit auch manuell ohne Erkennung erstellt werden.

Erkennungsregeln einrichten

Unter Produkte → Variantengruppen → Tab „Erkennungsregeln" legen Sie fest, nach welchem Schema Varianten automatisch erkannt werden. Die Regeln sind auch direkt über Admin → Varianten → Regeln (/admin/variants/rules) erreichbar — die Seite bietet dieselbe CRUD-Oberfläche, praktisch wenn Sie die Regeln unabhängig vom Variantengruppen-Tab anpassen möchten. Änderungen werden sofort für neue Erkennungsläufe wirksam.

Regeltypen

SKU-Präfix (sku_prefix)

Produkte mit dem gleichen SKU-Anfang werden gruppiert.

Feld	Bedeutung
Gruppe nach Präfix	Anzahl der SKU-Zeichen, die übereinstimmen müssen (z. B. `6` für die ersten 6 Zeichen)
Bezeichnung ab Position	Ab welcher Stelle der SKU die Variantenbezeichnung extrahiert wird (z. B. `6` → alles ab Zeichen 7)
Gruppe nach Suffix	Zusätzliche Übereinstimmung am Ende der SKU (für Materialvarianten)
Bezeichnungsfeld	Produktfeld, das als Variantenbezeichnung genutzt wird (z. B. `material`); hat Vorrang vor der SKU-Extraktion

Beispiel: SKU BEDI-K-180x200 und BEDI-K-160x200 teilen den Präfix BEDI-K- — sie werden als Größenvarianten erkannt, die Bezeichnung lautet 180x200 bzw. 160x200.

Attributabgleich (attribute_match)

Produkte mit dem gleichen Wert in bestimmten Feldern werden gruppiert.

Feld	Bedeutung
Gruppenfelder	Felder, die übereinstimmen müssen (z. B. `size`)
Bezeichnungsfelder	Felder, die die Variantenbezeichnung liefern (z. B. `material`)

Beispiel: Alle Produkte mit size = 180x200 werden als Gruppe erkannt; die Bezeichnung kommt aus dem Feld material.

Weitere Regeleinstellungen

Einstellung	Bedeutung
Dimensionstyp	Frei wählbare Bezeichnung der Dimension, z. B. `size`, `material`, `farbe`
Anzeigetyp	Wie der Selektor im Shop dargestellt wird (siehe unten)
Kategoriebeschränkung	Kommagetrennte Kategorieslugs — leer lässt alle Kategorien zu
Priorität	Niedrigere Zahl = höhere Priorität; bei mehreren passenden Regeln gewinnt die mit der kleinsten Zahl
Primäres Schlüsselwort	Optionale Einschränkung: Nur Produkte, deren SKU dieses Schlüsselwort enthält, werden berücksichtigt

Regel anlegen

Klicken Sie auf Regel hinzufügen.
Geben Sie einen Namen ein (z. B. „Größengruppen Betten").
Wählen Sie den Regeltyp und füllen Sie die Konfiguration aus.
Setzen Sie Aktiv auf Ein.
Speichern Sie.

Varianten automatisch erkennen

Wechseln Sie zum Tab Variantengruppen.
Klicken Sie auf Varianten erkennen.
Das System prüft alle aktiven Regeln gegen alle veröffentlichten Produkte und zeigt Vorschläge an.

Jeder Vorschlag zeigt:

Gruppenname und Dimensionstyp
Alle erkannten Mitglieder mit ihren Variantenbezeichnungen
Status: Neu, Vorhanden (Gruppe existiert bereits) oder Konflikt (eine andere Gruppe mit demselben Namen existiert bereits)

Wenn ein Konflikt angezeigt wird, erscheint auf der Karte ein roter Hinweisstreifen. Fahren Sie mit der Maus über den Streifen, um den Lösungshinweis zu lesen: „Zum Beheben: diesen Entwurf verwerfen, oder die bestehende Gruppe mit demselben Namen löschen oder umbenennen." Folgen Sie der Anleitung, bevor Sie die Gruppe bestätigen.

Vorschläge bearbeiten

Vor dem Speichern können Sie:

Bezeichnungen anpassen — Klicken Sie auf eine Bezeichnung und bearbeiten Sie den Text direkt (z. B. 180X200 → 180×200 cm).
Mitglied entfernen — Klicken Sie auf das ✕ neben einem Produkt, um es aus der Gruppe auszuschließen.
Gruppe verwerfen — Klicken Sie auf Gruppe entfernen, um den gesamten Vorschlag zu verwerfen.
Primärvariante festlegen — Wählen Sie per Radiobutton, welches Produkt die Hauptvariante ist (relevant für Canonical-URLs und Feldsynchronisierung).

Speichern

Aktion	Ergebnis
Bestätigen und speichern	Gruppen werden in der Datenbank angelegt und im Shop sofort sichtbar
Als Entwurf speichern	Vorschläge werden gespeichert, aber nicht veröffentlicht — Sie können später weitermachen

Entwürfe erscheinen im Tab Entwürfe und können dort bestätigt oder verworfen werden.

Gruppe manuell erstellen

Wenn Sie Produkte ohne Erkennungsregel verknüpfen möchten:

Klicken Sie auf Gruppe manuell erstellen.
Geben Sie einen Gruppenname, einen Dimensionstyp und einen Anzeigetyp ein.
Suchen Sie Produkte und fügen Sie sie der Gruppe hinzu.
Vergeben Sie für jedes Mitglied eine Variantenbezeichnung.
Klicken Sie auf Gruppe erstellen.

Anzeigetypen im Shop

Der Anzeigetyp legt fest, wie der Variantenselektor auf der Produktseite aussieht.

Anzeigetyp	Darstellung
`text-buttons`	Schaltflächenraster mit Textbezeichnungen (Standard)
`image-buttons`	Schaltflächenraster mit Vorschaubildern; ohne Swatch-Bild wird das erste Produktbild verwendet
`dropdown`	Ausklappmenü — empfohlen bei mehr als 6 Optionen

Der Anzeigetyp wird pro Gruppe (bzw. pro Erkennungsregel) festgelegt.

Canonical-URLs verwalten

Wenn mehrere Varianten inhaltlich identisch sind, sollte eine Variante als kanonische Hauptseite ausgezeichnet werden, damit Suchmaschinen die Ranking-Signale bündeln.

Öffnen Sie eine bestehende Variantengruppe.
Legen Sie eine Primärvariante fest (Radiobutton im Mitgliederbereich).
Aktivieren Sie Canonical-URL-Verknüpfung.
Klicken Sie auf Canonical-URLs setzen.

Das System setzt metaCanonical auf allen Nicht-Primärvarianten auf die URL der Primärvariante. Wenn ein Produkt bereits eine manuell gesetzte Canonical-URL hat, erscheint eine Bestätigung, bevor der Wert überschrieben wird.

Zum Rückgängigmachen deaktivieren Sie Canonical-URL-Verknüpfung — das System entfernt nur die vom System gesetzten Canonical-URLs, manuell eingetragene bleiben erhalten.

Felder von der Primärvariante synchronisieren

Mit Aus Primärvariante synchronisieren können Sie ausgewählte Felder der Primärvariante auf alle anderen Mitglieder kopieren — ohne jedes Produkt einzeln bearbeiten zu müssen.

Öffnen Sie die Variantengruppe und stellen Sie sicher, dass eine Primärvariante gesetzt ist.
Klicken Sie auf Aus Primärvariante synchronisieren.
Wählen Sie die Felder, die kopiert werden sollen.
Bestätigen Sie mit Synchronisieren.

Synchronisierbare Felder: Beschreibungsvorlage, Kurzbeschreibung, Meta-Titel, Meta-Beschreibung, Meta-Keywords, Marke, Lieferzeit, Versandklasse, Kostenloser Versand.

Hinweis: Die Beschreibungsvorlage wird kopiert, die gerenderte Beschreibung bleibt unverändert. Um die Vorlage auf einem Produkt anzuwenden, öffnen Sie das jeweilige Produkt und klicken Sie auf Beschreibung generieren.

Vor jeder Synchronisierung wird automatisch eine Version jedes betroffenen Produkts gespeichert.

Bestehende Gruppen bearbeiten

Im Tab Variantengruppen finden Sie alle aktiven Gruppen. Pro Gruppe können Sie:

Name, Bezeichnung, Anzeigetyp inline bearbeiten
Mitglieder hinzufügen über die Produktsuche
Mitglieder entfernen mit dem ✕-Symbol
Gruppe löschen — entfernt die Verknüpfungen; die Produkte selbst bleiben erhalten

Häufige Fragen

Ein Produkt taucht in keiner Gruppe auf, obwohl die Regel passen müsste. Prüfen Sie, ob das Produkt veröffentlicht ist und ob seine SKU die geforderte Mindestlänge hat. Stellen Sie außerdem sicher, dass die Kategorie des Produkts in der Kategoriebeschränkung der Regel enthalten ist (oder dass die Einschränkung leer ist).

Die Erkennung schlägt eine Gruppe vor, die bereits existiert. Das System erkennt bestehende Gruppen und markiert den Vorschlag als „Vorhanden". Sie müssen ihn nicht erneut bestätigen.

Ein Produkt gehört zu zwei Gruppen der gleichen Dimension. Das System meldet einen Konflikt und fragt, welche Gruppe behalten werden soll. Weisen Sie das Produkt nur einer Gruppe pro Dimension zu.

Ich möchte die Erkennungsregeln testen, ohne etwas zu speichern. Führen Sie die Erkennung aus und schließen Sie das Fenster, ohne zu bestätigen. Es wird nichts in der Datenbank gespeichert.

Nächste Schritte

Varianten — Variantenoptionen innerhalb eines einzelnen Produkts
Produkt erstellen — Grunddaten anlegen
Bilder — Swatch-Bilder für Variantenselektoren hochladen