# Cookie Manager Tarteaucitron: volledige gids

> Overzicht Cookie Manager Tarteaucitron is een module voor het beheer van cookietoestemming in PrestaShop 8.0+ en 9.x. Hij combineert de opensource-engine tarteaucitron.js, die diensten daadwerkelijk blokkeert vóór toestemming, met een…

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

## Overzicht

Cookie Manager Tarteaucitron is een module voor het beheer van cookietoestemming in PrestaShop 8.0+ en 9.x. Hij combineert de opensource-engine tarteaucitron.js, die diensten daadwerkelijk blokkeert vóór toestemming, met een moderne interface: een geanimeerde zwevende kaart, schakelaars per categorie en een pil om opnieuw te openen. Inbegrepen zijn Google Consent Mode v2, een trackerscanner met activering in één klik en een exporteerbaar toestemmingslogboek.

Sinds versie 1.2.0 worden de tarteaucitron-bestanden vanaf uw eigen domein geserveerd: er gaat geen enkel verzoek naar een externe CDN voordat de bezoeker toestemming heeft gegeven.

## Installatie

1. Ga naar **Modules → Modulebeheer → Een module uploaden**.
2. Upload het bestand `datafirefly_tarteaucitron.zip`.
3. Klik op **Installeren** en daarna op **Configureren**.

Het configuratiescherm is op twee manieren bereikbaar, beide tonen dezelfde pagina: de knop **Configureren** in het modulebeheer, of het menu-item **Cookie Manager** dat bij de installatie wordt toegevoegd.

Leeg na elke update de PrestaShop-cache via **Geavanceerde parameters → Prestaties**. Het upgradescript leegt ook de PHP-OPcache wanneer dat mag.

## Bijwerken vanaf een oudere versie

Overschrijf `/modules/datafirefly_tarteaucitron/` of installeer de nieuwe ZIP vanuit de backoffice. Het upgradescript draait vanzelf en verzorgt de logboektabel als die ontbreekt, de nieuwe configuratiesleutels, de hernoemde bannerposities (`bottom` wordt `bottom-left`, `middle` en `popup` worden `center`) en het menu-item als dat ontbreekt.

Gebruikte u de positie `middle` of `popup`, dan wordt de banner een gecentreerde modal met verduisterde achtergrond. Het gedrag klopt, maar de weergave verandert zichtbaar: controleer die vóór livegang.

## Algemene instellingen

- **Module ingeschakeld**: hoofdschakelaar voor de banner in de frontoffice.
- **Bannertaal**: op automatisch volgt die de PrestaShop-taal van de pagina. U kunt ook een van de 36 meegeleverde talen forceren.
- **Bannerpositie**: linksonder of rechtsonder, linksboven of rechtsboven, of gecentreerd als modal.
- **tarteaucitron-bestanden**: lokaal gehost, aanbevolen, of de jsDelivr-CDN. Zie het aparte hoofdstuk.
- **Geldigheid van de toestemming**: standaard 365 dagen. Aanbevolen wordt niet boven 13 maanden te gaan, dus 395 dagen.
- **Cookienaam**: standaard `tarteaucitron`. Wijzigen zet de al verzamelde toestemmingen terug, omdat de oude cookie niet meer wordt gelezen.
- **Cookiedomein**: leeg voor het huidige domein, of met een punt ervoor om toestemming over subdomeinen te delen.
- **Heropeningspil**: toont na de toestemming een kleine Cookies-pil. Zie het hoofdstuk over intrekken.
- **Sluiten is weigeren**: voegt een kruisje toe dat alle niet-essentiële cookies weigert. Uitgeschakeld dwingt de banner een expliciete keuze af.

Het tabblad **Teksten & links** past titel, boodschap en knoplabels aan; een leeg veld gebruikt de eigen tekst van de module in de bannertaal. Het tabblad **Ontwerp** regelt de kleuren en de hoekafronding, met een live voorbeeld en een WCAG-contrastcontrole tussen knopkleur en knoptekst.

## Waar de tarteaucitron-bestanden vandaan komen

Een cookiebanner die zijn eigen bestanden van een CDN laadt, geeft het IP-adres van de bezoeker aan een derde partij nog voordat die iets heeft gekozen. Daarom levert de module tarteaucitron.js 1.30.0 en de 36 taalbestanden mee in `views/vendor/tarteaucitron/`, geserveerd vanaf uw domein.

De optie **jsDelivr-CDN** blijft beschikbaar in het tabblad Algemeen. Ze wordt niet aanbevolen: ze geeft het IP-adres van de bezoeker al bij het laden van de pagina door aan jsDelivr, vóór elke toestemming.

## Diensten inschakelen

Het tabblad **Diensten** toont de 11 kant-en-klare integraties. Zet per dienst de schakelaar aan en vul de gevraagde identificatiecode in:

