Variantensuche Hauptartikel | Varianten in der Suche zusammenfassen

Auf einen Blick

• Ein Treffer je Artikel statt zehn fast gleicher Varianten in der Suche
• Trefferzahl, Filter und Seitennavigation zählen Artikel statt Varianten
• Der Kunde sieht sofort, wie viele Varianten hinter einem Treffer stecken
• Je Verkaufskanal schaltbar, ohne das Plugin zu deinstallieren
• Läuft mit der Standardsuche und mit OpenSearch oder Elasticsearch

Ein Kunde tippt „Shirt“ in dein Suchfeld. Die Trefferliste zeigt dasselbe Shirt zehnmal, einmal je Farbe. Die drei anderen Shirts aus deinem Sortiment stehen irgendwo dahinter. Verkauft wird, was gefunden wird.

Das Problem

Shopware behandelt jede Variante als eigenes Produkt. Im Kategorie-Listing kannst du über die Produkteinstellungen steuern, was der Kunde sieht. In der Suche nicht: dort landet jede aktive Variante als eigener Treffer. Zehn Farben in vier Größen sind 40 Einträge für einen einzigen Artikel.

Die Zahl über der Liste zählt dann Varianten statt Artikel, die Seitennavigation wird künstlich lang, und dein Kunde klickt sich durch Wiederholungen statt durch dein Sortiment. Wer nach drei Bildschirmseiten aufgibt, hat dein zweitbestes Produkt nie gesehen.

Die Lösung

Das Plugin fasst die Varianten eines Artikels zu einem Treffer zusammen, auf der Suchergebnisseite und in den Suchvorschlägen, die beim Tippen im Suchfeld aufklappen. Trefferzahl, Filter, Sortierung und Seitennavigation rechnen danach mit Hauptartikeln.

Gefunden wird trotzdem über jede Variante. Tippt jemand die Produktnummer, die EAN oder den Farbnamen einer einzelnen Variante ein, landet er beim zugehörigen Hauptartikel statt im Nichts.

Was du davon hast

Deine Trefferliste zeigt wieder Sortiment statt Wiederholung. Aus 40 Varianteneinträgen wird ein Treffer. Auf Seite eins stehen damit die Artikel, die der Kunde vergleichen will.

Die Zahlen stimmen. „128 Ergebnisse“ meint danach 128 Artikel und nicht 128 Varianten von 12 Artikeln. Das gilt auch für Filter, Sortierung und die Anzahl der Seiten.

Der Kunde sieht die Auswahl trotzdem. Auf Wunsch steht unter dem Produktnamen „Weitere Varianten verfügbar“ oder „In 3 Varianten erhältlich“. Gezählt werden nur aktive Varianten, die in diesem Verkaufskanal sichtbar sind.

Du entscheidest je Verkaufskanal. Im B2C-Shop zusammenfassen, im B2B-Shop jede Variante einzeln zeigen: beides gleichzeitig, mit einem Schalter pro Kanal und ohne zweite Installation.

Deine Produktdaten bleiben unangetastet. Das Plugin ändert keine Hauptvariante, keine Sichtbarkeit und keinen Preis. Es verändert nur, was die Suche ausliefert.

So arbeitet das Plugin

Nach der Installation legt das Plugin eine eigene Tabelle an und baut daraus einen Suchindex, der jeder Variante ihren Hauptartikel zuordnet. Diesen Index pflegt es danach selbst weiter, wenn du Produkte anlegst, änderst oder importierst. Den Stand siehst du in der Plugin-Konfiguration; dort baust du ihn bei Bedarf per Klick neu auf.

In der Suche greift das Plugin an drei Stellen: Es gruppiert die Treffer, wählt den anzuzeigenden Artikel aus und hängt den Varianten-Hinweis an die Produktkarte. Welcher Artikel angezeigt wird, entscheidest du: „Wie im Kategorie-Listing“ übernimmt die Hauptvariante beziehungsweise den Hauptartikel laut Produkteinstellung, „Immer der Hauptartikel“ zeigt den Hauptartikel mit dem günstigsten Variantenpreis. Klickt der Kunde darauf, öffnet die Produktseite die passende beziehungsweise die günstigste verfügbare Variante.

Typische Einsatzszenarien

Mode und Textil. Ein Pullover in sechs Farben und fünf Größen ist ein Artikel, kein 30-Treffer-Block. Der Kunde sucht „Pullover Merino“ und sieht sechs verschiedene Pullover statt eines einzigen in allen Ausführungen.

Technik und Zubehör. Kabel in vier Längen, Speicherkarten in drei Größen: Der Kunde vergleicht Produkte, nicht Ausführungen, und wählt die Variante erst auf der Produktseite.

Zwei Kanäle, zwei Erwartungen. Im Endkundenshop willst du eine aufgeräumte Trefferliste. Im Händlershop, in dem nach Artikelnummern gesucht wird, willst du womöglich jede Variante einzeln sehen. Beides lässt sich getrennt einstellen.

Technische Fakten für deine IT

