Consentl per Shopware 6
Il plugin Consentl per Shopware 6.6 e 6.7 inserisce il banner per primo nel <head>, sostituisce la barra dei cookie di Shopware e sincronizza i gruppi di cookie.
- Loader per primo nel <head>
- Sì
- Scarica
- consentl-shopware-1.1.1.zip · Versione 1.1.1 · 164 KB · SHA-256
Il plugin Consentl collega il suo negozio Shopware a Consentl. Memorizza la chiave del sito per canale
di vendita, stampa il loader come primo elemento del <head>, sostituisce la barra dei cookie di
Shopware e trasmette ogni scelta ai gruppi di cookie di Shopware, così la lista dei desideri, gli
elementi YouTube, Google Analytics e altre funzionalità la seguono. Testi, colori, regioni e
registrazioni del consenso si gestiscono nel pannello di controllo Consentl.
Requisiti
- Shopware 6.6 o 6.7, PHP 8.2 o successivo.
- Un account Consentl (piano Free disponibile).
Installazione
Dallo zip (Download):
- Nell'amministrazione, vada su Extensions → My extensions → Upload extension e scelga lo zip, oppure esegua sul server:
bin/console plugin:zip-import consentl-shopware-<version>.zip
bin/console plugin:install --activate ConsentlConsent
bin/console cache:clear
- Installi e attivi Consentl, poi svuoti la cache.
Lo script storefront del plugin viene copiato in public/bundles/consentlconsent/ all'attivazione;
esegua bin/console assets:install se effettua il deploy senza il ciclo di vita del plugin.
Collegare il sito
Apra Extensions → My extensions → Consentl → Configure. Le impostazioni si applicano per canale di vendita ed ereditano da "All Sales Channels".
- Connect with Consentl effettua l'accesso, le consente di scegliere o creare il sito e salva la chiave per il canale di vendita selezionato.
- Oppure incolli la chiave del sito (
sk_+ 24 caratteri) dal pannello di controllo e salvi.
Configurazione
| Impostazione | Predefinito | Note |
|---|---|---|
| Show the Consentl banner | attivo | Disattivato = il loader non viene stampato; la chiave viene mantenuta |
| Replace the Shopware cookie bar | attivo | Nasconde la barra dei cookie e la finestra delle impostazioni dei cookie di Shopware |
| Sync consent with Shopware cookie groups | attivo | Veda sotto |
| Category for unknown cookie groups | Marketing | Per i gruppi aggiunti da altre estensioni che non possono essere associati |
| Banner language | Automatic | La lingua del dominio del canale di vendita (de-AT → de) |
Gruppi di cookie. I gruppi di Shopware corrispondono alle categorie di Consentl: tecnicamente
necessari → necessari, funzionalità di comfort → preferenze, statistiche → statistiche, marketing →
marketing. Gli altri gruppi vengono associati tramite parole chiave o usano la categoria di ripiego.
Quando un visitatore decide, il plugin scrive gli stessi cookie che scriverebbe Shopware
(wishlist-enabled, youtube-video, google-analytics-enabled, …) e annuncia la modifica, così le
estensioni in ascolto delle modifiche al consenso reagiscono senza ricaricare la pagina. I link alle
impostazioni dei cookie di Shopware aprono le preferenze di Consentl.
Widget. Il blocco Shopping Experiences Consentl (categoria Text) con gli elementi cookie declaration, privacy request form e withdrawal form. Nei temi può usare anche gli include Twig:
{% sw_include '@ConsentlConsent/storefront/consentl/widget.html.twig' with { consentlType: 'declaration' } %}
{% sw_include '@ConsentlConsent/storefront/consentl/settings-link.html.twig' %}
consentlType può essere declaration, request o withdrawal.
Verificare che funzioni
- Visualizzi il sorgente della pagina del suo storefront: il
<head>inizia con<script src="https://api.consentl.com/v1/loader.js?k=…&l=de">. - La barra dei cookie di Shopware non compare più; compare invece il banner di Consentl.
- Rifiuti tutto: i cookie
google-analytics-enabled,wishlist-enabledeyoutube-videonon vengono impostati e Google Analytics non si carica. Accetti le statistiche:google-analytics-enabled=1viene impostato senza ricaricare la pagina.
Per gli sviluppatori
In Twig, {% if consentl_allowed('marketing') %}…{% endif %} controlla una decisione memorizzata.
Vede solo il cookie consentl (non i valori predefiniti della regione) e viene valutato quando la
pagina viene generata, quindi le pagine provenienti dalla cache HTTP di Shopware non vengono rivalutate.
Preferisca il blocco lato client:
<script type="text/plain" data-consentl="analytics">…</script>.
Limitazioni
- "Keep Shopware cookie bar" (sostituzione disattivata) esegue due interfacce di consenso; la usi solo per una fase di transizione.
- Shopware 6.7 include un proprio modulo di richiesta di revoca (recesso). Usi il modulo di recesso di Shopware oppure quello di Consentl, non entrambi.
- Il flusso di collegamento usa l'host dell'amministrazione come dominio; aggiunga i domini del suo storefront nel pannello di controllo Consentl se sono diversi.
Guide correlate
Serve aiuto? Scriva a support@consentl.com: rispondiamo in inglese nei giorni lavorativi.