Sticky-Warenkorb & KI-Cross-Selling-Modul — Installation und Konfiguration
Installation, Konfiguration und Funktionsweise des Moduls Sticky-Warenkorb & KI-Cross-Selling.
Überblick
Das Modul Sticky-Warenkorb & KI-Cross-Selling (dfstickycart) fügt Ihrem PrestaShop-Shop eine seitliche Warenkorb-Schublade hinzu, die sich bei jedem Hinzufügen per Ajax öffnet, ohne die Seite neu zu laden. Sie zeigt den Warenkorbinhalt, eine Gratis-Versand-Fortschrittsleiste und einen Block mit Cross-Selling-Empfehlungen, die aus Ihren echten Bestellungen berechnet werden, mit einer optionalen KI-Schicht.
Die Empfehlungs-Engine ist vollständig self-hosted: Das Modul funktioniert ohne jeden API-Schlüssel. KI ist nur eine optionale Re-Ranking-Schicht.
Kompatibilität
- PrestaShop 8.0 bis 9.x
- Einzel- und Multistore
- 5 Sprachen: FR, EN, ES, DE, IT
- Keine Abhängigkeiten (weder Composer noch Framework)
Installation
- Öffnen Sie im Back Office Module > Modulmanager.
- Klicken Sie auf Modul hochladen und wählen Sie die Datei
dfstickycart.zip. - Klicken Sie nach der Installation auf Konfigurieren.
Das Modul registriert seine Hooks (actionFrontControllerSetMedia, displayHeader, displayFooter) automatisch und legt seine Cache-Tabelle bei der Installation an. Die Deinstallation entfernt diese Tabelle.
Konfiguration
Allgemein
- Modul aktivieren: blendet die Schublade und den schwebenden Button ein oder aus.
- Position der Schublade: rechts oder links am Bildschirm.
- Automatisches Öffnen: öffnet die Schublade bei jedem Hinzufügen zum Warenkorb.
- Schwebender Button: zeigt einen dauerhaften Warenkorb-Button mit Artikelzähler.
- Hauptfarbe: Akzentfarbe für Schublade, Buttons und Leiste.
Empfehlungen
- Empfehlungen aktivieren: zeigt den Cross-Selling-Block in der Schublade.
- Anzahl der Produkte: Anzahl der angezeigten Vorschläge (Standard 3).
- Strategie: Auto (nur self-hosted Engine) oder KI (Re-Ranking durch künstliche Intelligenz).
- Meldung bei leerem Warenkorb: Text, der angezeigt wird, solange der Warenkorb noch keine Artikel enthält.
Gratis-Versand
Geben Sie die Gratis-Versand-Schwelle in der Standardwährung ein. Die Fortschrittsleiste zeigt automatisch den verbleibenden Betrag an („Nur noch X € bis zum Gratis-Versand“) und rechnet in die aktive Währung des Kunden um. Geben Sie 0 ein, um die Leiste auszublenden.
Künstliche Intelligenz (optional)
- Anbieter: Mistral standardmäßig oder jeder OpenAI-kompatible Dienst.
- Endpoint: URL der Completion-API (standardmäßig der Mistral-Chat-Endpoint).
- Modell: Modellname (zum Beispiel ein leichtgewichtiges Mistral-Modell).
- API-Schlüssel: Ihr Schlüssel. Er wird nie erneut angezeigt und bleibt erhalten, wenn Sie das Feld bei einer Aktualisierung leer lassen.
Fehlt der Schlüssel oder antwortet die API nicht, greift das Modul stillschweigend auf die self-hosted Engine zurück. Die Schublade wird nie durch einen KI-Fehler blockiert.
So funktioniert die Empfehlungs-Engine
Die Vorschläge werden aus einem Produktpool aus drei Quellen gebildet, in dieser Reihenfolge:
- Co-Käufe (Market-Basket): Produkte, die tatsächlich zusammen mit denen im Warenkorb bestellt wurden, aus gültigen Bestellungen (höchstes Gewicht).
- Kategorie-Affinität: Produkte aus denselben Kategorien wie der Warenkorb.
- Bestseller: Fallback, wenn die Historie nicht ausreicht.
Das Ergebnis wird nach Warenkorb-Zusammensetzung für eine konfigurierbare Dauer zwischengespeichert, um die Berechnung zu begrenzen. Ist die KI-Strategie aktiv, sortiert die KI-Schicht diesen Pool neu und erzeugt eine kurze personalisierte Begründung für jedes Produkt.
Leistung
Der Schubladeninhalt wird nur beim Öffnen per Ajax geladen: Es läuft keine zusätzliche Anfrage, solange der Kunde den Warenkorb nicht öffnet. Die zwischengespeicherten Empfehlungen vermeiden eine Neuberechnung der Engine bei jeder Anzeige.
FAQ und Fehlerbehebung
Die Schublade öffnet sich nicht
Prüfen Sie, ob das Modul aktiviert ist, leeren Sie den PrestaShop-Cache (Erweiterte Einstellungen > Leistung) und stellen Sie sicher, dass Ihr Theme jQuery im Frontend lädt.
Es erscheint keine Empfehlung
In einem neuen Shop ohne Bestellhistorie stützt sich die Engine auf Kategorie-Affinität und dann auf Bestseller. Stellen Sie sicher, dass aktive, sichtbare Produkte im Katalog vorhanden sind.
Die KI-Vorschläge ändern sich nicht
Die Ergebnisse werden nach Warenkorb-Zusammensetzung zwischengespeichert. Verringern Sie die Cache-Dauer während der Tests oder ändern Sie den Warenkorb, um einen neuen Cache-Schlüssel zu erzeugen.