# Winkelwagenpopulariteit: volledige gids

> Installatie- en configuratiegids voor de module Winkelwagenpopulariteit: badge met winkelwagenteller op de productpagina, drempel, tijdvenster, cache en probleemoplossing.

- Pagina: <https://www.datafirefly.com/nl/documentation/popularite-panier/>
- Taal: nl
- Bijgewerkt op: 2026-09-10
- Andere talen: [fr](https://www.datafirefly.com/documentation/popularite-panier/index.md), [en](https://www.datafirefly.com/en/documentation/popularite-panier/index.md), [es](https://www.datafirefly.com/es/documentation/popularite-panier/index.md), [de](https://www.datafirefly.com/de/documentation/popularite-panier/index.md), [it](https://www.datafirefly.com/it/documentation/popularite-panier/index.md), [pl](https://www.datafirefly.com/pl/documentation/popularite-panier/index.md), [pt](https://www.datafirefly.com/pt/documentation/popularite-panier/index.md)
- Index: <https://www.datafirefly.com/nl/documentation/llms.txt>

De module **Winkelwagenpopulariteit** toont op de productpagina een social-proof-badge met het aantal winkelwagens dat het product bevat, bijvoorbeeld "In meer dan 20 winkelwagens". Deze gids behandelt de installatie, de configuratie van elke instelling, de werking van de telling en de probleemoplossing.

## Installatie

De module installeert zoals elke PrestaShop-module, zonder externe afhankelijkheid.

1. Open in de back-office **Modules > Modulebeheer**.
2. Klik op **Een module uploaden** en selecteer het bestand `dfcartpopularity.zip`.
3. Klik na de installatie op **Configureren**.

Compatibel met PrestaShop 8.0 tot 9.x. Er is geen Composer-afhankelijkheid en geen externe JavaScript-bibliotheek vereist.

## Configuratie

De configuratiepagina bundelt alle weergave- en telinstellingen.

### Weergegeven tekst

De boodschap in de badge, vertaalbaar per taal. Gebruik de placeholder `{count}` om het aantal dynamisch in te voegen. Voorbeeld: _In meer dan {count} winkelwagens_. Vertalingen in het Frans, Engels, Spaans, Duits en Italiaans worden standaard meegeleverd.

### Weergavedrempel

Minimumaantal winkelwagens vanaf wanneer de badge verschijnt. Onder deze drempel wordt niets getoond, wat voorkomt dat een weinig indrukwekkend cijfer zichtbaar is. Standaardwaarde: 20.

### Weergavemodus van het aantal

- **Afgeronde trede**: de teller wordt naar beneden afgerond per trede (bv. 23 winkelwagens toont "meer dan 20"). Ideaal voor een geloofwaardig effect dat per schijf evolueert.
- **Exact aantal**: het echte cijfer wordt getoond, voor winkels die volledige transparantie verkiezen.

### Afrondingstrede

Alleen gebruikt in de tredemodus. Bepaalt de afrondingsschijf: een trede van 10 maakt van 23 "meer dan 20" en van 37 "meer dan 30".

### Tijdvenster (uren)

Telt alleen de winkelwagens die binnen dit venster zijn bijgewerkt. Bijvoorbeeld 168 = 7 dagen. Zet op `0` om geen enkele tijdslimiet op te leggen.

### Alleen actieve winkelwagens

Met deze optie ingeschakeld worden winkelwagens die al in een bestelling zijn omgezet, uitgesloten van de telling. Zo weerspiegelt u alleen de actieve vraag.

### Locatie

Kies waar de badge op de fiche verschijnt: onder het blok toevoegen aan winkelwagen (extra info) of bij de koopknoppen.

### Cacheduur (seconden)

Bewaartijd van de telling vóór herberekening. Standaard 600 seconden (10 minuten). Zet op `0` om bij elke weergave te herberekenen, wat in productie wordt afgeraden.

Bij elke opslag van de instellingen wordt de telcache automatisch geleegd, zodat uw nieuwe parameters onmiddellijk gelden.

## Hoe de telling werkt

De module telt de echte winkelwagens die het product bevatten. De telling wordt gededupliceerd per winkelwagen (eenzelfde winkelwagen wordt nooit twee keer geteld) en beperkt tot de huidige winkel in een multistore-context. Het tijdvenster en de optie "alleen actieve winkelwagens" verfijnen deze telling zodat ze de relevante vraag weerspiegelt.

## Prestaties en cache

Om een telquery bij elke productweergave te vermijden, wordt het resultaat opgeslagen in een aparte cachetabel met een instelbare levensduur. De telling wordt pas herberekend wanneer de cache verloopt, wat de prestaties beschermt, ook bij winkels met veel verkeer.

## Multistore en meertaligheid

In multistore wordt de telling beperkt tot de bezochte winkel. Qua talen is de badgetekst volledig vertaalbaar: hij wordt onafhankelijk ingesteld voor elke actieve winkeltaal, met de placeholder `{count}` voor het aantal.

## Integratie in het thema

De badge wordt server-side gerenderd via een template van de module. Wilt u hem precies herpositioneren in uw thema, dan bevat de Smarty-variabele `{$dfcp_message}` de kant-en-klare boodschap en kan ze worden ingevoegd in een override van de productpagina.

## Probleemoplossing

### De badge wordt niet getoond

Controleer of het echte aantal winkelwagens met het product de ingestelde drempel bereikt. Staat de drempel op 20 maar zit het product maar in 5 winkelwagens, dan verschijnt geen badge; dat is het verwachte gedrag. Verlaag de drempel tijdelijk om de weergave te testen.

### Het aantal wordt niet onmiddellijk bijgewerkt

Dat is het effect van de cache. Wacht tot de ingestelde duur verloopt, of sla de instellingen op om de cache onmiddellijk te legen.

### De teller lijkt te laag

Met de optie "alleen actieve winkelwagens" ingeschakeld en een kort tijdvenster worden alleen recente, niet-bestelde winkelwagens geteld. Verbreed het tijdvenster of schakel de optie uit voor een ruimere telling.