Intelligente Suche – Tippfehler, Synonyme, Live-Analyse (MySQL)

Über die Erweiterung

Die Suche, die versteht was Kunden meinen – ohne Elasticsearch, ohne Doofinder-Abo

Kommora Intelligente Suche ersetzt die Standard-Suche von Shopware durch eine typo-tolerante, semantisch aufgeladene Live-Suche mit vollem Analyse-Dashboard im Admin. Alles läuft nativ auf Deiner bestehenden MySQL/MariaDB – kein zusätzlicher Server, keine monatlichen Gebühren, keine externe Abhängigkeit.

Warum dieses Plugin?

• Elasticsearch ist Overkill für die meisten Shops. Für Kataloge bis ~100.000 Produkte reicht ein selbst gepflegter Trigram-Index in MySQL – millisekundenschnell, ohne Extra-Infrastruktur, ohne Extension-Zwang.
• Doofinder ist teuer und schickt Daten in die Cloud. Dieses Plugin arbeitet vollständig lokal – keine externen APIs, DSGVO-konform, keine monatlichen Gebühren.
• Die Standard-Suche findet zu wenig. Kunden tippen falsch, nutzen Umgangssprache („handy" statt „Smartphone"), suchen nach Farben und Größen. Diese Suche versteht das.
• Ohne Analyse blindes Ranking. Was suchen Kunden wirklich? Wo landen sie auf leeren Seiten? Was klicken sie, was kaufen sie? Alles im Dashboard sichtbar.

Funktionen im Überblick

 4-Layer-Fuzzy-Match (Tippfehler-Toleranz)

• Prefix-Match – findet Wörter die mit der Eingabe beginnen
• Trigram-Index – findet Wörter mit gemeinsamen 3-Buchstaben-Blöcken (nativ in MySQL, kein Extension-Zwang)
• Substring-Match mit Wildcards – findet Wörter mit einzelnen falschen/fehlenden Zeichen (Beispiel: „sh_rt" → „shirt")
• Levenshtein-Distanz – findet Wörter mit maximal 1 (kurze Wörter) oder 2 (mittlere Wörter) Editier-Operationen Abstand
• Beispiele die funktionieren: „soud" findet „sound", „shrt" findet „Shirt", „kbel" findet „Kabel"

Query-Understanding (semantische Struktur)

• Marken-Erkennung aus den indexierten Manufacturer-Namen – Brand-Match boostet Ranking ×2.0
• Farb-Erkennung DE/EN (schwarz/black, rot/red, blau/blue, marineblau/navy, gruen/green, …) – Color-Match boostet ×1.5
• Zahlen mit Einheit werden strukturiert extrahiert: 128 GB, 55 Zoll, 500 ml, 4 kg, 12 W
• Konfektions-Größen (XS/S/M/L/XL/XXL/3XL/4XL) werden aus der Query gezogen
• Beispiel: „samsung tv 55 rot" priorisiert automatisch rote Samsung-Fernseher mit 55 Zoll

