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. De module ondersteunt PrestaShop 8.x en 9.x.

Vereisten en ondersteunde versies

  • De module ondersteunt PrestaShop 8.x en 9.x.
  • 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

Download de officiële CookiePilot-installatie-ZIP, sla deze op en upload deze naar PrestaShop zonder hem uit te pakken.

Download de ZIP

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 shop PrestaShop 8.x of 9.x gebruikt 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, ga terug naar PrestaShop Back Office, open de configuratie van CookiePilot CMP opnieuw en log zo nodig in met het geverifieerde account.
  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 een CookiePilot-script in de head van elke shoppagina en gebruikt een vroege modulehook. Scripts die eerder rechtstreeks in het theme zijn gezet, kunnen nog steeds eerst laden. Stel ze daarom zo in dat CookiePilot-autoblocking ze blokkeert, of laat ze in GTM op toestemming wachten.
  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.

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: nadat alle toestemmingen zijn geaccepteerd, mogen analytics- en marketingtools draaien volgens de configuratie van de shop.
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 vast in de code opgenomen GA4, Meta of TikTok kan buiten de consentlaag laden. Configureer de automatische blokkering van CookiePilot om die tags te blokkeren of af te dekken, of configureer ze in GTM zodat ze alleen worden uitgevoerd na de vereiste toestemming.

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.

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.