PS PrestaShop PrestaShop Anfänger

Intelligente Live-Suche — Komplettanleitung

DFLiveSearch installieren, konfigurieren und betreiben: Live-Suche, Vorschläge, Synonyme, Tippfehlertoleranz, Relevanz, Statistiken und E-Mail-Benachrichtigungen für PrestaShop 8 und 9.

Aktualisiert Modulversion 1.4.0

Überblick und Voraussetzungen

DFLiveSearch ersetzt PrestaShops native Suche durch eine Live-AJAX-Engine: Ein Ergebnisbereich öffnet sich ab den ersten Zeichen und zeigt Bild, Name, Preis und Aktions-Badges jedes Produkts. Das Modul ergänzt außerdem eine intelligente Suchmaschine (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.
  • PHP 8.1 und höher.
  • Multishop und mehrsprachig (FR/EN/ES/DE/IT).
  • Keine Datei-Overrides: ausschließlich native Hooks.

Das Modul stützt sich auf die Hooks displayHeader, displayTop, displaySearch, displayBackOfficeHeader und actionOrderStatusPostUpdate. Es erstellt sechs Tabellen: dflivesearch_stats, dflivesearch_log, dflivesearch_alerts, dflivesearch_popular, dflivesearch_synonyms und dflivesearch_lexicon.

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 fünf 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, 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.

Bauen Sie nach einem großen Katalogimport das Korrekturwörterbuch neu auf (siehe Abschnitt „Intelligente Suche“), damit die Tippfehlerkorrektur Ihren aktuellen Katalog widerspiegelt.

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.
  • Populäre Suchen und kürzliche Suchen: Anzeige der Vorschlags-Karussells vor der Eingabe.
  • Autovervollständigung: Begriffsvorschläge (Produkte, Kategorien, 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.

Diese Werte werden als CSS im Frontend eingespielt. Für eine „Pillen“-Leiste im Algolia-Stil wählen Sie einen Eckenradius von 50 und die Größe Large. Für ein Ergebnisfenster in voller Breite auf Mobilgeräten und Desktop geben Sie 100% in der Fensterbreite ein.

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.

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.

Im Selektor werden nur aktive und sichtbare Produkte angeboten. Die Reihenfolge der Miniaturen bestimmt die Reihenfolge im Karussell.

Suchverhalten

Wortbasierte Suche

Die Suche arbeitet wortweise: Jedes eingegebene Wort muss gefunden werden (im Namen, 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.

Wenn Sie eine Menge eingeben, die den verfügbaren Bestand eines nicht ohne Bestand bestellbaren Produkts übersteigt, fügt das Modul das Produkt nicht hinzu und zeigt eine Meldung mit der verbleibenden Menge an.

Intelligente Suche: 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.

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.

Synonyme werden pro Shop und pro Sprache gespeichert. Denken Sie daran, jeden Sprach-Tab auszufüllen, um Ihre gesamte Kundschaft abzudecken.

Tippfehlertoleranz

Wenn eine Suche kein Ergebnis liefert, versucht das Modul automatisch, den Tippfehler anhand eines aus Ihrem Katalog aufgebauten Wörterbuchs (Produktnamen, Referenzen, 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.

Bauen Sie das Wörterbuch nach einem großen Katalogimport oder einer massenhaften Änderung von Produktnamen neu auf, damit die Tippfehlerkorrektur Ihren aktuellen Katalog widerspiegelt. Sie können diesen Neuaufbau auch über eine geplante Aufgabe automatisieren.

Relevanz der Ergebnisse

Die Ergebnisse werden nach einer gewichteten Relevanzbewertung sortiert: exakte Namensübereinstimmung (höchste Bewertung), Name beginnt mit der Anfrage, Anfrage im Namen enthalten, 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 nun 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.

Rein alphabetische Referenzen (ohne Ziffer) bleiben auffindbar, öffnen die Produktseite aber auf der Standardvariante. Referenzen mit Ziffern (EAN, die meisten SKUs) lösen den direkten Link zur exakten Variante aus.

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 fünf Sprachen vor (DE/EN/FR/ES/IT) 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

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.

War diese Seite hilfreich?

Immer noch nicht weiter? Support kontaktieren