- **Google Analytics 4**: Measurement ID, formaat G-XXXXXXXX
- **Google Tag Manager**: Container ID, formaat GTM-XXXXXX
- **Google Ads**: Conversion ID
- **Meta Pixel**: numerieke Pixel ID
- **Hotjar**: numerieke Site ID
- **LinkedIn Insight**: Partner ID
- **TikTok Pixel**: Pixel ID
- **Microsoft Clarity**: Project ID
- **Intercom**: App ID
- **YouTube**: geen identificatiecode, blokkeert ingesloten video's vóór toestemming
- **Stripe**: geen identificatiecode, zie het aparte hoofdstuk

Een dienst die zonder identificatiecode is ingeschakeld, wordt niet in de frontoffice geladen. De module markeert hem rood in de tabel en waarschuwt bij het opslaan, maar controleer uw codes na gebruik van de automatische activering uit de scanner.

Het codeveld wordt vergrendeld zodra de dienst uitstaat. De opgeslagen waarde blijft bewaard en komt terug zodra u de dienst weer inschakelt.

## Scanner en automatische detectie

1. Klik in het tabblad **Autodetectie** op **Site nu scannen**. De module leest de cookies op uw domein en haalt de HTML van uw frontoffice op om scripttags van derden te analyseren.
2. Er verschijnen twee tabellen: gedetecteerde cookies met hun waarschijnlijke dienst en categorie, en herkende externe scripts met hun huidige status in de module.
3. Klik op **Gedetecteerde diensten inschakelen** en sla op.
4. Ga naar het tabblad Diensten om de codes van de nieuw ingeschakelde diensten in te vullen.

De scanner herkent Google Analytics, Google Tag Manager, Google Ads, Meta Pixel, Hotjar, LinkedIn, TikTok, Microsoft Clarity, Intercom, Brevo, Stripe en YouTube, plus de functionele PrestaShop-cookies.

Bezoek eerst uw frontoffice in dezelfde browser en start daarna de scan: de cookies van uw trackers zijn dan zichtbaar en de detectie completer. Staan backoffice en frontoffice op verschillende domeinen, dan werkt alleen de scriptanalyse.

## Statistieken en A/B-test

Sinds versie 1.3.0 meet het tabblad **Statistieken & A/B** wat de banner werkelijk oplevert. De module telt de weergaven en niet alleen de antwoorden: pas daardoor is het acceptatiepercentage te berekenen.

- **Indicatoren**: weergaven, responspercentage, percentage “alles accepteren”, weigeringspercentage, aandeel aangepaste keuzes, opt-in per categorie, verdeling desktop / mobiel en dagelijks verloop, over 7, 30, 90 of 365 dagen of over de volledige historie.
- **Privacy**: de tellers worden per dag, variant en apparaattype geaggregeerd in de tabel `dftac_banner_stats`. Geen persoonsgegevens, geen bezoekersidentificatie, geen cookie. Een weergave wordt dankzij een lokale sessiemarkering één keer per bezoek geteld.
- **Bots**: een user-agentfilter aan serverzijde weert zoekmachines en auditgereedschap, en een weergave telt pas bij het eerste gebaar van de bezoeker (aanwijzer, toets, scrollen of antwoord). Zonder dat filter blazen bots die JavaScript uitvoeren de noemer op zonder ooit te antwoorden, en drukken ze het percentage omlaag.
- **Export en resetten**: CSV-export van de tellers en een resetknop, beide los van het AVG-logboek.

### Een A/B-test uitvoeren

1. Schakel de test in en bepaal welk deel van het verkeer naar variant B gaat. 50 % geeft het snelst een leesbaar resultaat.
2. Vul alleen de velden in die u wilt testen: titel, bericht, de labels van de drie knoppen, positie. Lege velden nemen variant A over.
3. Laat de test lopen. De toewijzing blijft het hele bezoek stabiel.
4. Lees het oordeel: de module vergelijkt beide percentages met een z-toets voor twee proporties en wijst pas een winnaar aan boven 100 weergaven per variant en bij een verschil dat op 95 % significant is.
5. Neem de winnende tekst over in variant A en zet de test uit.

De instelling die het acceptatiepercentage het sterkst beïnvloedt is de positie: vergelijk de gecentreerde modal met de kaart in de hoek voordat u aan de formuleringen sleutelt.

## Google Consent Mode v2

Verplicht sinds maart 2024 voor Europese adverteerders, laat Consent Mode v2 Google conversies modelleren ook bij weigering. De module verstuurt de zeven vereiste signalen (`ad_storage`, `ad_user_data`, `ad_personalization`, `analytics_storage`, `functionality_storage`, `personalization_storage`, `security_storage`) als _default_ in de ``, vóór elke tag, en werkt ze bij zodra de bezoeker antwoordt. Elke standaardstatus is instelbaar, met `denied` aanbevolen in de EER.

Bijzonderheid: de standaardstatus wordt **afgeleid uit de bestaande toestemmingscookie** als die er is. Wie al akkoord ging krijgt `granted` vanaf het eerste frame, zonder tijdelijk `denied`-venster dat uw Google Ads-conversies bij elke herlading aantast. Server- en browserzijde gebruiken dezelfde koppeling van dienst naar signaal, zodat standaardstatus en update altijd overeenkomen.