Shopware ab 6.7.13, PHP ab 8.2. Das Plugin legt genau eine eigene Tabelle an (swp_search_main_product_group) und erweitert das Produkt um ein Feld, das nur zur Laufzeit gefüllt wird. Shopware-Kerntabellen bleiben unverändert, es gibt keine Custom Fields und keinen Eingriff in die Produktpflege.

Das Plugin sendet keine Daten an externe Server und verarbeitet keine personenbezogenen Daten. Fehler schreibt es in einen eigenen Log-Kanal. An der einen Stelle, an der eine Fehlermeldung Teile des Suchbegriffs enthalten könnte, protokolliert es bewusst nur Fehlerklasse und Fehlercode.

Die Gruppierung läuft über einen eigenen DAL-Indexer, nicht über zusätzliche Abfragen im Seitenaufbau. Die Suche arbeitet mit MySQL und ebenso mit OpenSearch beziehungsweise Elasticsearch; das Plugin bringt dafür eine eigene Index-Erweiterung mit und prüft selbst, ob der Produktindex sie schon enthält. Änderungen an der Konfiguration invalidieren die betroffenen Seiten-Caches. Beim Deinstallieren entscheidest du wie gewohnt über „Benutzerdaten entfernen“, ob die Tabelle mitgelöscht wird. Der Statusbereich in der Administration ist an die Berechtigung zum Verwalten von Erweiterungen gebunden.

Ehrlich gesagt

Das Plugin wirkt in der Suche, also auf der Suchergebnisseite und in den Suchvorschlägen. Im Kategorie-Listing ändert es nichts; dort entscheidet weiterhin die Produkteinstellung von Shopware. Und es braucht einen Moment Vorlauf: Direkt nach der Installation und nach großen Importen muss der Index aufgebaut sein, bevor die Gruppierung greift. Solange er das nicht ist, sieht die Suche aus wie ohne Plugin, und die Plugin-Konfiguration sagt dir das auch. Probier es im Testshop mit deinem eigenen Sortiment aus, dann siehst du in fünf Minuten, ob es für dich passt.

Häufige Fragen

Ändert das Plugin meine Produktdaten?

Nein. Es schreibt nichts an deinen Produkten, weder Hauptvariante noch Sichtbarkeit noch Preis. Es legt eine eigene Tabelle an und verändert nur, was die Suche ausliefert.

Finden meine Kunden eine einzelne Variante noch?

Ja. Produktnummer, EAN und Optionsnamen einer Variante bleiben durchsuchbar, der Treffer führt dann auf den Hauptartikel. Die konkrete Variante wählt der Kunde auf der Produktseite.

Wirkt die Gruppierung auch im Kategorie-Listing?

Nein. Das Plugin arbeitet in der Suche und in den Suchvorschlägen. Was im Kategorie-Listing steht, entscheidet weiterhin die Produkteinstellung von Shopware.

Funktioniert das mit meinem Theme?

In der Regel ja. Das Plugin erweitert die Standardvorlagen für die Produktkarte und die Suchvorschläge über Twig-Blöcke. Ersetzt dein Theme diese Vorlagen komplett, kann der Varianten-Hinweis fehlen; die Gruppierung selbst bleibt davon unberührt, weil sie vor dem Rendern passiert.

Wir suchen mit OpenSearch. Geht das auch?

Ja. Das Plugin bringt eine eigene Erweiterung für den Produktindex mit und zeigt dir in der Konfiguration, ob der Index sie schon enthält. Nach der Installation gehört dazu ein Reindex, vorher greift die Gruppierung in der OpenSearch-Suche nicht.

Warum sehe ich direkt nach der Installation noch alle Varianten?

Weil der Gruppierungsindex noch aufgebaut wird. Bis er fertig ist, verhält sich die Suche wie ohne Plugin. Den Stand und einen Knopf zum Neuaufbau findest du in der Plugin-Konfiguration.

Bremst das Plugin meine Suche aus?

Die Zuordnung Variante zu Hauptartikel steht vorberechnet in einer eigenen Tabelle, es wird also nicht bei jedem Seitenaufruf neu gerechnet. Für den Varianten-Hinweis kommt je Ergebnisseite eine Zählabfrage dazu.

Sendet das Plugin Daten an externe Server?

Nein. Alles bleibt in deiner Shopware-Installation, personenbezogene Daten verarbeitet das Plugin nicht. Fehler schreibt es in einen eigenen Log-Kanal; wo eine Fehlermeldung Teile des Suchbegriffs enthalten könnte, stehen dort nur Fehlerklasse und Fehlercode.

Kann ich das Plugin nur in einem von zwei Verkaufskanälen nutzen?

Ja. Jede Einstellung hängt am Verkaufskanal, auch der Schalter „Plugin für diesen Verkaufskanal aktivieren“. Der eine Shop fasst zusammen, der andere zeigt weiter jede Variante.

Was passiert bei der Deinstallation mit meinen Daten?

Das entscheidest du im Deinstallations-Dialog von Shopware. Lässt du die Benutzerdaten stehen, bleibt die Tabelle des Plugins erhalten; entfernst du sie, wird sie gelöscht. An deinen Produkten bleibt in beiden Fällen alles unverändert.