PS PrestaShop PrestaShop Anfänger

Intelligente Live-Suche — Komplettanleitung

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

Aktualisiert Modulversion 1.1.9

Überblick und Voraussetzungen

DFLiveSearch ersetzt die native Suche von PrestaShop durch eine Live-AJAX-Engine: Ein Ergebnis-Panel öffnet sich ab den ersten Zeichen und zeigt Bild, Name, Preis und Aktions-Badges jedes Produkts. Das Modul fügt außerdem Vorschlags-Karussells (populäre Suchen und empfohlene Produkte), ein vollständiges Analyse-Dashboard und E-Mail-Benachrichtigungen bei Suchen ohne Ergebnis hinzu.

  • 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 nutzt die Hooks displayHeader, displayTop, displaySearch, displayBackOfficeHeader und actionOrderStatusPostUpdate. Es erstellt vier Tabellen: dflivesearch_stats, dflivesearch_log, dflivesearch_alerts und dflivesearch_popular.

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 in alle fünf Sprachen übersetzten Platzhalter vor. Das Live-Suchfeld ist sofort in Ihrem Shop aktiv.

Aktualisierung

Die Aktualisierung erfolgt normal über den Modul-Manager. Das integrierte Upgrade-Skript wendet automatisch die Standardwerte der neuen Optionen an (Farben, Fensterbreite, Modus der empfohlenen Produkte), ohne Ihre bestehende Konfiguration zu verändern. Es ist keine manuelle Aktion erforderlich. Leeren Sie nach der Aktualisierung den PrestaShop-Cache und generieren Sie die Assets neu, um das alte JavaScript zu entfernen.

Allgemeine Konfiguration

Die Konfigurationsseite fasst die Einstellungen zum Suchverhalten zusammen:

  • Modul aktivieren: aktiviert oder deaktiviert das Live-Suchfeld im Shop.
  • Platzhaltertext: im Feld angezeigter Text, pro Sprache übersetzbar.
  • Mindestanzahl an Zeichen: Auslöseschwelle der Suche (Standard 2).
  • Maximale Produktanzahl: 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 konfigurierbarem Maximum.
  • 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 die automatischen Empfehlungen.

Erscheinungsbild

Im Abschnitt Erscheinungsbild können Sie das Suchfenster an Ihr Corporate Design anpassen:

  • Hauptfarbe: Farbe der Schaltflächen und Akzente (Standard #2196F3).
  • Hauptfarbe (Hover): Farbe beim Überfahren der Schaltflächen (Standard #1976D2).
  • Max. Fensterbreite: maximale Breite des Such-Panels. Akzeptiert einen CSS-Wert wie 900px, 1200px oder 100%.

Diese Werte werden als CSS im Frontend eingefügt. Für ein Fenster in voller Breite auf Mobil und Desktop geben Sie 100% im Breitenfeld ein.

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 genau, welche Produkte hervorgehoben werden.

Im manuellen Modus erscheint eine eigene Auswahl: Suchen Sie ein Produkt per Name oder Referenz, klicken Sie zum Hinzufügen und ordnen Sie die Miniaturansichten per Drag-and-drop neu an. Die festgelegte Reihenfolge wird im Shop eingehalten.

In der Auswahl werden nur aktive und sichtbare Produkte angeboten. Die Reihenfolge der Miniaturansichten bestimmt die Reihenfolge im Karussell.

Suchverhalten

Wortbasierte Suche

Die Suche arbeitet wortbasiert: Jedes eingegebene Wort muss gefunden werden (im Namen, in der Referenz, im EAN-Code oder in der Kurzbeschreibung), in beliebiger Reihenfolge. Eine Anfrage wie „Stethoskop einseitig Bruststück“ findet das Produkt also, auch wenn diese Wörter im Namen nicht aufeinanderfolgen. Die Ergebnisse werden nach Relevanz sortiert (exakter Name, dann mit der Anfrage beginnender Name, dann Teiltreffer).

Produkte mit Varianten

Bei einem Produkt mit Varianten wird die Schaltfläche „In den Warenkorb“ durch eine Schaltfläche „Optionen ansehen“ ersetzt, die zur Produktseite führt, damit der Kunde vor dem Hinzufügen seine Variante wählt.

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 Restmenge 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 eindeutiger Suchen;
  • die Erfolgs-, Klick- und Conversion-Raten;
  • ein tagesweises Verlaufsdiagramm der Suchen;
  • die Top 20 der Suchen mit Klicks und Conversions;
  • die Top 20 der Suchen ohne Ergebnis;
  • einen CSV-Export aller Daten.

Das Conversion-Tracking erfolgt über den Hook actionOrderStatusPostUpdate: Eine nach einem Klick in den Suchergebnissen aufgegebene Bestellung wird als konvertiert gezählt.

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 gelöscht werden. Diese Suchen ohne Ergebnis sind eine wertvolle Quelle, um Katalogslücken oder häufige Tippfehler zu erkennen.

Datenaufbewahrung

Such-Logs werden standardmäßig 90 Tage aufbewahrt (konfigurierbare Dauer). Im Back-Office steht eine Schaltfläche zur manuellen Bereinigung bereit, um alte Einträge sofort zu löschen.

FAQ und Fehlerbehebung

Die Suche liefert bei mehreren Wörtern nichts

Seit Version 1.1.9 arbeitet die Suche mit einzelnen Wörtern unabhängig von der Reihenfolge. Wenn Sie gerade aktualisiert haben, leeren Sie den PrestaShop-Cache und generieren Sie die Assets neu, um das neue JavaScript zu laden.

Das Autovervollständigungs-Panel verdeckt die Ergebnisse

Die Autovervollständigung schließt automatisch, wenn das Feld den Fokus verliert. Stellen Sie sicher, dass Sie die neueste Version verwenden, und leeren Sie den Cache, falls das alte Verhalten bestehen bleibt.

In den Warenkorb funktioniert bei leerem Warenkorb nicht

Dieser Fall ist behoben: Das Modul speichert den neu erstellten Warenkorb jetzt dauerhaft. Aktualisieren Sie auf die neueste Version und leeren Sie dann den Cache.

Bei einem bestellbaren Produkt erscheint ein „Nicht vorrätig“-Badge

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

Was passiert bei der Deinstallation?

Die Deinstallation entfernt sauber die Hooks, die Konfigurationsvariablen und die Modultabellen. Es bleiben keine Restdaten in der Datenbank.

War diese Seite hilfreich?

Immer noch nicht weiter? Support kontaktieren