Consentl

Consentl voor Magento 2 / Adobe Commerce

De Consentl-module voor Magento en Adobe Commerce 2.4.6–2.4.8: loader direct na <meta charset>, koppeling met Cookie Restriction Mode, CMS-widgets, Luma en Hyvä.

Loader als eerste in <head>
Ja
Downloaden
consentl-module-consent-1.1.0.zip · Versie 1.1.0 · 201 KB · SHA-256

De module consentl/module-consent verbindt uw Magento-winkel met Consentl. Ze slaat de sitesleutel per website of winkelweergave op, voegt de loader direct na <meta charset> in, koppelt elke keuze aan de Cookie Restriction Mode van Magento en biedt CMS-widgets. Bannerontwerp, teksten in 34 talen, regionale regels en blokkeerregels beheert u in het Consentl-dashboard.

Vereisten

  • Magento Open Source of Adobe Commerce 2.4.6, 2.4.7 of 2.4.8; PHP 8.1 tot en met 8.4, zoals ondersteund door uw Magento-versie.
  • Luma- of Hyvä-thema's; de ingebouwde Full Page Cache en Varnish worden ondersteund.
  • Een Consentl-account (Free-plan beschikbaar).

Installeren

Vanuit de zip (Downloads): pak hem uit in app/code/Consentl/Consent/, zodat composer.json bovenaan in die map staat, en voer daarna uit:

bin/magento module:enable Consentl_Consent
bin/magento setup:upgrade
bin/magento setup:di:compile              # production mode
bin/magento setup:static-content:deploy   # production mode
bin/magento cache:flush

Met Composer: composer require consentl/module-consent zodra het pakket is gepubliceerd, daarna dezelfde opdrachten.

Uw site verbinden

Ga naar Stores → Configuration → Consentl → Cookie Consent en selecteer eerst het bereik (de sleutel en taal kunnen per website of winkelweergave verschillen).

  • Koppelen met Consentl logt u in of maakt een gratis account aan, laat u de site voor het domein van deze winkel kiezen of aanmaken en brengt u terug met de Sitesleutel opgeslagen en Consentl ingeschakeld. De terugkeerlink is alleen geldig in dezelfde beheersessie.
  • Of plak de sleutel (sk_ + 24 tekens) en zet Consentl inschakelen op Ja.

Leeg na het opslaan de Full Page Cache als uw configuratie dat niet automatisch doet.

Instellen

  • Taal van de banner: Automatisch koppelt de locale van de winkelweergave aan de dichtstbijzijnde Consentl-taal (de_AT → de, pt_BR → pt-BR, nb_NO → nb). U kunt ook een taal afdwingen.
  • Koppeling met Cookie Restriction Mode (aanbevolen als u de Google Analytics- of Google Tag-modules van Magento gebruikt):
    1. Zet Stores → Configuration → General → Web → Default Cookie Settings → Cookie Restriction Mode op Yes.
    2. Zet Consentl-keuzes synchroniseren met de cookiebeperkingsmodus op Ja.
    3. Zet De eigen cookiemelding van Magento verbergen op Ja.
    4. Optioneel: Pagina herladen na de eerste toestemming, zodat de Google-modules van Luma op dezelfde paginaweergave starten in plaats van op de volgende.
  • Geavanceerd: laat de positie van de loader op Eerste element in <head> staan.

CMS-widgets (Content → Pages / Blocks → Insert Widget):

Widget Directive
Cookieverklaring {{widget type="Consentl\Consent\Block\Widget\CookieDeclaration"}}
Formulier voor privacyverzoeken {{widget type="Consentl\Consent\Block\Widget\PrivacyRequest"}}
EU-herroepingsformulier {{widget type="Consentl\Consent\Block\Widget\Withdrawal"}}
Link naar cookie-instellingen {{widget type="Consentl\Consent\Block\Widget\PreferencesLink" label="Cookie settings"}}

Elke <a href="#consentl">…</a> in een CMS-blok opent de voorkeuren ook opnieuw.

Controleren of het werkt

  1. Bekijk de paginabron: de loader komt direct na <meta charset>. Op Luma staat de inline RequireJS-configuratie van Magento erboven; die laadt niets.
  2. Met de koppeling aan: vóór enige keuze in een opt-in-regio is de cookie user_allowed_save_cookie niet geplaatst; na het accepteren van een categorie wordt hij voor uw website geplaatst.
  3. Pagina's blijven cachebaar: de uitvoer bevat geen bezoekerspecifieke gegevens.

Content Security Policy

De module staat https://api.consentl.com toe in de CSP-whitelist van Magento en drukt geen inline JavaScript af, dus ze werkt met de checkout-CSP in restrict-modus van 2.4.7+ en met Hyvä CSP-thema's.

Voor ontwikkelaars

Consentl\Consent\ViewModel\Consent::allows('marketing') leest de cookie consentl, alleen voor niet-gecachte contexten (checkout, klantaccount, AJAX). Op gecachte pagina's blokkeert u tags in HTML met <script type="text/plain" data-consentl="marketing">…</script>.

Beperkingen

  • Scripts die een andere extensie boven <meta charset> afdrukt, of inline scripts die een thema vóór de head-inhoud plaatst, worden vóór Consentl uitgevoerd.
  • Magento_GoogleTagManager van Adobe Commerce (closed source) is niet met de koppeling geverifieerd. Gebruik Consent Mode (Pro en hoger, ingeschakeld in het dashboard): Consentl stelt standaardwaarden en updates in, en GTM-tags respecteren die.
  • Magento heeft één enkele opt-in-vlag, dus de koppeling zet die zodra een optionele categorie is toegestaan.
  • Als op Hyvä de eigen cookiemelding van Hyvä nog verschijnt, verwijder die dan in uw thema met <referenceBlock name="cookie_notices" remove="true"/> in Magento_Cookie/layout/default.xml.
  • Bij het verwijderen blijven de configuratiewaarden onder consentl/* in core_config_data staan; verwijder ze zo nodig met bin/magento config:delete.

Vastgelopen? Schrijf naar support@consentl.com — wij antwoorden op werkdagen in het Engels.