Consentl

Consentl per Magento 2 / Adobe Commerce

Il modulo Consentl per Magento e Adobe Commerce 2.4.6–2.4.8: loader subito dopo <meta charset>, collegamento al Cookie Restriction Mode, widget CMS. Luma e Hyvä.

Loader per primo nel <head>
Sì
Scarica
consentl-module-consent-1.1.0.zip · Versione 1.1.0 · 201 KB · SHA-256

Il modulo consentl/module-consent collega il suo negozio Magento a Consentl. Memorizza la chiave del sito per sito web o vista negozio, inserisce il loader subito dopo <meta charset>, collega ogni scelta al Cookie Restriction Mode di Magento e fornisce widget CMS. Il design del banner, i testi in 34 lingue, le regole per regione e le regole di blocco si gestiscono nel pannello di controllo Consentl.

Requisiti

  • Magento Open Source o Adobe Commerce 2.4.6, 2.4.7 o 2.4.8; da PHP 8.1 a 8.4, secondo quanto supportato dalla sua versione di Magento.
  • Temi Luma o Hyvä; sono supportati la Full Page Cache integrata e Varnish.
  • Un account Consentl (piano Free disponibile).

Installazione

Dallo zip (Download): lo decomprima in app/code/Consentl/Consent/, in modo che composer.json si trovi al primo livello di quella cartella, poi esegua:

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

Con Composer: composer require consentl/module-consent una volta pubblicato il pacchetto, poi gli stessi comandi.

Collegare il sito

Vada su Stores → Configuration → Consentl → Cookie Consent e selezioni prima l'ambito (la chiave e la lingua possono variare per sito web o vista negozio).

  • Connect to Consentl effettua l'accesso o crea un account gratuito, le consente di scegliere o creare il sito per il dominio di questo negozio e la riporta indietro con la Site key salvata e Consentl attivato. Il link di ritorno è valido solo nella stessa sessione di amministrazione.
  • Oppure incolli la chiave (sk_ + 24 caratteri) e imposti Enable Consentl su Yes.

Dopo il salvataggio svuoti la Full Page Cache, se la sua configurazione non lo fa automaticamente.

Configurazione

  • Banner language: Automatic associa la lingua della vista negozio alla lingua Consentl più vicina (de_AT → de, pt_BR → pt-BR, nb_NO → nb). Può anche imporre una lingua.
  • Collegamento al Cookie Restriction Mode (consigliato se usa i moduli Google Analytics o Google Tag di Magento):
    1. Imposti Stores → Configuration → General → Web → Default Cookie Settings → Cookie Restriction Mode su Yes.
    2. Imposti Sync Consentl decisions to Cookie Restriction Mode su Yes.
    3. Imposti Hide Magento's native cookie notice su Yes.
    4. Facoltativo: Reload the page after the first opt-in, così i moduli Google di Luma si avviano nella stessa visualizzazione di pagina invece che nella successiva.
  • Advanced: mantenga la posizione del loader First element in <head>.

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

Widget Direttiva
Dichiarazione dei cookie {{widget type="Consentl\Consent\Block\Widget\CookieDeclaration"}}
Modulo per le richieste sui dati personali {{widget type="Consentl\Consent\Block\Widget\PrivacyRequest"}}
Modulo di recesso UE {{widget type="Consentl\Consent\Block\Widget\Withdrawal"}}
Link alle impostazioni dei cookie {{widget type="Consentl\Consent\Block\Widget\PreferencesLink" label="Cookie settings"}}

Anche qualsiasi <a href="#consentl">…</a> in un blocco CMS riapre le preferenze.

Verificare che funzioni

  1. Visualizzi il sorgente della pagina: il loader si trova subito dopo <meta charset>. Su Luma, la configurazione RequireJS inline di Magento si trova sopra di esso; non carica nulla.
  2. Con il collegamento attivo: prima di qualsiasi scelta in una regione opt-in, il cookie user_allowed_save_cookie non è impostato; dopo l'accettazione di una categoria viene impostato per il suo sito web.
  3. Le pagine restano memorizzabili nella cache: l'output non contiene dati specifici del visitatore.

Content Security Policy

Il modulo consente https://api.consentl.com nella whitelist CSP di Magento e non stampa JavaScript inline, quindi funziona con la CSP in modalità restrittiva del checkout dalla versione 2.4.7 e con i temi CSP di Hyvä.

Per gli sviluppatori

Consentl\Consent\ViewModel\Consent::allows('marketing') legge il cookie consentl, solo per i contesti non memorizzati nella cache (checkout, account cliente, AJAX). Nelle pagine memorizzate nella cache, condizioni i tag nell'HTML con <script type="text/plain" data-consentl="marketing">…</script>.

Limitazioni

  • Gli script che un'altra estensione stampa sopra <meta charset>, o gli script inline che un tema colloca prima del contenuto del head, vengono eseguiti prima di Consentl.
  • Magento_GoogleTagManager di Adobe Commerce (codice chiuso) non è stato verificato con il collegamento. Usi Consent Mode (dal piano Pro in su, attivato nel pannello di controllo): Consentl imposta valori predefiniti e aggiornamenti, e i tag GTM li rispettano.
  • Magento ha un unico flag di opt-in, quindi il collegamento lo imposta quando viene concessa qualsiasi categoria facoltativa.
  • Su Hyvä, se compare ancora l'avviso sui cookie di Hyvä, lo rimuova nel suo tema con <referenceBlock name="cookie_notices" remove="true"/> in Magento_Cookie/layout/default.xml.
  • La disinstallazione lascia i valori di configurazione in consentl/* in core_config_data; li elimini con bin/magento config:delete se necessario.

Serve aiuto? Scriva a support@consentl.com: rispondiamo in inglese nei giorni lavorativi.