PrestaShop

CookiePilot module voor PrestaShop met Consent Mode v2

Upload een ZIP in de Module Manager, koppel het domein van je shop en de module toont de consentbanner vanuit de head van elke shoppagina. Ondersteund op PrestaShop 8.0.0 tot 9.99.99.

Vereisten en ondersteunde versies

  • PrestaShop versie 8.0.0 tot 9.99.99.
  • Toegang tot de back office met rechten om modules te installeren.
  • Een CookiePilot account. Registreren, je e-mailadres verifiëren en inloggen kan rechtstreeks in de module.
  • De module-ZIP, versie 1.0.0, gedownload via de link hieronder. Pak het bestand niet uit.

Download de module

De ZIP wordt geserveerd door de CookiePilot applicatie op het onderstaande adres en wordt nooit via externe marketplaces verspreid. Vergelijk na het downloaden de SHA-256 checksum met de gepubliceerde waarde om te bevestigen dat het bestand onderweg niet is gewijzigd.

Grootte: 228.8 KBSHA-256: 9ac5668263574e760e6f860a4a939c3ee67445d15624e02f6b03d14e5fdb95d9
Download de ZIP

Voer op Linux of macOS het onderstaande commando uit. Gebruik op Windows certutil -hashfile op het gedownloade bestand. De uitvoer moet exact overeenkomen met de gepubliceerde hash.

tmp=$(mktemp)
trap 'rm -f "$tmp"' EXIT
curl -fsSL https://app.cookiepilot.io/downloads/cookiepilot-prestashop-addons-1.0.0.zip -o "$tmp"
echo "9ac5668263574e760e6f860a4a939c3ee67445d15624e02f6b03d14e5fdb95d9  $tmp" | sha256sum --check

Installeer de ZIP via de Module Manager

  1. 1.Open in de back office Modules, daarna Module Manager, en klik op Upload een module.
  2. 2.Sleep de gedownloade ZIP naar het uploadvenster. PrestaShop installeert de module en toont deze in de lijst als CookiePilot CMP.
  3. 3.Klik bij CookiePilot CMP op Configureren om de configuratiepagina van de module te openen.
  4. 4.Wordt de upload geweigerd, controleer dan of je PrestaShop versie tussen 8.0.0 en 9.99.99 ligt en of de ZIP het originele, ongewijzigde bestand is.

Registreren, e-mail verifiëren en de shop koppelen

  1. 1.Maak op de configuratiepagina een CookiePilot account aan of log in met een bestaand account. Voor registratie zijn een e-mailadres en een wachtwoord nodig.
  2. 2.Bevestig de verificatiemail. Zodra het adres is geverifieerd rondt de module het inloggen af.
  3. 3.Koppel de shop: de module maakt het domein automatisch aan in je CookiePilot account, of verbindt opnieuw met een bestaand domein met dezelfde hostnaam.
  4. 4.Het paneel Shop connection toont daarna het gekoppelde domein, het account en het actuele plan, met de status CONNECTED.

Waar het script wordt geplaatst

  1. 1.De module plaatst het CookiePilot script in de head van elke shoppagina, precies een keer, voor de analytics-tags. Je plakt nooit code in het theme en dubbele hooks in een theme leiden niet tot een tweede kopie.
  2. 2.Staat er al een handmatig geplakt CookiePilot snippet of een andere consentbanner in je theme of in een tagcontainer, verwijder die dan. Twee consentlagen op een pagina vechten om de consentstatus en verstoren de metingen.
  3. 3.Het paneel Storefront status heeft een schakelaar, Enable CookiePilot banner and Consent Mode, zodat je op elk moment kunt controleren of het script wordt geserveerd.

Consent Mode v2 mapping

  1. 1.De module zet de standaardwaarden van Google Consent Mode v2 op denied voordat de bezoeker een keuze maakt. Analytics- en marketingopslag blijven denied totdat er toestemming is.
  2. 2.Accept All verleent alle categorieën. Reject All houdt alle categorieën op denied. Granulaire toestemming verleent precies de categorieën die de bezoeker in de instellingen heeft geselecteerd.
  3. 3.Optionele statische en dynamische scripts die in de module zijn geregistreerd worden op basis van dezelfde categorieën geblokkeerd en vrijgegeven, zodat een script alleen draait als zijn categorie is toegestaan.

