Link "Preferenze cookie"
Un link nel footer riapre il pannello delle preferenze, così il visitatore può cambiare scelta in qualsiasi momento. Il link chiama window.Avacy.showPreferenceCenter().
Il banner v2 usa un'altra chiamata, che il banner attuale non riconosce. Vedi Link alle preferenze (v2). Se non sai quale banner usa il tuo sito, leggi Quale banner sta usando il tuo sito.
Prerequisiti
Prima di cominciare controlla che:
- il banner sia installato nella pagina. Vedi Snippet HTML;
- tu possa modificare il template della pagina o il footer.
Step
-
Aggiungi il link nel footer, nascosto finché il banner non è caricato.
<a href="#" id="avacy-prefs-link" hidden>Preferenze cookie</a>Per un sito in inglese usa il testo
Cookie Preferences, lo stesso che usa il banner. -
Aggiungi subito dopo il link lo script che mostra il link quando il banner è pronto e apre il pannello al clic.
<script>(function () {var link = document.getElementById('avacy-prefs-link');function show() {link.hidden = false;}// Il banner può essere già pronto, oppure no.if (window.Avacy && window.Avacy.getConsent() && window.Avacy.getConsent().ready) {show();} else {document.addEventListener('avacy:ready', show, { once: true });}link.addEventListener('click', function (event) {event.preventDefault();window.Avacy.showPreferenceCenter();});})();</script> -
Salva la pagina e ricaricala.
Perché il link parte nascosto
Il banner si carica in modo asincrono e crea window.Avacy solo all'avvio. Prima, window.Avacy.showPreferenceCenter() genera un errore e il banner non mette in coda le chiamate arrivate troppo presto.
Lo script dello step 2 mostra il link subito se il banner è già pronto, altrimenti aspetta avacy:ready. Controlla prima getConsent() perché un listener registrato dopo l'evento lo perde. Altri eventi in Eventi del banner.
Aprire il pannello su una sezione
showPreferenceCenter accetta un argomento facoltativo: un oggetto di opzioni.
window.Avacy.showPreferenceCenter(options?: { section?: string }): Promise<void>
| Opzione | Cosa fa |
|---|---|
section | Apre il pannello su una sezione, indicata dal tipo ('vendor') o dall'id esatto ('tcf::vendor'). Se la sezione non esiste, il pannello si apre dalla prima voce. |
Il pannello si apre sempre sopra la pagina.
Apertura sull'elenco dei fornitori.
window.Avacy.showPreferenceCenter({ section: 'vendor' });
La funzione restituisce una Promise. Il banner emette l'evento avacy:cpc-opened all'apertura e avacy:cpc-closed alla chiusura.
Verifica
- Apri la pagina. Il link compare a banner pronto.
- Clicca Preferenze cookie. Il pannello si apre.
Problemi comuni
I problemi più frequenti:
- Il clic non fa niente e la console mostra
Cannot read properties of undefined: il banner non è ancora caricato o la pagina non ha lo snippet. Usa lo script dello step 2; - Il link è coperto dal banner: il banner del primo livello si sovrappone al footer finché il visitatore non sceglie. Il link serve dopo la scelta;
- Il bottone delle preferenze (lo scudo) non compare: nella dashboard l'opzione è in Aspetto > Banner > Area preferenze > Mostra il bottone sul tuo spazio web. Con l'opzione spenta, il link nel footer è l'unico modo di riaprire il pannello.
Ultimo aggiornamento: 10/11/2026.