**wait_for_update** bepaalt hoelang Google op de banner wacht voordat er data wordt verstuurd. 500 ms is de aanbevolen waarde.

## Stripe en strikt noodzakelijke cookies

De Stripe-cookies (`__stripe_mid`, `__stripe_sid`) zijn nodig om betalingsfraude te voorkomen en vallen onder de uitzondering voor strikt noodzakelijke trackers: blokkeren zou de checkout breken. Staat de dienst Stripe aan, dan laadt hij zonder toestemmingsvraag en verschijnt hij in het voorkeurenpaneel onder **Essentieel en betaling** met het label Altijd actief. De bezoeker is geïnformeerd en geen enkele betaling wordt geblokkeerd.

## Toestemming intrekken

De AVG vereist dat intrekken net zo eenvoudig is als geven. Er zijn drie manieren, te combineren:

- de **zwevende pil** die na de keuze verschijnt, in te schakelen in het tabblad Algemeen;
- een link in uw footer: `[Mijn cookies beheren](#tarteaucitron)` ;
- een JavaScript-aanroep: `dftacOpenPreferences()`, vanuit elk element van uw thema.

Schakelt u de pil uit, zet dan een van de andere twee klaar. Zonder die kan de bezoeker niet meer terugkomen op zijn keuze.

## Eigen diensten

Het tabblad **Eigen diensten** voegt elk ontbrekend extern script toe: een unieke sleutel in kleine letters, een weergavenaam, een categorie (`analytic`, `ads`, `social`, `video`, `support`, `api` of `other`), de JS die pas na toestemming draait, de namen van de geplaatste cookies en een URL naar het privacybeleid. Ze verschijnen in de banner onder een eigen categorie met een eigen schakelaar, en hun categorie bepaalt het bijbehorende Consent Mode-signaal.

De hier ingevoerde code draait ongewijzigd in de frontoffice. Plak alleen code waarvan u de herkomst kent.

## Toestemmingslogboek

Artikel 7 van de AVG vereist dat u kunt aantonen dat toestemming is gegeven. Het tabblad **AVG-logboek** toont de registraties pagina voor pagina, elk met datum en tijd, de anonieme bezoekers-ID, de geaccepteerde categorieën en het detail per dienst.

- Het IP-adres wordt **nooit leesbaar opgeslagen**: alleen een HMAC-SHA256-vingerafdruk, gesalt met een winkeleigen sleutel. Een ongesalte SHA-256 zou met brute kracht over de IPv4-ruimte te herleiden zijn.
- De bezoekers-ID komt uit een eigen technische cookie en bevat geen persoonsgegevens.
- Ontdubbeling op de server negeert een tweede identieke inzending van dezelfde bezoeker binnen 5 seconden, wat dubbelklikken onschadelijk maakt.
- Het versturen gebruikt `keepalive`: het komt ook aan als de bezoeker direct na zijn keuze doorklikt.
- Een automatische opschoning verwijdert vermeldingen na de bewaartermijn die u instelt. Ze draait bij het openen van de configuratiepagina, hoogstens eenmaal per dag.
- **Exporteren naar CSV** levert een bestand met tijdstempel, UTF-8 met BOM zodat het correct opent in Excel.
- Het logboek blijft **behouden als u de module verwijdert**, zodat uw auditspoor intact blijft.
- Het loggen kan worden uitgeschakeld als u dit bewijs niet wilt bewaren.

## Multishop

Elke winkel heeft een eigen configuratie: ingeschakelde diensten, teksten, kleuren, positie en Consent Mode-instellingen. De melding bovenaan het configuratiescherm herinnert u eraan welke winkel u bewerkt.

## Problemen oplossen

- **De banner verschijnt niet**: controleer of de module aanstaat in het tabblad Algemeen, leeg de PrestaShop-cache en zorg dat er geen andere toestemmingsmodule parallel draait.
- **Keuzes worden niet onthouden**: verwijder de oude toestemmingscookie in uw browser voordat u opnieuw test, en controleer of de cookienaam niet is gewijzigd sinds de laatste toestemming.
- **Een dienst laadt niet na acceptatie**: controleer of de identificatiecode is ingevuld. Een lege code bij een ingeschakelde dienst wordt rood gemarkeerd in de tabel.
- **De scan vindt niets**: bezoek eerst de frontoffice in dezelfde browser en start de scan opnieuw.
- **Niets in het logboek**: controleer of het loggen aanstaat in het tabblad AVG-logboek en geef opnieuw toestemming vanuit de frontoffice in een privévenster.
- **Een wijziging in de module heeft geen effect**: leeg de PrestaShop-cache en herlaad PHP als uw host OPcache gebruikt. Het upgradescript leegt OPcache automatisch wanneer dat kan.

Hulp nodig? Neem contact op met de DataFireFly-support vanuit uw klantaccount, antwoord binnen 24 werkuren.