Intelligente Live-Suche — Komplettanleitung

Überblick und Voraussetzungen

DFLiveSearch ersetzt PrestaShops native Suche durch eine Live-AJAX-Engine: Ein Ergebnisbereich öffnet sich ab den ersten Zeichen und zeigt Bild, Marke, Name, Preis und Aktions-Badges jedes Produkts. Das Modul ergänzt außerdem eine intelligente Suchmaschine (Marke, Synonyme, Tippfehlertoleranz, gewichtete Relevanz), Vorschlags-Karussells (populäre Suchen und empfohlene Produkte), ein vollständiges Analyse-Dashboard und E-Mail-Benachrichtigungen bei Suchen ohne Ergebnis.

• Kompatibel mit PrestaShop 8.0 bis 9.x, Classic-Theme und abgeleiteten Themes, Warehouse-Theme (iqit).
• PHP 8.1 und höher.
• Multishop und mehrsprachig (FR/EN/ES/DE/IT/PT).
• Keine Datei-Overrides: ausschließlich native Hooks.

Installation

Installieren Sie das Modul wie jedes andere PrestaShop-Modul:

1. Laden Sie das Archiv dflivesearch.zip aus Ihrem Kundenkonto herunter.
2. Gehen Sie im Back-Office zu Module > Modul-Manager.
3. Klicken Sie auf Modul hochladen und legen Sie das Archiv ab.
4. Klicken Sie nach der Installation auf Konfigurieren.

Bei der Installation registriert das Modul seine Hooks, erstellt seine Tabellen und füllt einen Platzhaltertext vor, der in die sechs Sprachen übersetzt ist. Außerdem werden einige gängige Synonymgruppen vorausgefüllt und das Tippfehler-Korrekturwörterbuch aus Ihrem Katalog aufgebaut. Das Live-Suchfeld ist sofort in Ihrem Shop aktiv.

Aktualisierung

Die Aktualisierung erfolgt wie gewohnt über den Modul-Manager. Das integrierte Upgrade-Skript erstellt die neuen Tabellen, übernimmt die Standardwerte der neuen Optionen (Synonyme, Relevanz, Tippfehlertoleranz, Markensuche, Erscheinungsbild der Suchleiste), ohne Ihre bestehende Konfiguration zu verändern, und baut anschließend das Korrekturwörterbuch neu auf. Es ist keine manuelle Aktion erforderlich. Leeren Sie nach der Aktualisierung den PrestaShop-Cache und regenerieren Sie die Assets, um das alte JavaScript zu entfernen.

Allgemeine Konfiguration

Die Konfigurationsseite bündelt die Einstellungen zum Suchverhalten:

• Modul aktivieren: schaltet das Live-Suchfeld im Shop ein oder aus.
• Platzhaltertext: im Feld angezeigter Text, pro Sprache übersetzbar.
• Mindestanzahl an Zeichen: Auslöseschwelle der Suche (Standard 2).
• Maximale Anzahl an Produkten: Begrenzung der im Panel angezeigten Ergebnisse.
• Preise anzeigen und Rabatte anzeigen: steuern Preis und Aktions-Badge auf den Ergebniskarten. Die PrestaShop-Regeln gelten stets zusätzlich zu diesen Einstellungen (siehe „Preisanzeige“ weiter unten).
• Populäre Suchen und kürzliche Suchen: Anzeige der Vorschlags-Karussells vor der Eingabe.
• Autovervollständigung: Begriffsvorschläge (Produkte, Kategorien, Marken, populäre Suchen) während der Eingabe, mit Tastaturnavigation (Pfeil hoch/runter, Enter, Escape) und Hervorhebung des eingegebenen Begriffs. Die maximale Anzahl an Vorschlägen ist konfigurierbar.
• Schnell in den Warenkorb und Mengenauswahl: Optionen, um ein Produkt direkt aus den Ergebnissen hinzuzufügen.
• Personalisierte Produkte: berücksichtigt die Historie des angemeldeten Kunden für automatische Empfehlungen.

Erscheinungsbild

Im Abschnitt Erscheinungsbild passen Sie die Suche an Ihr Branding an:

