# dfbundlevisual: vaak samen gekocht

> Overzicht dfbundlevisual toont op de productfiche een blok « Vaak samen gekocht » in Amazon-stijl: aanvinkbare productkaarten gescheiden door « + », een totaalprijs die live wordt herrekend en één…

- Pagina: <https://www.datafirefly.com/nl/documentation/dfbundlevisual/>
- Taal: nl
- Bijgewerkt op: 2026-09-09
- Andere talen: [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), [pl](https://www.datafirefly.com/pl/documentation/dfbundlevisual/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfbundlevisual/index.md)
- Index: <https://www.datafirefly.com/nl/documentation/llms.txt>

## Overzicht

dfbundlevisual toont op de productfiche een blok « Vaak samen gekocht » in Amazon-stijl: aanvinkbare productkaarten gescheiden door « + », een totaalprijs die live wordt herrekend en één knop om de selectie aan de winkelwagen toe te voegen. Er wordt automatisch een setkorting toegepast (percentage of vast bedrag inclusief btw) zodra de volledige set in de winkelwagen zit. Zonder handmatige set kan de module de producten voorstellen die volgens uw bestelhistoriek daadwerkelijk samen worden gekocht.

## Installatie

1. Open in de backoffice **Modules > Modulebeheer > Een module installeren**.
2. Upload het bestand `dfbundlevisual.zip` en klik op **Installeren**.
3. De module maakt zijn tabellen en zijn tabblad **Catalogus > Visuele sets** aan en registreert zich op de nodige hooks.

Compatibel met PrestaShop 8.0 tot 9.x, met één winkel en met multistore. Geen enkele afhankelijkheid: geen Composer, geen framework, geen jQuery.

## Configuratie

Open de configuratiepagina van de module (**Modules > Modulebeheer > dfbundlevisual > Configureren**):

- **De module inschakelen**: hoofdschakelaar van het blok aan de frontzijde.
- **Weergavehook**: `displayFooterProduct` (onder aan de productfiche, aanbevolen) of `displayProductAdditionalInfo` (onder de aankoopknop, afhankelijk van het thema).
- **Titel van het blok**: per taal aan te passen. Standaard « Souvent achetés ensemble » in het Frans.
- **Automatische suggesties inschakelen**: toont suggesties op basis van samen kopen wanneer er voor het bekeken product geen handmatige set bestaat.
- **Maximaal aantal automatische suggesties**: aantal aanvullende producten dat wordt voorgesteld (standaard 2).
- **Minimum aantal keer samen gekocht**: minimaal aantal bestellingen met beide producten voordat een suggestie verschijnt (standaard 2).
- **Venster van de bestelhistoriek (dagen)**: de periode die op samen voorkomen wordt geanalyseerd (standaard 365).

## Een set aanmaken

1. Open **Catalogus > Visuele sets** en klik op **Toevoegen**.
2. **Naam van de set**: interne naam, die ook als opschrift van de korting in de winkelwagen wordt gebruikt.
3. **Hoofdproduct**: zoek op naam, referentie of ID. Op de fiche van dit product verschijnt het blok.
4. **Producten van de set**: voeg een of meer aanvullende producten toe via het zoekveld met autocomplete.
5. **Type en waarde van de korting**: geen korting, een percentage (maximaal 100) of een vast bedrag inclusief btw.
6. Zet de set actief en sla op.

Eén set per hoofdproduct en per winkel: zo blijft het blok leesbaar en de commerciële boodschap eenduidig. In multistore kan elke winkel voor hetzelfde product een eigen set hebben.

## Hoe de korting werkt

De korting wordt toegepast via een **dynamische winkelwagenregel** die per winkelwagen ter plekke wordt aangemaakt (code `DFBV-{id_set}-{id_winkelwagen}`) en **beperkt blijft tot de producten van de set**:

- Zij wordt alleen aangemaakt als de volledige set in de winkelwagen zit, wat aan serverzijde wordt gecontroleerd.
- Een procentuele korting geldt uitsluitend voor de producten van de set, nooit voor de rest van de winkelwagen.
- Haalt de klant een product uit de set weg, dan wordt de korting automatisch verwijderd.
- Bij de validatie van de bestelling wordt de regel uitgeschakeld zodat zij niet opnieuw kan worden gebruikt.
- Bij het verwijderen van de module worden alle aangemaakte regels opgeruimd.

De procentuele korting komt boven op eventuele specifieke prijzen: de berekening vertrekt van de prijs die de klant ziet. Controleer uw marges als u catalogusacties en setkortingen combineert.

## Automatische suggesties

Bestaat er voor het bekeken product geen actieve handmatige set en staat de optie aan, dan analyseert de module het samen voorkomen van producten in uw **geldige bestellingen** binnen het ingestelde venster, en toont hij de vaakst voorkomende combinaties die de drempel halen. Uitverkochte producten vallen af. Het resultaat wordt in cache gezet om de prestaties te sparen. Op automatische suggesties wordt geen korting toegepast: die blijft voorbehouden aan handmatige sets.

## Statistieken

De lijst **Catalogus > Visuele sets** toont per set de **weergaven** (hoe vaak het blok verscheen) en de **conversies** (volledige toevoegingen aan de winkelwagen). De automatische suggesties worden globaal geteld. Gebruik die cijfers om samenstellingen en kortingen bij te sturen.

## Problemen oplossen

- **Het blok verschijnt niet**: controleer of de module aanstaat, of er voor het product een actieve set bestaat (of de automatische suggesties aanstaan met voldoende historiek), en of de gekozen hook in uw thema aanwezig is.
- **De korting verschijnt niet**: die wordt pas aangemaakt als alle producten van de set in de winkelwagen zitten. Controleer ook of het kortingstype niet op « Geen korting » staat.
- **Geen enkele automatische suggestie**: verlaag de drempel voor samen kopen of verruim het historiekvenster; er moeten geldige bestellingen zijn waarin de producten samen voorkomen.
- **Producten met varianten**: bij het toevoegen wordt de standaardvariant gebruikt, met controle van de voorraad.