# DataFirefly Cross-selling w koszyku: propozycje produktów w koszyku PrestaShop
> Przegląd DataFirefly Cross-selling w koszyku wyświetla propozycje produktów na stronie koszyka, w oknie dodania do koszyka i w pustym koszyku. Klient dodaje propozycję jednym kliknięciem, wybiera wariant bezpośrednio na karcie,…
- Strona:
- Język: pl
- Zaktualizowano: 2026-11-02
- Inne języki: [en](https://www.datafirefly.com/en/documentation/dfcartcrosssell/index.md), [fr](https://www.datafirefly.com/documentation/dfcartcrosssell/index.md), [es](https://www.datafirefly.com/es/documentation/dfcartcrosssell/index.md), [de](https://www.datafirefly.com/de/documentation/dfcartcrosssell/index.md), [it](https://www.datafirefly.com/it/documentation/dfcartcrosssell/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfcartcrosssell/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfcartcrosssell/index.md)
- Indeks:
## Przegląd
DataFirefly Cross-selling w koszyku wyświetla propozycje produktów na **stronie koszyka**, w **oknie dodania do koszyka** i w **pustym koszyku**. Klient dodaje propozycję jednym kliknięciem, wybiera wariant bezpośrednio na karcie, a koszyk aktualizuje się bez przeładowania strony.
Propozycje pochodzą najpierw z Twoich **reguł**, a następnie ze **źródeł automatycznych**: produkty powiązane, często kupowane razem, ta sama kategoria, ta sama marka, te same cechy, bestsellery, nowe produkty i podobna cena. Reguła może obniżyć cenę swoich produktów, dopóki koszyk zawiera produkt, który ją uruchamia.
Moduł działa w PrestaShop od 1.7.8 do 9.x z PHP od 7.1 do 8.5, z motywami Classic i Hummingbird. Jest dostępny w językach: angielskim, francuskim, hiszpańskim, niemieckim, włoskim, polskim, niderlandzkim i portugalskim.
## Instalacja i aktualizacja
1. W **Moduły > Menedżer modułów** kliknij **Załaduj moduł** i upuść plik `dfcartcrosssell-2.0.0.zip`.
2. Kliknij **Konfiguruj**, aby otworzyć stronę modułu z czterema zakładkami: Pulpit, Reguły, Ustawienia i Narzędzia.
Podczas instalacji moduł buduje indeks „często kupowane razem” na podstawie istniejących zamówień, dzięki czemu to źródło działa od pierwszej wizyty.
Aktualizacja z wersji 1.0: załaduj plik zip 2.0.0 na stary moduł. Ustawienia i statystyki zostają zachowane, zestawy z wersji 1.0 stają się regułami, a pamięć podręczna połączonych plików JS/CSS zostaje wyczyszczona. Rabat na zestawy z wersji 1.0 nigdy nie był naliczany w koszykach: rabaty działają teraz przez oferty reguł.
## Gdzie pojawiają się propozycje
### Strona koszyka
Domyślnie blok jest wyświetlany pod produktami w koszyku jako karuzela, siatka lub lista kompaktowa. Nad nim blok **często kupowane razem** pokazuje produkty często zamawiane razem z zawartością koszyka, z polami wyboru, wyborem wariantu, rzeczywistą sumą zaznaczonych produktów i jednym przyciskiem do dodania ich wszystkich.
Strona koszyka z blokiem często kupowane razem i karuzelą propozycji z cenami ofertowymi
Blok można też umieścić w kolumnie podsumowania zamówienia: staje się wtedy listą kompaktową z maksymalnie 4 produktami.
### Okno dodania do koszyka
Gdy klient doda produkt z dowolnej strony, okno potwierdzenia wyświetla propozycje do tego produktu. Po dodaniu propozycji okno pozostaje otwarte, licznik koszyka się aktualizuje, a nowa wartość koszyka jest ogłaszana czytnikom ekranu.
Okno potwierdzenia dodania do koszyka z propozycjami do właśnie dodanego produktu
### Pusty koszyk
Pusty koszyk pokazuje Twoje bestsellery, więc strona nigdy nie jest ślepym zaułkiem.
Strona pustego koszyka z bestsellerami sklepu
### Urządzenia mobilne
Na telefonie karuzelę przewija się palcem, a wystająca krawędź następnej karty zachęca do przewijania. Strzałki, nawigacja klawiaturą i opcjonalne automatyczne przewijanie są dostępne na komputerze; automatyczne przewijanie zatrzymuje się po najechaniu kursorem, przy fokusie i gdy odwiedzający woli ograniczony ruch.
Karuzela propozycji na telefonie
## Dodawanie do koszyka jednym kliknięciem
Każda karta pokazuje cenę, cenę regularną, gdy produkt jest przeceniony, etykietę rabatu lub oferty, markę oraz, jeśli moduł Komentarze produktów jest aktywny, rzeczywistą średnią ocenę zatwierdzonych opinii. Produkty z wariantami mają na karcie listę rozwijaną: cena zmienia się zgodnie z wybranym wariantem, a niedostępne warianty są wyszarzone.
Przycisk dodania wysyła żądanie weryfikowane przez serwer: produkt musi być aktywny, widoczny, dostępny do zamówienia, dostępny w magazynie (chyba że dozwolone są zamówienia przy braku w magazynie), bez wymaganej personalizacji i dostępny dla grupy klienta. Następnie moduł uruchamia odświeżenie koszyka w motywie: sumy, podgląd koszyka i sam blok aktualizują się bez przeładowania strony, a podczas ponownego obliczania propozycji wyświetlany jest szkielet ładowania.
Dodanie do koszyka jednym kliknięciem z wyborem wariantu
## Reguły
Reguły wybierają produkty do zaproponowania dla określonych koszyków. Są wyświetlane przed propozycjami automatycznymi, od najwyższego do najniższego priorytetu. Lista pokazuje warunki uruchomienia, proponowane produkty, ofertę, priorytet, status (aktywna, nieaktywna, zaplanowana, wygasła) oraz dodania i przychód z ostatnich 30 dni.
Lista reguł cross-sellingu z warunkami, proponowanymi produktami, ofertami, priorytetem i statusem
### Tworzenie reguły
1. **Gdy koszyk zawiera**: produkty, kategorie (łącznie z podkategoriami) lub wartości cech. Pozostaw wszystko puste, aby stosować regułę do każdego koszyka. Można dodać minimalną wartość koszyka.
2. **Proponuj**: produkty w wybranej kolejności, kategorie lub wartości cech (używane są najlepiej sprzedające się produkty).
3. **Oferta** (opcjonalnie): procent lub kwota brutto na proponowane produkty wymienione w regule.
4. **Opcje**: priorytet od 0 do 100, pokazywanie tylko produktów tej reguły, daty rozpoczęcia i zakończenia, grupy klientów oraz własny tytuł bloku w każdym języku.
Podgląd po prawej stronie pokazuje karty dokładnie tak, jak zobaczą je klienci, z cenami ofertowymi.
Edytor reguły
### Reguły oparte na cechach produktów
Regułę mogą uruchamiać wartości cech (na przykład _Kolekcja: Inspirujące cytaty_), a proponować może ona produkty z innymi wartościami (na przykład _Skład: Ceramika_). Wyszukaj wartość w formacie _Cecha: wartość_; przy każdej wartości widać liczbę produktów.
Reguła cross-sellingu według cech
### Oferty
Oferta obniża cenę proponowanego produktu, dopóki koszyk zawiera też **inny** produkt uruchamiający regułę. Jest obliczana przez serwer i stosowana jako cena specyficzna ograniczona do tego koszyka: nic, co wysyła przeglądarka, nie może jej zmienić. Jest ponownie sprawdzana przy każdej zmianie koszyka i usuwana, gdy tylko koszyk przestaje spełniać warunek. Istniejące promocje katalogowe zostają zachowane: oferta dotyczy ceny już obniżonej.
Propozycje reguły z własnym tytułem i ofertą kwotową dla koszyka z herbatą
Oferta obejmuje wszystkie sztuki danego produktu w koszyku. Wyłącz **Oferty reguł** w ustawieniach, aby zatrzymać wszystkie oferty naraz.
## Propozycje automatyczne i cechy produktów
Każde źródło automatyczne ma wagę od 0 (wyłączone) do 10. Produkty znalezione przez kilka źródeł otrzymują wyższy wynik. Źródło **Te same cechy** proponuje produkty, które mają najwięcej wspólnych wartości cech z koszykiem; można je ograniczyć do wybranych cech.
Wagi źródeł automatycznych
DataFirefly Tagi na cechy zamienia tagi produktów na natywne cechy. Cross-selling odczytuje te cechy na bieżąco, bez żadnych ustawień: gdy tylko tagi zostaną przekonwertowane, źródło „te same cechy” i reguły oparte na cechach od razu z nich korzystają.
Produkty nieaktywne, niewidoczne i niedostępne, produkty wymagające personalizacji oraz produkty z kategorii ukrytych przed grupą klienta nigdy nie są proponowane. W sekcji **Filtry i wykluczenia** możesz też ukryć produkty niedostępne w magazynie, produkty, które są już w koszyku, oraz wybrane produkty lub kategorie.
## Wyświetlanie i wygląd
Zakładka Ustawienia obejmuje pozycję w koszyku, układ, liczbę produktów, tytuły w każdym języku, okno dodania do koszyka, pusty koszyk, blok kupowane razem, zawartość kart, cztery style kart, kolor akcentu (lub kolory Twojego motywu), zaokrąglenie narożników i cień. W trybie multistore ustawienia są zapisywane osobno dla każdego sklepu.
Ustawienia wyświetlania
## Pulpit
Pulpit pokazuje wyłącznie dane zapisane przez moduł w Twoim sklepie: wyświetlenia bloku, kliknięcia produktów, dodania do koszyka, współczynnik dodań, zamówienia z proponowanym produktem oraz **dodatkowy przychód**, czyli sumę netto pozycji zamówień produktów dodanych z bloku w ważnych zamówieniach. Porównuje też średnią wartość zamówienia z proponowanym produktem i bez niego, a każdą liczbę z poprzednim okresem.
Pulpit cross-sellingu
Tabele przedstawiają wyświetlenia, dodania, współczynnik i przychód według źródła i według miejsca (strona koszyka, okno, pusty koszyk, blok kupowane razem) oraz wymieniają najskuteczniejsze produkty.
Wyniki propozycji według źródła i miejsca
## Narzędzia
**Symulator koszyka** pokazuje propozycje dla dowolnej listy produktów, ze źródłem, regułą i wynikiem każdej z nich: to najszybszy sposób na sprawdzenie reguły lub wag.
Symulator koszyka
- **Indeks „często kupowane razem”**: aktualizowany przy każdym zamówieniu; odbuduj go po imporcie zamówień lub zmianie długości historii.
- **Zadanie cykliczne** (opcjonalnie): wywołuj adres URL raz dziennie, aby odbudować indeks i usunąć stare dane. Bez niego czyszczenie uruchamia się samoczynnie najwyżej raz dziennie.
- **Konserwacja**: liczba koszyków z aktywną ofertą oraz usuwanie statystyk.
## Bezpieczeństwo i prywatność
- Dodanie do koszyka wymaga żądania POST z tokenem sklepu; ceny i ilości wysłane przez przeglądarkę są ignorowane.
- Wyświetlenia i kliknięcia są podpisywane przez serwer, więc sfałszowane statystyki są odrzucane.
- Statystyki nie zawierają danych osobowych: tylko dzienne liczniki dla każdego produktu oraz identyfikator koszyka, służący wyłącznie do powiązania dodania z zamówieniem.
- Odinstalowanie usuwa tabele, ustawienia i oferty koszykowe modułu.
## Rozwiązywanie problemów
### Blok się nie wyświetla
Sprawdź, czy opcja **Pokazuj propozycje** jest włączona, czy pozycja w koszyku nie jest ustawiona na _Nie na stronie koszyka_ i czy istnieją produkty, które można zaproponować: symulator koszyka pokazuje, dlaczego lista jest pusta.
### Po aktualizacji nadal ładuje się stary skrypt
Aktualizacja czyści pamięć podręczną połączonych plików. Jeśli pamięć podręczna serwera lub CDN przechowuje starą kopię, wyczyść ją również.
### Oferta nie jest stosowana
Koszyk musi zawierać inny produkt uruchamiający regułę, reguła musi być aktywna i mieścić się w swoich datach, a oferta musi dawać cenę niższą od obecnej.