Tutta la documentazione

Cookies Revolution — Documentazione

Cookies Revolution è un gestore del consenso cookie basato su categorie per PrestaShop. Ti aiuta a raccogliere le scelte dei visitatori, bloccare gli script di tracciamento opzionali fino al consenso, conservare i log del consenso e inviare i segnali Google Consent Mode v2.

Funzionalità

  • Consenso per categoria. I visitatori possono accettare tutti i cookie, rifiutare i cookie opzionali o scegliere il consenso categoria per categoria.
  • Gruppi cookie predefiniti. Il modulo installa le categorie necessari, funzionali, analytics e marketing con nomi e descrizioni visibili ai visitatori.
  • Regole di blocco degli script. Gli script esterni e gli script inline corrispondenti vengono riscritti fino a quando la categoria opzionale collegata non viene accettata.
  • Protezione dinamica degli script. Il JavaScript front-office controlla gli script aggiunti dinamicamente e blocca gli script di tracciamento corrispondenti prima del consenso.
  • Google Consent Mode v2. Il modulo emette segnali Consent Mode negati per impostazione predefinita e li aggiorna quando il visitatore salva le proprie scelte.
  • Log del consenso. Le scelte salvate possono essere registrate con hash del visitatore, hash dell'IP, hash dello user-agent, versione del consenso, origine e data.
  • Esportazione CSV. La schermata del log del consenso include un'esportazione CSV per i record di audit.
  • Scanner dei cookie. Lo scanner rileva gli header Set-Cookie e semplici assegnazioni document.cookie, quindi ti consente di categorizzare i nuovi cookie.
  • Cookie policy generata. Il controller delle impostazioni può creare o aggiornare manualmente una pagina CMS di cookie policy partendo dalle categorie e dai cookie configurati.
  • Design personalizzato del banner. Puoi modificare posizione del banner, colori, testo, overlay, animazione, pulsante flottante e CSS personalizzato.
  • Link nell'account cliente. Un link “Cookie Settings” viene aggiunto all'area account cliente, così i visitatori possono modificare le scelte in seguito.
Cookies Revolution — Consent banner preferences Cookies Revolution — Admin dashboard

