Przyklejony Koszyk i Cross-sell AI: instalacja i konfiguracja
Instalacja, konfiguracja i działanie modułu Przyklejony Koszyk i Cross-sell AI.
Prezentacja
Moduł Przyklejony Koszyk i Cross-sell AI (dfstickycart) dodaje do Twojego sklepu PrestaShop boczną szufladę koszyka, która otwiera się w Ajax przy każdym dodaniu, bez przeładowania strony. Wyświetla zawartość koszyka, pasek postępu darmowej dostawy oraz blok rekomendacji krzyżowych obliczonych z Twoich rzeczywistych zamówień, z opcjonalną warstwą AI.
Silnik rekomendacji jest w pełni self-hosted: moduł działa bez żadnego klucza API. AI to wyłącznie opcjonalna warstwa zmiany kolejności sugestii.
Kompatybilność
- PrestaShop 8.0 do 9.x
- Pojedynczy sklep i multistore
- 5 języków: FR, EN, ES, DE, IT
- Brak zależności (ani Composer, ani framework)
Instalacja
- W panelu administracyjnym otwórz Moduły > Menedżer modułów.
- Kliknij Zainstaluj moduł i wybierz plik
dfstickycart.zip. - Po instalacji kliknij Konfiguruj.
Moduł rejestruje swoje hooki automatycznie (actionFrontControllerSetMedia, displayHeader, displayFooter) i tworzy własną tabelę cache przy instalacji. Odinstalowanie usuwa tę tabelę.
Konfiguracja
Ogólne
- Włącz moduł: pokazuje lub ukrywa szufladę i pływający przycisk.
- Pozycja szuflady: po prawej lub po lewej stronie ekranu.
- Automatyczne otwieranie: otwiera szufladę przy każdym dodaniu do koszyka.
- Pływający przycisk: wyświetla stały przycisk koszyka z licznikiem artykułów.
- Kolor główny: kolor akcentu szuflady, przycisków i paska.
Rekomendacje
- Włącz rekomendacje: wyświetla blok cross-sell w szufladzie.
- Liczba produktów: liczba wyświetlanych sugestii (domyślnie 3).
- Strategia: Auto (sam silnik self-hosted) lub AI (zmiana kolejności przez sztuczną inteligencję).
- Komunikat pustego koszyka: tekst wyświetlany, gdy koszyk nie zawiera jeszcze żadnego artykułu.
Darmowa dostawa
Wpisz próg darmowej dostawy w walucie domyślnej. Pasek postępu automatycznie pokazuje brakującą kwotę („Jeszcze X zł do darmowej dostawy”) i przelicza ją na aktywną walutę klienta. Wartość 0 ukrywa pasek.
Sztuczna inteligencja (opcjonalnie)
- Dostawca: domyślnie Mistral lub dowolna usługa kompatybilna z OpenAI.
- Endpoint: adres URL API uzupełnień (domyślnie endpoint czatu Mistral).
- Model: nazwa modelu (na przykład lekki model Mistral).
- Klucz API: Twój klucz. Nigdy nie jest ponownie wyświetlany i pozostaje zachowany, jeśli przy aktualizacji zostawisz pole puste.
Jeśli klucza brakuje lub API nie odpowiada, moduł po cichu przełącza się na silnik self-hosted. Szuflada nigdy nie jest blokowana przez błąd AI.
Działanie silnika rekomendacji
Sugestie są budowane z puli produktów pochodzącej z trzech źródeł, w kolejności priorytetu:
- Współzakup (market-basket): produkty rzeczywiście zamawiane razem z tymi z koszyka, na podstawie ważnych zamówień (najwyższa waga).
- Pokrewieństwo kategorii: produkty z tych samych kategorii co koszyk.
- Bestsellery: zapas na wypadek zbyt krótkiej historii zamówień.
Wynik jest cache’owany według składu koszyka przez konfigurowalny czas, aby ograniczyć obliczenia. Gdy strategia AI jest aktywna, warstwa sztucznej inteligencji zmienia kolejność tej puli i generuje krótkie, spersonalizowane uzasadnienie dla każdego produktu.
Wydajność
Zawartość szuflady jest ładowana w Ajax dopiero przy otwarciu: żadne dodatkowe zapytanie nie jest wykonywane, dopóki klient nie otworzy koszyka. Cache’owane rekomendacje pozwalają uniknąć ponownego uruchamiania silnika przy każdym wyświetleniu.
FAQ i rozwiązywanie problemów
Szuflada się nie otwiera
Sprawdź, czy moduł jest włączony, wyczyść pamięć podręczną PrestaShop (Ustawienia zaawansowane > Wydajność) i upewnij się, że motyw ładuje jQuery po stronie front office.
Nie wyświetla się żadna rekomendacja
W nowym sklepie bez historii zamówień silnik opiera się na pokrewieństwie kategorii, a następnie na bestsellerach. Upewnij się, że w katalogu są aktywne i widoczne produkty.
Sugestie AI się nie zmieniają
Wyniki są cache’owane według składu koszyka. Podczas testów skróć czas życia cache lub zmień zawartość koszyka, aby wygenerować nowy klucz cache.