Passa al contenuto principale

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().

Banner v2

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​

  1. 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.

  2. 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>
  3. Salva la pagina e ricaricala.

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>
OpzioneCosa fa
sectionApre 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​

  1. Apri la pagina. Il link compare a banner pronto.
  2. 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.