Gedrag in multistore

  1. 1.In een multistore-installatie wordt de configuratie per shop opgeslagen. Elke shop koppelt zijn eigen domein en bewaart zijn eigen sleutels.
  2. 2.Een nieuw aangemaakte shop erft de sleutels van de eigenaarshop niet. Open de moduleconfiguratie in de context van elke shop en koppel elke shop apart.

Controleer de dataLayer in de console

Open de shop in een privévenster, open de browserconsole en plak het onderstaande snippet. Voor een keuze hoor je een enkele default-entry met denied-waarden te zien. Na een keuze moet een update-entry met de verleende categorieën volgen.

(window.dataLayer || []).forEach(function (entry) {
  if (entry && entry[0] === 'consent') {
    console.log(entry[1], entry[2]);
  }
});

Trackertests in vijf toestanden

Doorloop elke toestand in een verse privésessie en houd het tabblad Network open. Deze vijf toestanden vormen de acceptatietest waarmee de module zelf wordt geverifieerd.

Voor toestemming: zolang de banner open staat toont het tabblad Network geen analytics- of marketingrequests en worden er geen trackingcookies geschreven.
Alleen analytics: verleen in de granulaire weergave alleen analytics. Analyticsrequests starten, marketingrequests en marketingcookies blijven uit.
Alleen marketing: verleen alleen marketing. Marketingtags mogen vuren terwijl de analytics-opslag denied blijft.
Accept All: de verleende categorieën starten en de dataLayer bevat een consent update met granted-waarden.
Reject All: de shop blijft werken, inclusief winkelwagen en checkout, en trackers blijven stil, ook na een reload.

Meta Pixel en TikTok Pixel lezen Consent Mode niet uit, dus Consent Mode v2 alleen stopt ze niet. Ze moeten worden afgedekt door de autoblocking van de module of via event gating pas na marketingtoestemming worden afgevuurd.

Uitschakelen, verwijderen, opnieuw installeren

Als je de module uitschakelt verdwijnt het CookiePilot script uit de shop. Het domein in je CookiePilot account blijft onaangetast.

Verwijderen wist de lokale secrets en de hooks uit de database van de shop. Het remote domein en het opgeslagen toestemmingsbewijs worden niet verwijderd.

De module opnieuw installeren en hetzelfde domein opnieuw koppelen werkt: de module koppelt weer aan het bestaande domein in plaats van een duplicaat aan te maken.

Problemen oplossen

De banner verschijnt niet na installatie

Leeg de PrestaShop cache onder Geavanceerde instellingen, Prestaties, en purge je CDN als je die gebruikt. Gecachte HTML blijft pagina's serveren die zijn gegenereerd voordat de module actief was.

Twee banners of een tegenstrijdige consentstatus

Verwijder elk handmatig geplakt consentsnippet uit het theme, uit hostingtools en uit tagcontainers. Er mag precies een consentlaag draaien en de module injecteert die al een keer.

Trackers vuren voordat de banner verschijnt

Een theme of andere module met hardcoded GA4, Meta of TikTok laadt buiten de consentlaag om. Verplaats die tags achter de autoblocking van de module of naar een tagopzet die op consent wacht.

Opstellingen met Google Tag Manager

Houd de module als enige consentbron. Laat elke GTM-tag afhangen van de bijbehorende consentstatus of vuur hem pas na de consent update, en plak nooit een tweede CookiePilot loader in de container.

Meta- of TikTok-requests blijven verschijnen

Deze pixels negeren Consent Mode. Controleer of ze onder autoblocking of event gating vallen; een pixel die hardcoded in het theme staat blijft vuren totdat hij achter marketingtoestemming staat.

De module in een echte shop

Installeer de module en test je shop

Download de ZIP, koppel je domein en doorloop de vijf trackertoestanden in een schone sessie. De volledige installatie gebeurt in de back office.