# dfbundlevisual: często kupowane razem

> Prezentacja dfbundlevisual wyświetla na karcie produktu blok „Często kupowane razem" w stylu Amazona: zaznaczalne karty produktów rozdzielone znakami „+", suma przeliczana na żywo i jeden przycisk dodający cały wybór do…

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

## Prezentacja

dfbundlevisual wyświetla na karcie produktu blok „Często kupowane razem" w stylu Amazona: zaznaczalne karty produktów rozdzielone znakami „+", suma przeliczana na żywo i jeden przycisk dodający cały wybór do koszyka. Rabat na zestaw (procent lub stała kwota brutto) jest stosowany automatycznie, gdy kompletny zestaw znajduje się w koszyku. Bez zestawu ręcznego moduł może sugerować produkty rzeczywiście kupowane razem na podstawie historii zamówień.

## Instalacja

1. W panelu administracyjnym otwórz **Moduły > Menedżer modułów > Zainstaluj moduł**.
2. Wgraj plik `dfbundlevisual.zip`, następnie kliknij **Zainstaluj**.
3. Moduł tworzy swoje tabele, zakładkę **Katalog > Zestawy wizualne** i rejestruje się na potrzebnych hookach.

Zgodność z PrestaShop 8.0 do 9.x, sklep pojedynczy i multisklep. Żadnych zależności: ani Composera, ani frameworka, ani jQuery.

## Konfiguracja

Otwórz stronę konfiguracji modułu (**Moduły > Menedżer modułów > dfbundlevisual > Konfiguruj**):

- **Włącz moduł**: główny przełącznik bloku front-end.
- **Punkt zaczepienia wyświetlania**: `displayFooterProduct` (dół karty produktu, zalecany) lub `displayProductAdditionalInfo` (pod przyciskiem zakupu, zależnie od motywu).
- **Tytuł bloku**: konfigurowalny per język. Domyślnie „Często kupowane razem" po polsku.
- **Włącz automatyczne sugestie**: wyświetla sugestie oparte na współzakupach, gdy dla oglądanego produktu nie istnieje żaden zestaw ręczny.
- **Maksymalna liczba automatycznych sugestii**: liczba proponowanych produktów komplementarnych (domyślnie 2).
- **Minimalna liczba współzakupów**: minimalna liczba zamówień zawierających oba produkty, aby sugestia się pojawiła (domyślnie 2).
- **Okno historii zamówień (dni)**: analizowany okres współwystępowania (domyślnie 365).

## Tworzenie zestawu

1. Otwórz **Katalog > Zestawy wizualne**, następnie kliknij **Dodaj**.
2. **Nazwa zestawu**: nazwa wewnętrzna, używana także jako etykieta rabatu w koszyku.
3. **Produkt główny**: wyszukaj po nazwie, indeksie lub ID. To na karcie tego produktu wyświetli się blok.
4. **Produkty zestawu**: dodaj jeden lub kilka produktów komplementarnych przez wyszukiwarkę z autouzupełnianiem.
5. **Typ i wartość rabatu**: brak rabatu, procent (maks. 100) lub stała kwota brutto.
6. Aktywuj zestaw i zapisz.

Jeden zestaw na produkt główny i na sklep: blok pozostaje czytelny, a przekaz handlowy spójny. W multisklepie każdy sklep może mieć własny zestaw dla tego samego produktu.

## Działanie rabatu

Rabat jest stosowany przez **dynamiczną regułę koszyka** tworzoną w locie dla każdego koszyka (kod `DFBV-{id_zestawu}-{id_koszyka}`) i **ograniczoną wyłącznie do produktów zestawu**:

- Jest tworzona tylko wtedy, gdy kompletny zestaw znajduje się w koszyku; weryfikacja odbywa się po stronie serwera.
- Rabat procentowy dotyczy wyłącznie produktów zestawu, nigdy reszty koszyka.
- Jeśli klient usunie produkt zestawu, rabat jest kasowany automatycznie.
- Przy walidacji zamówienia reguła jest dezaktywowana, aby nie mogła zostać ponownie użyta.
- Przy odinstalowaniu modułu wszystkie wygenerowane reguły są czyszczone.

Rabat procentowy dodaje się do ewentualnych cen specyficznych: obliczenie startuje od ceny widocznej dla klienta. Sprawdź swoje marże, jeśli łączysz promocje katalogowe z rabatem na zestaw.

## Automatyczne sugestie

Gdy dla oglądanego produktu nie istnieje żaden aktywny zestaw ręczny, a opcja jest włączona, moduł analizuje współwystępowanie produktów w Twoich **ważnych zamówieniach** w skonfigurowanym oknie czasowym, a następnie wyświetla najczęstsze kombinacje spełniające próg współzakupów. Produkty bez stanu magazynowego są wykluczone. Wynik trafia do pamięci podręcznej, aby chronić wydajność. Na automatyczne sugestie nie jest stosowany żaden rabat: rabat zarezerwowany jest dla zestawów ręcznych.

## Statystyki

Lista **Katalog > Zestawy wizualne** pokazuje dla każdego zestawu jego **wyświetlenia** (pokazania bloku) i **konwersje** (kompletne dodania do koszyka). Sugestie automatyczne liczone są globalnie. Wykorzystaj te liczby do dostrajania składów i rabatów.

## Rozwiązywanie problemów

- **Blok się nie wyświetla**: sprawdź, czy moduł jest włączony, czy dla produktu istnieje aktywny zestaw (lub czy automatyczne sugestie są włączone przy wystarczającej historii) oraz czy wybrany hook jest obecny w Twoim motywie.
- **Rabat się nie pojawia**: jest tworzony tylko wtedy, gdy wszystkie produkty zestawu są w koszyku. Sprawdź też, czy typ rabatu nie jest ustawiony na „Brak rabatu".
- **Brak automatycznych sugestii**: obniż próg minimalnych współzakupów lub poszerz okno historii; potrzebne są ważne zamówienia zawierające produkty razem.
- **Produkty z wariantami**: przy dodawaniu używany jest wariant domyślny, z kontrolą stanu magazynowego.