• Hauptfarbe: Farbe der Schaltflächen und Akzente (Standard #2196F3).
• Hauptfarbe (Hover): Hover-Farbe der Schaltflächen (Standard #1976D2).
• Max. Fensterbreite: maximale Breite des Suchpanels. Akzeptiert einen CSS-Wert wie 900px, 1200px oder 100%.
• Größe der Suchleiste (seit Version 1.4.0): Small, Medium oder Large. Passt die Höhe, die Textgröße und die Icongröße der in Ihrem Header angezeigten Leiste an.
• Breite der Suchleiste: maximale Breite der Leiste selbst (400px, 50%, 30rem…). Lassen Sie das Feld leer, um die volle Breite des Theme-Containers auszufüllen.
• Eckenradius der Suchleiste: von 0 (eckige Ecken) bis 50 px (Pillenform).
• Tastenkürzel: öffnet die Suche mit Strg+K (Cmd+K auf dem Mac) oder der Taste / von überall auf der Seite. Auf dem Desktop wird ein Hinweis-Badge („Ctrl K“ oder „⌘K“) in der Leiste angezeigt. Die Option ist deaktivierbar.

Seit Version 1.4.0 ist das Suchfenster vollständig per Tastatur bedienbar: Die Leiste ist fokussierbar und öffnet sich mit Enter oder der Leertaste, der Fokus bleibt beim Tabben innerhalb des Fensters, Escape schließt es und der Fokus kehrt zur Leiste zurück. Eine Löschen-Schaltfläche erscheint im Feld, sobald Text eingegeben wird, und die Animationen respektieren die Systemeinstellung prefers-reduced-motion.

Theme-Kompatibilität und eigene Auslöser

Seit Version 1.5.0 wird das Suchfenster beim Laden der Seite vom Header gelöst: Es funktioniert auch dann, wenn das Theme seinen Container ausblendet (Desktop-Header auf Mobilgeräten versteckt) oder sticky macht. Drei Wege, die Suche zu öffnen, bestehen nebeneinander:

• Die Suchleiste des Moduls, eingefügt über die Hooks displayTop oder displaySearch.
• Jedes Element Ihres Themes mit der Klasse dflivesearch-trigger oder dem Attribut data-dflivesearch-trigger: Das Modul verknüpft daran automatisch das Öffnen der Suche (Klick und Tastatur, mit ARIA-Attributen).
• Die nativen Suchschaltflächen des Warehouse-Themes (iqit): Die Suchlupe des Mobil-Headers (#mobile-btn-search) und die des Desktop-Headers (#iqit-search-btn) öffnen direkt das Modul, anstelle des iqitsearch-Dropdowns. Keine Template-Änderung erforderlich.

Empfohlene Produkte

Empfohlene Produkte erscheinen als Karussell, sobald das Suchfeld geöffnet wird. Über die Einstellung Quelle der empfohlenen Produkte stehen zwei Modi zur Verfügung:

• Automatisch: Das Modul wählt die Bestseller aus (und berücksichtigt die Kundenhistorie, wenn die Option „Personalisierte Produkte“ aktiviert ist).
• Manuell: Sie wählen die hervorgehobenen Produkte gezielt aus.

Im manuellen Modus erscheint ein eigener Selektor: Suchen Sie ein Produkt nach Name oder Referenz, klicken Sie zum Hinzufügen und ordnen Sie die Miniaturen anschließend per Drag-and-drop um. Die festgelegte Reihenfolge wird im Shop eingehalten.

Suchverhalten

Wortbasierte Suche

Die Suche arbeitet wortweise: Jedes eingegebene Wort muss gefunden werden (im Namen, in der Marke, in der Referenz, im EAN-Code oder in der Kurzbeschreibung), in beliebiger Reihenfolge. Eine Anfrage wie „einfaches Stethoskop Trichter“ findet das Produkt also, auch wenn diese Wörter im Namen nicht aufeinanderfolgen. Seit Version 1.2.0 wird jedes Wort zusätzlich auf seine Synonyme erweitert und die Suche deckt Varianten-Referenzen ab (siehe Abschnitt „Intelligente Suche“).

Produkte mit Varianten

Bei einem Produkt mit Varianten wird die In-den-Warenkorb-Schaltfläche durch eine Schaltfläche „Optionen ansehen“ ersetzt, die zur Produktseite führt, damit der Kunde vor dem Hinzufügen seine Variante wählt. Wenn der Kunde die exakte Referenz einer Variante gesucht hat, führt diese Schaltfläche direkt zur passenden Variante.

Verfügbarkeit und Bestand

Nicht vorrätige Produkte bleiben in den Ergebnissen sichtbar und tragen ein „Nicht vorrätig“-Badge. Dieses Badge erscheint nicht bei Produkten, deren Bestellung ohne Bestand erlaubt ist (Einstellung „Bestellungen erlauben“ von PrestaShop): Diese bleiben in den Warenkorb legbar.

Preisanzeige

Seit Version 1.5.0 wendet das Modul die Preisanzeige-Regeln von PrestaShop an, zusätzlich zu seiner eigenen Einstellung „Preise anzeigen“:

• Katalogmodus (Einstellungen > Produkte): In den Ergebnissen werden weder Preis noch Warenkorb-Schaltfläche angezeigt.
• Kundengruppen: Ist bei der Gruppe des Besuchers die Option „Preise anzeigen“ deaktiviert (im B2B üblich für nicht angemeldete Besucher), werden die Preise ausgeblendet.
• Produktoption: Ein Produkt, bei dem „Preis anzeigen“ auf der Produktseite abgewählt ist, zeigt weder Preis noch Rabatt.

In all diesen Fällen wird auch die In-den-Warenkorb-Schaltfläche entfernt und das Hinzufügen serverseitig abgelehnt: Der Kunde wird zur Produktseite weitergeleitet. Die Einstellung „Rabatte anzeigen“ blendet den durchgestrichenen Preis und das Rabatt-Badge aus, ohne den aktuellen Preis zu berühren.

Intelligente Suche: Marke, Synonyme, Tippfehler und Relevanz

Seit Version 1.2.0 enthält DFLiveSearch eine intelligente Suchmaschine. Alle diese Einstellungen befinden sich im Abschnitt Intelligente Suche der Konfigurationsseite.

Suche im Markennamen

Seit Version 1.5.0 fragt die Option „Im Markennamen suchen“ (standardmäßig aktiviert) auch den Hersteller des Produkts ab. Eine Anfrage wie „Littmann Stethoskop“ findet das richtige Produkt, auch wenn die Marke nicht Teil des Produktnamens ist: Jedes Wort wird im Namen, in der Kurzbeschreibung, in den Codes und in der Marke gesucht. Die Marke wird auf den Ergebniskarten über dem Produktnamen angezeigt, und Markennamen werden in der Autovervollständigung vorgeschlagen. Eine exakte Markenübereinstimmung wird besser eingestuft als eine teilweise Namensübereinstimmung.

Synonyme

Das Synonymwörterbuch verknüpft gleichwertige Begriffe: Ein Kunde, der nach „tv“ sucht, findet auch Produkte namens „Fernseher“ oder „Glotze“. Der Editor ist mehrsprachig (ein Tab pro Sprache). Geben Sie eine Gruppe pro Zeile ein, die Begriffe durch Kommas getrennt:

tv, glotze, fernseher, fernsehgerät
computer, pc, laptop
kopfhörer, headset, ohrhörer

Alle Begriffe einer Zeile gelten als gleichwertig: Die Suche nach einem davon erweitert die Anfrage automatisch auf die anderen. Aktivieren oder deaktivieren Sie die Funktion über die Option Synonyme aktivieren. Einige gängige Gruppen sind bei der Installation vorausgefüllt; passen Sie sie an Ihren Katalog an.

Tippfehlertoleranz

Wenn eine Suche kein Ergebnis liefert, versucht das Modul automatisch, den Tippfehler anhand eines aus Ihrem Katalog aufgebauten Wörterbuchs (Produktnamen, Referenzen, Marken, Kategorien) zu korrigieren. Liefert die Korrektur Ergebnisse, werden diese direkt mit dem Hinweis „Ergebnisse für…“ und einem Link zurück zur ursprünglichen Schreibweise angezeigt.

• Tippfehlertoleranz: schaltet die automatische Korrektur ein oder aus.
• Max. Korrekturdistanz: maximale Anzahl abweichender Zeichen, die toleriert wird (1 bis 3; 2 empfohlen). Ein höherer Wert korrigiert mehr Tippfehler, erhöht aber das Risiko von Falschtreffern.
• „Meinten Sie?“ anzeigen: zeigt das Korrekturbanner an. Deaktiviert wird die Korrektur stillschweigend angewendet.

Die Korrektur beruht auf einer phonetischen Vorauswahl (SOUNDEX) gefolgt von einer Levenshtein-Distanzberechnung: Sie findet beispielsweise „Fernseher“ aus „Fernsehr“. Wörter mit weniger als drei Zeichen werden nicht korrigiert; kurze Entsprechungen (wie „tv“) werden über die Synonyme abgedeckt.

Korrekturwörterbuch

Das Korrekturwörterbuch (Tabelle dflivesearch_lexicon) wird bei der Installation aufgebaut und kann jederzeit über die Schaltfläche Wörterbuch neu aufbauen auf der Konfigurationsseite neu erstellt werden. Der Infobereich zeigt die Anzahl der indexierten Wörter und das Datum des letzten Neuaufbaus an. Seit Version 1.5.0 werden zusätzlich zu Produktnamen, Referenzen und Kategorien auch Markennamen indexiert.

Relevanz der Ergebnisse

Die Ergebnisse werden nach einer gewichteten Relevanzbewertung sortiert: exakte Namensübereinstimmung (höchste Bewertung), Name beginnt mit der Anfrage, exakte Marke, Anfrage im Namen enthalten, teilweise Marke, dann Referenz und EAN. Zwei Boosts ergänzen diese Sortierung:

• Lager-Boost: Bei vergleichbarer Relevanz steigen verfügbare Produkte an die Spitze der Liste.
• Bestseller-Boost: bevorzugt die meistverkauften Produkte, basierend auf den Verkaufsstatistiken von PrestaShop.

Beide Optionen lassen sich unabhängig voneinander im Abschnitt Intelligente Suche aktivieren.

Suche nach Varianten-Referenz

Die Suche deckt die varianten­spezifischen Kennungen ab: Referenz, EAN, UPC und Lieferantenreferenz jeder Variante. Die Eingabe der Referenz oder des Barcodes einer Variante bringt also das übergeordnete Produkt nach oben. Wenn die Anfrage wie ein Code aussieht, verweist das Ergebnis direkt auf die richtige Variante (Link zur exakten Variante) und die Karte zeigt Referenz und Preis dieser Variante an.

Dashboard und Statistiken

Das Modul protokolliert jede Suche (eingegebener Begriff, Anzahl der Ergebnisse, möglicher Produktklick, Bestellungskonversion). Das Back-Office-Dashboard zeigt:

• die Gesamtzahl der Suchen und die Anzahl einzigartiger Suchen;
• die Erfolgs-, Klick- und Conversion-Raten;
• ein tagesweises Suchevolutions-Diagramm;
• die Top 20 Suchen mit Klicks und Conversions;
• die Top 20 Suchen ohne Ergebnis;
• einen CSV-Export sämtlicher Daten.

Das Conversion-Tracking erfolgt über den Hook actionOrderStatusPostUpdate: Eine Bestellung, die nach einem Klick in den Suchergebnissen aufgegeben wird, zählt als konvertiert. Seit Version 1.3.0 wird jede Bestellung nur einmal gezählt, unabhängig von späteren Statuswechseln.

E-Mail-Benachrichtigungen

Das Benachrichtigungssystem überwacht Begriffe, die kein Ergebnis liefern. Sobald ein Begriff den konfigurierbaren Schwellenwert überschreitet (Standard 5), wird eine E-Mail-Benachrichtigung an die gewählte Adresse gesendet und eine Notification im Back-Office-Header angezeigt. Jede Benachrichtigung kann als gelesen markiert oder verworfen werden. Die E-Mail-Vorlagen liegen in den sechs Sprachen vor (DE/EN/FR/ES/IT/PT) und der Betreff wird in der Standardsprache des Shops gesendet. Diese Suchen ohne Ergebnis sind eine wertvolle Quelle, um Katalogslücken, häufige Tippfehler oder fehlende, noch hinzuzufügende Synonyme zu erkennen.

Datenaufbewahrung

Suchprotokolle werden standardmäßig 90 Tage aufbewahrt (konfigurierbare Dauer). Im Back-Office steht eine manuelle Bereinigungsschaltfläche zur Verfügung, und seit Version 1.3.0 läuft eine automatische Bereinigung kontinuierlich gemäß der konfigurierten Aufbewahrungsdauer.

FAQ und Fehlerbehebung

Eine Suche „Marke + Produkt“ liefert nichts

Prüfen Sie, ob die Option „Im Markennamen suchen“ (Abschnitt Intelligente Suche) aktiviert ist, verfügbar seit Version 1.5.0, und ob der Hersteller auf der Produktseite zugewiesen ist. Leeren Sie nach der Aktualisierung den Cache und regenerieren Sie die Assets.

Preise erscheinen, obwohl sie ausgeblendet sein sollten

Die Berücksichtigung von Katalogmodus, Kundengruppen ohne Preise und der Produktoption „Preis anzeigen“ ist seit Version 1.5.0 verfügbar. Aktualisieren Sie das Modul, leeren Sie den PrestaShop-Cache und regenerieren Sie die Assets. Prüfen Sie außerdem, ob die Moduleinstellung „Preise anzeigen“ Ihren Erwartungen entspricht.

Die Suche öffnet sich auf Mobilgeräten nicht (Warehouse-Theme)

Aktualisieren Sie auf Version 1.5.0: Das Suchfenster ist jetzt unabhängig vom Header und die Suchlupe des Warehouse-Mobil-Headers öffnet direkt das Modul. Leeren Sie den PrestaShop-Cache, regenerieren Sie die Assets und leeren Sie den Browser-Cache (die CCC-Zusammenfassung des Themes kann das alte JavaScript ausliefern). Hatten Sie ein Theme-Template angepasst, um einen Auslöser zu platzieren, bleibt diese Anpassung kompatibel.

Wie konfiguriere ich Synonyme?

Geben Sie im Abschnitt „Intelligente Suche“ der Konfiguration eine Synonymgruppe pro Zeile (Begriffe durch Kommas getrennt) in jedem Sprach-Tab ein und speichern Sie. Stellen Sie sicher, dass die Option „Synonyme aktivieren“ aktiv ist.

Wie ändere ich die Größe oder Form der Suchleiste?

Wählen Sie im Abschnitt „Erscheinungsbild“ die Größe der Leiste (Small / Medium / Large), die maximale Breite und den Eckenradius. Ein Radius von 50 ergibt eine pillenförmige Leiste. Diese Einstellungen betreffen nur die im Header angezeigte Leiste; das Ergebnisfenster wird über „Max. Fensterbreite“ gesteuert.

Wie deaktiviere ich das Strg+K-Kürzel?

Stellen Sie im Abschnitt „Erscheinungsbild“ die Option „Tastenkürzel“ auf Nein. Das Badge verschwindet aus der Leiste und die Tasten Strg+K, Cmd+K und / öffnen die Suche nicht mehr.

Eine Suche mit Tippfehler liefert eine leere Seite

Prüfen Sie, ob die Option „Tippfehlertoleranz“ aktiviert ist und das Korrekturwörterbuch Wörter enthält (Infobereich in der Konfiguration). Klicken Sie nach einem großen Import auf „Wörterbuch neu aufbauen“. Sie können auch die „Max. Korrekturdistanz“ erhöhen.

Die Suche findet eine Varianten-Referenz nicht

Die Suche nach Varianten-Referenz (Ref, EAN, UPC, Lieferantenref) ist seit Version 1.2.0 verfügbar. Aktualisieren Sie, leeren Sie den Cache und regenerieren Sie die Assets. Für den direkten Link zur exakten Variante muss die Anfrage wie ein Code aussehen (mindestens eine Ziffer enthalten).

Die Suche liefert nichts bei mehreren Wörtern

Die Suche arbeitet mit reihenfolgeunabhängigen Wörtern. Wenn Sie gerade aktualisiert haben, leeren Sie den PrestaShop-Cache und regenerieren Sie die Assets, um das neue JavaScript zu laden.

Das Autovervollständigungs-Panel verdeckt die Ergebnisse

Die Autovervollständigung schließt sich automatisch, wenn das Feld den Fokus verliert oder mit der Escape-Taste. Stellen Sie sicher, dass Sie die neueste Version verwenden, und leeren Sie den Cache, wenn das alte Verhalten bestehen bleibt.

Ein „Nicht vorrätig“-Badge erscheint bei einem bestellbaren Produkt

Das Modul liest die Einstellung „Bestellungen erlauben“ im Reiter Mengen der Produktseite (gespeichert in StockAvailable auf PrestaShop 8). Prüfen Sie diese Einstellung: Erlaubt sie die Bestellung, wird kein Badge angezeigt.

Was passiert bei der Deinstallation?

Die Deinstallation entfernt sauber die Hooks, die Konfigurationsvariablen und die sechs Tabellen des Moduls. Es bleiben keine Restdaten in der Datenbank.