Opzioni di configurazione

  • Enable Module. Attiva o disattiva banner front-office, pannello preferenze, asset, link account e funzionalità di consenso; valore predefinito: 1.
  • Default Consent. Imposta lo stato iniziale prima che il visitatore scelga: denied per opt-in o granted per opt-out; valore predefinito: denied.
  • Cookie Expiry. Imposta per quanto tempo mprcr_consent e mprcr_version vengono memorizzati nel browser del visitatore; valore predefinito: 365.
  • Re-consent after. Memorizza un intervallo in giorni inserito nel Back Office; l'attuale nuovo consenso front-end è guidato dalle modifiche della versione del consenso, non da questo valore di giorni trascorsi; valore predefinito: 0.
  • Re-consent on cookie list change. Mostra di nuovo il banner quando le categorie attive o i cookie attivi cambiano e la versione memorizzata è obsoleta; valore predefinito: 1.
  • Enable Script Blocking. Abilita la riscrittura server-side degli script e le regole di blocco client-side; valore predefinito: 1.
  • Enable GCM v2. Emette e aggiorna i segnali Google Consent Mode v2; valore predefinito: 1.
  • wait_for_update. Imposta il valore Google Consent Mode wait_for_update in millisecondi; valore predefinito: 500.
  • Enable Consent Logging. Invia le scelte di consenso salvate al front controller del modulo e le memorizza nel log del consenso; valore predefinito: 1.
  • Log Retention. Imposta il numero di giorni usato dall'azione di pulizia per i vecchi log del consenso; valore predefinito: 365.
  • Auto-Update CMS Page. Memorizza il valore CMS_AUTO_UPDATE dal form impostazioni; il sorgente attuale non usa questo valore per aggiornare automaticamente la pagina CMS; valore predefinito: 1.
  • Custom Policy URL. Sostituisce il link alla pagina CMS di policy generata nel banner e nel pannello preferenze; valore predefinito: ``.
  • Automatic Cookie Scanning. Esegue uno scanner in background dai caricamenti delle pagine admin quando l'intervallo di scansione è scaduto; valore predefinito: 1.
  • Scan Interval. Imposta l'intervallo dello scanner automatico in ore; valore predefinito: 24.
  • Consent Version. Hash interno di 8 caratteri generato da categorie attive e cookie attivi; valore predefinito: ``.
  • Generated CMS Page ID. ID interno della pagina CMS di cookie policy generata; valore predefinito: 0.
  • Category name. Etichetta della categoria visibile ai visitatori nel pannello preferenze; categorie predefinite: Strictly Necessary, Functional, Analytics & Performance, Marketing & Advertising.
  • Category description. Spiegazione visibile ai visitatori sotto ogni nome di categoria; valore predefinito: installata con le quattro categorie predefinite.
  • Category system name. Identificatore interno usato nei cookie di consenso e in JavaScript, ad esempio analytics; valore predefinito: necessary, functional, analytics, marketing.
  • Category required. Rende una categoria sempre attiva e non modificabile dai visitatori; valore predefinito: necessary è 1, le categorie opzionali sono 0.
  • Category active. Mostra o nasconde la categoria nel pannello preferenze del visitatore; valore predefinito: 1.
  • Category icon. Memorizza il nome di un'icona come shield, settings, chart o megaphone; valore predefinito: installato per ogni categoria predefinita.
  • GCM category mappings. Associa ogni categoria a segnali Google come analytics_storage, ad_storage, ad_user_data, ad_personalization, functionality_storage, personalization_storage e security_storage; valore predefinito: necessary mappa a security_storage, functional a functionality_storage, analytics a analytics_storage, marketing ai segnali pubblicitari e di personalizzazione.
  • Cookie Name. Nome cookie esatto o nome in stile wildcard mostrato nell'elenco cookie, come _ga o _ga_*; valore predefinito: vengono installati cookie comuni di PrestaShop, Google, Facebook, DoubleClick e Bing.
  • Cookie Category. Assegna ogni cookie registrato a una categoria; valore predefinito: installato dall'elenco dei cookie conosciuti.
  • Cookie Provider. Indica il servizio che imposta il cookie; valore predefinito: nomi provider installati come PrestaShop, Google Analytics, Facebook e Microsoft Bing.
  • Cookie Purpose. Testo multilingua sullo scopo del cookie visualizzato nel pannello preferenze e nella pagina policy generata; valore predefinito: installato per i cookie conosciuti.
  • Duration Value. Durata numerica del cookie mostrata ai visitatori; valore predefinito: installata dai dati dei cookie conosciuti quando disponibile.
  • Duration Unit. Unità per la durata del cookie: session, minutes, hours, days, months o years; valore predefinito: installata dai dati dei cookie conosciuti.
  • Is Regex Pattern. Tratta il pattern del cookie come corrispondenza regex; valore predefinito: 1 per i valori wildcard predefiniti come _ga_*, altrimenti 0.
  • Cookie Pattern (Regex). Regex usata per abbinare cookie raggruppati come ^_ga_.*$; valore predefinito: generata per i valori wildcard predefiniti.
  • Cookie Active. Include o esclude un cookie dall'elenco pubblico e dalla versione del consenso; valore predefinito: 1.
  • Script rule category. Assegna una regola di blocco a una categoria opzionale; valore predefinito: vengono installate regole analytics, marketing e functional.
  • Rule Type. Sceglie url_pattern per la corrispondenza dello script src o script_content per la corrispondenza degli script inline; valore predefinito: installato per ogni regola.
  • Pattern (Regex). Regex usata per abbinare l'URL dello script o il contenuto dello script inline; valore predefinito: i pattern installati coprono Google Analytics, GTM, Clarity, Hotjar, Meta, TikTok, Bing, LinkedIn e widget chat comuni.
  • Rule Description. Nota Back Office per la regola di blocco; valore predefinito: descrizioni installate come Google Tag Manager o Facebook SDK.
  • Rule Active. Abilita o disabilita una singola regola di blocco; valore predefinito: 1.
  • Banner Position. Controlla dove appare il banner; valore predefinito: bottom.
  • Banner Layout. Valore layout memorizzato per il banner; valore predefinito: bar.
  • Preferences Panel Layout. Apre le preferenze come modal, slide-right o slide-left; valore predefinito: modal.
  • Animation. Usa slide, fade o none; valore predefinito: slide.
  • Floating Button Position. Posiziona il pulsante di riapertura in bottom-left o bottom-right; valore predefinito: bottom-left.
  • Floating Button Enabled. Mostra il pulsante flottante “Cookie Settings” dopo il consenso; valore predefinito: 1.
  • Banner Background. Imposta il colore di sfondo del banner; valore predefinito: #232323.
  • Banner Text. Imposta il colore del testo del banner; valore predefinito: #f5f5f5.
  • Accept Button Background. Imposta lo sfondo del pulsante di accettazione; valore predefinito: #2196f3.
  • Accept Button Text. Imposta il colore del testo del pulsante di accettazione; valore predefinito: #ffffff.
  • Reject Button Background. Imposta lo sfondo del pulsante di rifiuto; valore predefinito: transparent.
  • Reject Button Text. Valore predefinito al momento dell'installazione sullo sfondo scuro del banner del modulo: #b0b0b0.
  • Customize Button Background. Imposta lo sfondo del pulsante di personalizzazione; valore predefinito: transparent.
  • Customize Button Text. Valore predefinito al momento dell'installazione sullo sfondo scuro del banner del modulo: #b0b0b0.
  • Preferences Background. Imposta lo sfondo del pannello preferenze; valore predefinito: #ffffff.
  • Preferences Text. Imposta il colore del testo del pannello preferenze; valore predefinito: #333333.
  • Toggle Active. Imposta il colore dello switch attivo; valore predefinito: #2196f3.
  • Toggle Inactive. Imposta il colore dello switch inattivo; valore predefinito: #cccccc.
  • Floating Button Background. Imposta lo sfondo del pulsante flottante; valore predefinito: #2196f3.
  • Floating Button Icon. Imposta il colore dell'icona del pulsante flottante; valore predefinito: #ffffff.
  • Banner Title. Titolo multilingua del banner; valore predefinito: We respect your privacy.
  • Banner Message. Paragrafo multilingua del banner; valore predefinito: We use cookies to enhance your browsing experience, serve personalized content, and analyze our traffic. By clicking "Accept All", you consent to our use of cookies.
  • Accept Button. Testo multilingua del pulsante accetta tutto; valore predefinito: Accept All.
  • Reject Button. Testo multilingua del pulsante rifiuta tutto; valore predefinito: Reject All.
  • Customize Button. Testo multilingua del pulsante preferenze; valore predefinito: Customize.
  • Preferences Title. Titolo multilingua del pannello preferenze; valore predefinito: Cookie Preferences.
  • Preferences Description. Spiegazione multilingua delle preferenze; valore predefinito: Choose which cookies you want to allow. You can change these settings at any time. However, blocking some types of cookies may impact your experience of the site.
  • Save Button. Testo multilingua del pulsante salva preferenze; valore predefinito: Save Preferences.
  • Accept All (in prefs). Testo multilingua del pulsante accetta tutto dentro le preferenze; valore predefinito: Accept All.
  • Floating Button Label. Etichetta multilingua e tooltip per il pulsante flottante; valore predefinito: Cookie Settings.
  • Policy Link Text. Etichetta multilingua del link alla policy; valore predefinito: Cookie Policy.
  • Floating Button Size (px). Imposta larghezza e altezza del pulsante flottante; valore predefinito: 48.
  • Border Radius (px). Imposta gli angoli arrotondati per banner, pannello e pulsanti; valore predefinito: 12.
  • Font Size (px). Imposta la dimensione del font per banner e preferenze; valore predefinito: 14.
  • Font Family. Aggiunge una font-family personalizzata prima del fallback di sistema; valore predefinito: ``.
  • Button Border Color. Imposta il colore del bordo per i pulsanti rifiuta e personalizza; valore predefinito: ``.
  • Show Overlay. Mostra un overlay sulla pagina dietro il banner o il pannello preferenze; valore predefinito: 1.
  • Overlay Color. Imposta il colore dell'overlay; valore predefinito: rgba(0,0,0,0.5).
  • Show Close (X) Button. Aggiunge un pulsante di chiusura al banner; valore predefinito: 0.
  • Close Button Action. Controlla cosa succede quando il visitatore clicca il pulsante X: reject salva il rifiuto e impedisce al banner di riapparire, accept concede tutto il consenso, oppure dismiss nasconde il banner senza salvare il consenso, quindi riapparirà alla visita successiva; valore predefinito: reject.
  • Consent Wall. Sfoca la pagina, centra il banner come modale e blocca lo scrolling fino a quando il visitatore accetta, rifiuta o personalizza il consenso; valore predefinito: 0.
  • Custom CSS. Memorizza CSS aggiuntivo stampato con il design del modulo; valore predefinito: ``.
