Documentazione WPConsent

Documentazione, Materiali di Riferimento e Tutorial per WPConsent

Integrazione API Consenso WP

Vuoi che altri plugin di WordPress riconoscano automaticamente le scelte di consenso dei tuoi visitatori? WPConsent si integra con il plugin WP Consent API in modo che le decisioni di consenso prese tramite il tuo banner vengano condivise con ogni plugin compatibile sul tuo sito. Questa guida spiega cos'è la WP Consent API, perché l'integrazione è importante e come WPConsent mappa le sue categorie al formato API standard.

Indice

La WP Consent API è un plugin gratuito per WordPress che crea un linguaggio comune per la gestione del consenso. Invece di ogni plugin che crea i propri controlli di consenso, la WP Consent API fornisce uno standard unico che i plugin possono utilizzare per chiedere “questo visitatore consente i cookie statistici?” o “questo visitatore consente i cookie di marketing?”

Qualsiasi plugin che supporta la WP Consent API può leggere gli stati di consenso da qualsiasi plugin di gestione del consenso compatibile. Ciò significa che non sei bloccato in un ecosistema specifico: le tue scelte di consenso fluiscono a ogni plugin che parla la stessa lingua.

Perché questa integrazione è importante

Senza la WP Consent API, ogni plugin gestisce il consenso in modo indipendente. Ciò può portare a situazioni in cui:

  • Un visitatore accetta i cookie tramite il tuo banner WPConsent, ma un plugin di moduli non ne è a conoscenza e blocca la funzionalità inutilmente.
  • Un visitatore rifiuta i cookie di marketing, ma un plugin di analisi viene comunque caricato perché non controlla lo stato di consenso di WPConsent.
  • È necessario configurare manualmente i controlli di consenso in più plugin invece di gestire tutto da un unico posto.

Con l'integrazione attiva, WPConsent diventa l'unica fonte di verità per il consenso sul tuo sito. Ogni plugin compatibile con la WP Consent API rispetta automaticamente le scelte che i visitatori fanno tramite il tuo banner.

Come funziona l'integrazione

Quando sia WPConsent che il plugin WP Consent API sono attivi, l'integrazione avviene automaticamente. Non c'è nulla da configurare.

Ecco cosa fa WPConsent dietro le quinte:

  1. Si registra come gestore del consenso attivo in modo che la WP Consent API sappia quale plugin sta gestendo il consenso.
  2. Imposta il tipo di consenso (opt-in o opt-out) in base alle tue impostazioni WPConsent, in modo che altri plugin sappiano se bloccare o consentire per impostazione predefinita.
  3. Sincronizza le scelte di consenso ogni volta che un visitatore salva le proprie preferenze tramite il banner. WPConsent traduce le proprie categorie nel formato standard della WP Consent API.
  4. Evita il doppio blocco saltando il proprio blocco degli script per gli script già gestiti dalla WP Consent API.

Se il plugin WP Consent API non è installato, WPConsent funziona esattamente allo stesso modo: l'integrazione semplicemente non si attiva.

Mappatura delle categorie

WPConsent utilizza i propri nomi di categoria (Essenziale, Statistiche, Marketing), mentre la WP Consent API utilizza un set diverso di categorie standard. WPConsent esegue automaticamente la mappatura tra le due ogni volta che un visitatore salva le proprie preferenze.

Categoria WPConsentCategoria WP Consent APIStato del consenso
EssenzialefunzionaleSempre consentito
EssenzialepreferenzeSempre consentito
StatistichestatisticheIn base alla scelta del visitatore
Statistichestatistiche-anonimeIn base alla scelta del visitatore
MarketingmarketingIn base alla scelta del visitatore

Alcune cose da notare:

  • Essenziali corrisponde sia a funzionali che a preferenze perché WPConsent non ha una categoria Preferenze separata. Entrambe sono sempre impostate su “consentito” poiché i cookie essenziali sono necessari per il funzionamento del tuo sito.
  • Statistiche corrisponde sia a statistiche che a statistiche-anonime. L'API WP Consent distingue tra analytics regolari e anonimi, ma WPConsent li tratta allo stesso modo: entrambi seguono la scelta del visitatore per le Statistiche.
  • Marketing corrisponde direttamente a marketing senza traduzioni aggiuntive.

Questa mappatura significa che qualsiasi plugin che controlla wp_has_consent( 'statistics' ) o wp_has_consent( 'marketing' ) rispetta automaticamente le scelte che i visitatori fanno tramite il tuo banner WPConsent.

WPConsent indica all'API WP Consent se il tuo sito utilizza il consenso opt-in o opt-out:

  • Opt-in (Consenti predefinito disattivato): Script e cookie sono bloccati finché il visitatore non accetta esplicitamente. Questo è lo standard per la conformità GDPR.
  • Opt-out (Consenti predefinito attivato): Script e cookie sono consentiti per impostazione predefinita finché il visitatore non li rifiuta attivamente.

Questa impostazione viene letta dalla configurazione di WPConsent in WPConsent >> Impostazioni (l'interruttore Consenti predefinito). Altri plugin che controllano il consenso possono quindi adattare il loro comportamento di conseguenza.

Coordinamento del blocco degli script

Quando sia WPConsent che l'API WP Consent gestiscono lo stesso script, può verificarsi un doppio blocco. Per evitare ciò, WPConsent salta automaticamente il proprio blocco per gli script già gestiti dall'API WP Consent.

Ad esempio, lo script di tracciamento delle attribuzioni di WooCommerce è gestito tramite l'API WP Consent. WPConsent lo rileva e lascia che l'API WP Consent gestisca il blocco invece di applicare le proprie regole.

Configurazione dell'integrazione

  1. Installa e attiva il plugin WP Consent API dal repository dei plugin di WordPress.
  2. Ecco fatto. WPConsent rileva automaticamente l'API WP Consent e attiva l'integrazione.

Non ci sono impostazioni aggiuntive da configurare. La mappatura delle categorie, la sincronizzazione del tipo di consenso e il coordinamento del blocco degli script avvengono tutti automaticamente.

FAQ

Sì. L'API WP Consent è un plugin gratuito separato disponibile nel repository dei plugin di WordPress. Installalo e attivalo insieme a WPConsent per abilitare l'integrazione.

Innanzitutto, verifica che il plugin WP Consent API sia installato e attivo. Quindi, conferma che l'altro plugin supporti effettivamente l'API WP Consent (controlla la sua documentazione). Infine, prova a testare in una finestra di navigazione in incognito per escludere uno stato di consenso memorizzato nella cache.

No. WPConsent funziona completamente da solo. L'integrazione con l'API WP Consent è un'aggiunta opzionale che migliora l'interoperabilità con altri plugin che supportano lo standard.

L'integrazione richiede una configurazione?

No. Una volta che entrambi i plugin sono attivi, WPConsent gestisce tutto automaticamente: registrazione, mappatura delle categorie, sincronizzazione del tipo di consenso e coordinamento del blocco degli script.

Conclusione

L'integrazione WP Consent API consente a WPConsent di condividere le decisioni di consenso con ogni plugin compatibile sul tuo sito tramite un'interfaccia standardizzata. Installa il plugin WP Consent API e WPConsent gestirà il resto automaticamente. Per ulteriori informazioni su argomenti correlati, consulta la gestione delle categorie di cookie e il blocco automatico degli script.

Questo articolo è stato utile?

Articoli Correlati