# Przyklejony Koszyk i Cross-sell AI: instalacja i konfiguracja

> Instalacja i konfiguracja modułu Przyklejony Koszyk i Cross-sell AI dla PrestaShop 8 i 9: szuflada Ajax, self-hosted silnik rekomendacji, pasek darmowej dostawy i opcjonalna warstwa AI.

- Strona: <https://www.datafirefly.com/pl/documentation/dfstickycart/>
- Język: pl
- Zaktualizowano: 2026-07-31
- Inne języki: [fr](https://www.datafirefly.com/documentation/dfstickycart/index.md), [en](https://www.datafirefly.com/en/documentation/dfstickycart/index.md), [es](https://www.datafirefly.com/es/documentation/dfstickycart/index.md), [de](https://www.datafirefly.com/de/documentation/dfstickycart/index.md), [it](https://www.datafirefly.com/it/documentation/dfstickycart/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfstickycart/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfstickycart/index.md)
- Indeks: <https://www.datafirefly.com/pl/documentation/llms.txt>

## 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

1. W panelu administracyjnym otwórz **Moduły > Menedżer modułów**.
2. Kliknij **Zainstaluj moduł** i wybierz plik `dfstickycart.zip`.
3. 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:

1. **Współzakup (market-basket)**: produkty rzeczywiście zamawiane razem z tymi z koszyka, na podstawie ważnych zamówień (najwyższa waga).
2. **Pokrewieństwo kategorii**: produkty z tych samych kategorii co koszyk.
3. **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.