Konzept-Expander (Poor-Man's Semantic ohne LLM)

• Eingebautes DE/EN-Wörterbuch mit 30+ E-Commerce-Kategorien
• Elektronik: smartphone ↔ handy/mobiltelefon/iphone/samsung; laptop ↔ notebook/macbook; tablet ↔ ipad; kopfhoerer ↔ headset/earbuds; fernseher ↔ tv/led-tv/oled/qled
• Kleidung: shirt ↔ t-shirt/hemd/polo; hose ↔ pants/jeans/chino; schuhe ↔ sneaker/boots/stiefel; jacke ↔ mantel/anorak
• Möbel: sofa ↔ couch; stuhl ↔ sessel/hocker; tisch ↔ schreibtisch/esstisch; lampe ↔ leuchte/stehlampe
• Küche + Bücher + Farben als weitere Cluster
• Leichtes DE-Suffix-Stemming: „Schuhe" ↔ „Schuh", „Kabels" ↔ „Kabel", „Lampen" ↔ „Lampe"

CTR-Re-Ranking (lernt aus Klicks)

• Formel: 1 + ln(1 + Σ 1/(1+tage_seit_klick/7)) mit 30-Tage-Time-Decay
• Ein Klick von heute zählt 1.0, einer von vor 7 Tagen 0.5, vor 14 Tagen 0.33
• Kein Machine Learning nötig – reine Aggregation, deterministisch, transparent
• Wirkung sichtbar nach 1–2 Wochen normaler Shop-Nutzung

Order-Konversions-Tracking

• Subscriber auf CheckoutOrderPlacedEvent
• Für jede Order-Line-Item wird geprüft, ob der Kunde das Produkt in den letzten 60 Minuten aus der Suche geklickt hat
• Analytics-Record wird als converted=1 markiert + order_id gespeichert
• Ergebnis: echte Käufe pro Suchbegriff und Käufe pro geklicktem Produkt im Dashboard sichtbar

Analytics-Dashboard (Admin)

• Menü unter Erweiterungen → Suchanalyse
• 6 KPI-Kacheln: Suchen gesamt, eindeutige Begriffe, Klicks, Click-Through-Rate, Bestellungen aus Suche, Null-Treffer-Rate (rot ab >20%)
• Verlaufs-Chart mit 7/30/90-Tage-Auswahl – Suchen (schwarz) + Klicks (gelb) pro Tag, leere Tage werden mit 0-Balken aufgefüllt
• Beliebteste Suchbegriffe – Top 25, sortierbar nach Suchen/Klicks/Käufen/CTR/⌀ Treffer
• Null-Treffer-Suchen (Handlungsbedarf) – die goldene Liste für neue Synonyme oder fehlendes Sortiment
• Meistgeklickte Produkte aus der Suche – mit Artikelnummer, Name, Klicks, Käufe, verschiedene Suchen
• Filter nach Zeitraum und Verkaufskanal
• Aktualisieren-Button für Live-Refresh

Instant-Suggest-Dropdown

• Reagiert ab dem ersten Zeichen – der Kunde kann weiter tippen, Ergebnisse werden fortlaufend eingegrenzt
• Empty-State: Recent Searches (aus localStorage) + Popular Queries (aus Analytics-Log der letzten 30 Tage)
• Layout-Modi: Comfortable (viel Platz, Bilder), Compact (dichter), Grid (Karten-Ansicht)
• Optional mit Marken- und Kategorie-Facetten in der Seiten-Sidebar
• Streich-/Staffelpreise mit Discount-Badge
• Lieferbar/Vergriffen-Chip pro Produkt
• „Alle XX Ergebnisse anzeigen"-Link zur vollen Suchseite
• MutationObserver für ESI-nachgeladene Header (kein Init-Timing-Bug)

Admin-Konfiguration

• Indexierung: Batch-Größe, Auto-Reindex bei Produkt-Änderung ein/aus
• Ranking & Feldsuche: Custom-Field-Whitelist als Multi-Select (nur ausgewählte Felder werden durchsuchbar), einzelne Gewichte pro Feld (Titel, SKU, Manufacturer, Beschreibung, Tags, Custom-Fields)
• Design: Layout-Modus, Colorpicker für Akzentfarbe, Text-auf-Akzent, Highlight, Border-Radius, Anzeige-Optionen (Bestand-Chip, Streichpreis)
• Suche: Standard-Typo-Toleranz, Facetten ein/aus, Analytics ein/aus
• Instant-UI: Thumbnails, Anzahl pro Kategorie (Default 6), Kategorie-/Marken-Vorschläge, Recent Searches, Popular Queries
• Bei Änderungen an Ranking-Gewichten, Custom-Field-Whitelist oder Typo-Toleranz startet automatisch ein Reindex im Hintergrund

Reindex ohne CLI

• Ein-Klick-Reindex direkt aus dem Admin-Modul – kein CLI-Zugang nötig
• Läuft asynchron per Symfony Messenger im Hintergrund
• Auto-Reindex bei Produkt-Änderungen (Preis, Titel, Beschreibung, Verfügbarkeit)
• Auto-Reindex bei Config-Änderungen die das Ranking betreffen