Cookies Revolution — Admin cookie scanner Cookies Revolution — Admin design

Esempi di personalizzazione

Usa la schermata delle regole script per bloccare uno script di tracciamento tramite URL fino a quando viene concesso il consenso analytics:

Category: analytics
Rule Type: url_pattern
Pattern (Regex): googletagmanager\.com/gtag/js
Description: Google gtag.js
Active: 1

Usa una regola script-content quando il codice di tracciamento è inline:

Category: marketing
Rule Type: script_content
Pattern (Regex): fbq\s*\(
Description: Inline Facebook Pixel
Active: 1

Il modulo riscrive gli script esterni corrispondenti in questo modo fino a quando la categoria viene accettata:

<script type="text/plain"
        data-cookiecategory="analytics"
        data-original-src="https://www.googletagmanager.com/gtag/js?id=G-XXXX">
</script>

Il cookie di consenso usa valori di categoria compatti, utili quando un altro script personalizzato deve controllare lo stato del browser:

mprcr_consent=necessary:1|functional:0|analytics:1|marketing:0
mprcr_version=1a2b3c4d

Usa l'API JavaScript pubblica in un tema o in un modulo personalizzato per controllare lo stato attuale del browser e ascoltare le modifiche di consenso salvate:

function loadAnalyticsCode() {
  // Load analytics-dependent code here.
}

if (window.MPRCR && window.MPRCR.isGranted('analytics')) {
  loadAnalyticsCode();
}

document.addEventListener('mprcr:consent', function (event) {
  if (event.detail && event.detail.analytics) {
    loadAnalyticsCode();
  }
});

Apri il pannello preferenze da un tuo link nel footer:

<a href="#" onclick="event.preventDefault(); window.MPRCR && window.MPRCR.showPreferences();">
  Cookie Settings
</a>

Hook CSS front-office utili per il campo Custom CSS:

.mprcr-banner__inner {
  max-width: 980px;
  margin: 0 auto;
}

.mprcr-btn--accept {
  font-weight: 700;
}

.mprcr-category__desc {
  line-height: 1.6;
}

.mprcr-floating {
  box-shadow: 0 4px 14px rgba(0,0,0,.2);
}

Una configurazione opt-in UE tipica usa questi valori:

DEFAULT_CONSENT = denied
SCRIPT_BLOCKING = 1
GCM_ENABLED = 1
LOG_ENABLED = 1
RECONSENT_ON_CHANGE = 1
Cookies Revolution — Admin cookie catalog Cookies Revolution — Admin integrity

Installazione

  1. Nel Back Office di PrestaShop, vai su Modules → Module Manager.
  2. Clicca Upload a module.
  3. Seleziona il file ZIP di Cookies Revolution.
  4. Clicca Install.
  5. Apri la pagina di configurazione del modulo.
  6. Controlla le categorie predefinite, i cookie registrati e le regole di blocco degli script.
  7. Esegui lo scanner dei cookie e categorizza eventuali cookie in sospeso.
  8. Controlla testo del banner, design, log del consenso e pagina policy prima di andare online.

Solo un modulo di consenso cookie mypresta.rocks può essere attivo alla volta. Se mprcookiebanner è già attivo, Cookies Revolution non verrà installato finché l'altro modulo cookie non viene disabilitato o rimosso.

Cookies Revolution — Admin banner design Cookies Revolution — Admin scanner

Come funziona

Quando arriva un visitatore, Cookies Revolution prepara uno stato di consenso predefinito. Se Google Consent Mode v2 è abilitato, il modulo stampa nell'header della pagina un segnale di consenso negato per impostazione predefinita, con security_storage concesso.

Il banner viene caricato da un template inerte e mostrato dopo che il visitatore interagisce con la pagina. Il visitatore può accettare tutto, rifiutare le categorie opzionali oppure aprire il pannello preferenze e scegliere per categoria. Dopo il salvataggio di una scelta, il modulo memorizza mprcr_consent e mprcr_version nel browser, aggiorna Google Consent Mode, attiva gli script appena consentiti e, opzionalmente, scrive una voce nel log del consenso.

Il visitatore può riaprire in seguito le preferenze tramite il pulsante cookie flottante, il link “Cookie Settings” nell'account cliente o un link personalizzato che usa window.MPRCR.showPreferences().

Cookies Revolution — Admin categories list Cookies Revolution — Admin script rules

Limiti trasparenti

  • Questo modulo ti aiuta a raccogliere e memorizzare le scelte sui cookie, ma non è consulenza legale. Il testo della policy, le scelte delle categorie e la configurazione del tracciamento devono comunque rispettare i tuoi requisiti legali.
  • Lo scanner rileva i cookie dagli header Set-Cookie e dal codice semplice document.cookie = "name=value" durante la scansione. I cookie creati dopo l'interazione dell'utente, dopo il consenso o dentro codice complesso di terze parti possono richiedere una revisione manuale.
  • Gli script già eseguiti prima della revoca del consenso non possono essere “annullati” da JavaScript. Il modulo può eliminare i cookie registrati alla revoca e impedire l'esecuzione futura degli script corrispondenti.
  • Re-consent after viene memorizzato dal form impostazioni, ma l'attuale controllo di nuovo consenso front-end si basa sulle modifiche della versione del consenso.
  • Il contenuto della policy CMS generata si basa sulle categorie e sui cookie registrati nel modulo. Le azioni di creazione e aggiornamento sono azioni manuali del Back Office; lo switch memorizzato CMS_AUTO_UPDATE non viene usato dal sorgente attuale per mantenere la pagina sincronizzata.
  • Se usi una pagina legale personalizzata, inseriscila in Custom Policy URL.
  • L'esportazione del log del consenso include una colonna country_code, ma l'attuale metodo di logging non la popola.
Cookies Revolution — Admin consent log

Domande frequenti

Qual è la differenza tra questo modulo e Lightweight Cookie Banner?
Lightweight Cookie Banner serve per un avviso più semplice accetta/rifiuta. Cookies Revolution aggiunge preferenze per categoria, regole di blocco degli script, log del consenso, scansione dei cookie, contenuto policy generato e Google Consent Mode v2.

Il blocco degli script può danneggiare il mio store?
Può succedere se script essenziali per checkout, login, carrello, pagamento o sicurezza vengono assegnati a categorie di tracciamento opzionali. Tieni gli script critici per lo store fuori dalle regole di blocco opzionali o in una categoria obbligatoria.

Il modulo blocca Google Analytics prima del consenso?
Sì, quando lo script Google pertinente corrisponde a una regola analytics attiva e il blocco degli script è abilitato. Il modulo invia anche i valori predefiniti di Google Consent Mode prima del consenso.

I visitatori possono modificare le scelte in seguito?
Sì. Possono riaprire le preferenze tramite il pulsante cookie flottante, il link nell'account cliente, un link personalizzato o l'API JavaScript pubblica.

Posso creare categorie personalizzate?
Sì. Puoi aggiungere categorie, scrivere nomi e descrizioni multilingua, scegliere se sono obbligatorie e mapparle ai segnali Google Consent Mode.

Il modulo elimina i cookie dopo il rifiuto di una categoria?
Quando un visitatore salva le preferenze e revoca una categoria precedentemente concessa, lo script front-office tenta di eliminare i cookie registrati per quella categoria.

Posso esportare i record di consenso?
Sì. La schermata del log del consenso include un'esportazione CSV con hash visitatore, hash IP, dati del consenso, versione, origine, colonna codice paese e data. L'attuale metodo di logging non popola country_code.

Devo raccogliere di nuovo il consenso dopo aver aggiunto cookie?
Sì, se il nuovo consenso al cambiamento è abilitato. Il modulo aggiorna la versione del consenso quando cambiano categorie attive o cookie attivi, e ai visitatori di ritorno viene chiesto di confermare di nuovo.

Lo scanner trova ogni possibile cookie?
No. Trova header Set-Cookie e semplici assegnazioni document.cookie durante la scansione. Alcuni cookie di terze parti appaiono solo dopo il consenso o dopo l'interazione del visitatore, quindi la revisione manuale resta importante.

Posso usare una pagina cookie policy personalizzata?
Sì. Inserisci un URL di policy personalizzato nelle impostazioni. Quando questo campo è compilato, il banner e il pannello preferenze lo usano al posto della pagina CMS generata.

Compatibilità: PrestaShop da 1.6 a 9.0 (ultima), PHP 7.1+. Continuiamo a supportare le prossime versioni di PrestaShop.

Cookies Revolution — Admin cookie inventory
Torna su