Consentl voor Shopware 6
De Consentl-plugin voor Shopware 6.6 en 6.7 plaatst de banner als eerste in <head>, vervangt de Shopware-cookiebalk en synchroniseert cookiegroepen met elke keuze.
- Loader als eerste in <head>
- Ja
- Downloaden
- consentl-shopware-1.1.1.zip · Versie 1.1.1 · 164 KB · SHA-256
De Consentl-plugin verbindt uw Shopware-winkel met Consentl. Hij slaat de sitesleutel per
verkoopkanaal op, drukt de loader af als eerste element van <head>, vervangt de cookiebalk van Shopware en
geeft elke keuze door aan de cookiegroepen van Shopware, zodat het verlanglijstje, YouTube-elementen, Google Analytics
en andere functies die keuze volgen. Teksten, kleuren, regio's en toestemmingsregistraties beheert u in het
Consentl-dashboard.
Vereisten
- Shopware 6.6 of 6.7, PHP 8.2 of later.
- Een Consentl-account (Free-plan beschikbaar).
Installeren
Vanuit de zip (Downloads):
- Ga in de administratie naar Extensies → Mijn extensies → Extensie uploaden (Engels: "Extensions → My extensions → Upload extension") en kies de zip, of voer op de server uit:
bin/console plugin:zip-import consentl-shopware-<version>.zip
bin/console plugin:install --activate ConsentlConsent
bin/console cache:clear
- Installeer en activeer Consentl en leeg daarna de cache.
Het storefrontscript van de plugin wordt bij het activeren naar public/bundles/consentlconsent/ gekopieerd; voer
bin/console assets:install uit als u implementeert zonder de levenscyclus van de plugin.
Uw site verbinden
Open Extensies → Mijn extensies → Consentl → Configureren. Instellingen gelden per verkoopkanaal en erven van "Alle verkoopkanalen".
- Verbinden met Consentl logt u in, laat u de site kiezen of aanmaken en slaat de sleutel op voor het geselecteerde verkoopkanaal.
- Of plak de sitesleutel (
sk_+ 24 tekens) uit het dashboard en sla op.
Instellen
| Instelling | Standaard | Opmerkingen |
|---|---|---|
| Consentl-banner tonen | aan | Uit = de loader wordt niet afgedrukt; de sleutel blijft bewaard |
| Shopware-cookiebalk vervangen | aan | Verbergt de cookiebalk en het venster met cookie-instellingen van Shopware |
| Toestemming synchroniseren met Shopware-cookiegroepen | aan | Zie hieronder |
| Categorie voor onbekende cookiegroepen | Marketing | Voor groepen die door andere extensies zijn toegevoegd en niet kunnen worden gekoppeld |
| Bannertaal | Automatisch | De taal van het domein van het verkoopkanaal (de-AT → de) |
Cookiegroepen. De groepen van Shopware komen overeen met Consentl-categorieën: technisch vereist → noodzakelijk,
comfortfuncties → voorkeuren, statistieken → analyse, marketing → marketing. Andere groepen worden
op trefwoord gekoppeld of gebruiken de reservecategorie. Wanneer een bezoeker beslist, schrijft de plugin dezelfde
cookies die Shopware zelf zou schrijven (wishlist-enabled, youtube-video,
google-analytics-enabled, …) en kondigt de wijziging aan, zodat extensies die naar toestemmingswijzigingen
luisteren zonder herladen reageren. Links naar de cookie-instellingen van Shopware openen de Consentl-voorkeuren.
Widgets. Shopping Experiences-blok Consentl (categorie Tekst) met de elementen cookieverklaring, formulier voor privacyverzoeken en herroepingsformulier. In thema's kunt u ook de Twig-includes gebruiken:
{% sw_include '@ConsentlConsent/storefront/consentl/widget.html.twig' with { consentlType: 'declaration' } %}
{% sw_include '@ConsentlConsent/storefront/consentl/settings-link.html.twig' %}
consentlType kan declaration, request of withdrawal zijn.
Controleren of het werkt
- Bekijk de paginabron van uw storefront:
<head>begint met<script src="https://api.consentl.com/v1/loader.js?k=…&l=de">. - De cookiebalk van Shopware verschijnt niet meer; de Consentl-banner wel.
- Alles weigeren: de cookies
google-analytics-enabled,wishlist-enabledenyoutube-videoworden niet geplaatst en Google Analytics laadt niet. Analyse accepteren:google-analytics-enabled=1wordt zonder herladen geplaatst.
Voor ontwikkelaars
In Twig controleert {% if consentl_allowed('marketing') %}…{% endif %} een opgeslagen beslissing. Het ziet alleen
de cookie consentl (niet de standaardwaarden van de regio) en wordt geëvalueerd wanneer de pagina wordt gerenderd, dus pagina's uit
de HTTP-cache van Shopware worden niet opnieuw geëvalueerd. Geef de voorkeur aan blokkering aan de clientkant:
<script type="text/plain" data-consentl="analytics">…</script>.
Beperkingen
- De Shopware-cookiebalk behouden (vervangen uit) laat twee toestemmingsinterfaces draaien; gebruik dit alleen voor een overgangsperiode.
- Shopware 6.7 bevat een eigen formulier voor herroepingsverzoeken. Gebruik het herroepingsformulier van Shopware of dat van Consentl, niet beide.
- De verbindingsprocedure gebruikt de host van de administratie als domein; voeg uw storefrontdomeinen toe in het Consentl-dashboard als die verschillen.
Gerelateerde handleidingen
Vastgelopen? Schrijf naar support@consentl.com — wij antwoorden op werkdagen in het Engels.