Vai al contenuto

Lingua

Menu della documentazione

Personalizzazione del banner

Modifica layout, colori, testi e lingue del banner di consenso, aggiungi CSS personalizzato, un link alle preferenze e pubblica nuove versioni in sicurezza.

Ultimo aggiornamento: 29 ottobre 2026

In Cookiesh ogni sito ha una sola configurazione del banner. Le regole per regione decidono quale esperienza di consenso riceve un visitatore (opt-in, opt-out o sola informativa), mentre la configurazione del banner decide come appare e cosa dice. Modificala in Banners → Appearance e visualizza l’anteprima delle modifiche dal vivo prima di pubblicarle.

Layout

Scegli il layout più adatto al tuo sito. Ogni layout è disponibile con tema chiaro, scuro e automatico; il tema automatico segue l’impostazione prefers-color-scheme del visitatore.

Layout Ideale per Comportamento
bar Siti di marketing Barra a tutta larghezza nella parte inferiore della finestra
box Siti di contenuti e blog Scheda compatta in un angolo, non copre i contenuti
modal App che non devono eseguire nulla prima di una scelta Finestra di dialogo centrata che blocca la pagina finché il visitatore non sceglie

Tutti i layout riservano il proprio spazio e si caricano dopo i tuoi contenuti, quindi non causano spostamenti del layout. Nei banner opt-in, Rifiuta tutti compare sempre al primo livello, con le stesse dimensioni e lo stesso peso di Accetta tutti. Le autorità considerano un’opzione di rifiuto nascosta un dark pattern, per questo l’impostazione non si può disattivare.

Colori, font e branding

In Appearance → Style puoi impostare:

  • Colore del brand. Viene usato per il pulsante principale, gli interruttori e gli indicatori di focus. Cookiesh lo confronta con lo sfondo e ti avvisa se il contrasto è inferiore al livello WCAG AA.
  • Font. inherit (il valore predefinito) usa il font del tuo sito, così il banner sembra nativo senza caricare file aggiuntivi.
  • Raggio degli angoli e ombra, per adattarli al tuo design system.
  • Logo. Facoltativo, viene mostrato nel centro preferenze.

Con i piani Pro ed Enterprise puoi anche rimuovere il badge “Powered by Cookiesh”.

Testi e traduzioni

Cookiesh fornisce testi del banner già revisionati in oltre 40 lingue. Sceglie la lingua in quest’ordine:

  1. L’attributo data-language del tag script, se presente.
  2. L’attributo lang del tuo elemento <html>.
  3. La lingua del browser del visitatore.
  4. La lingua predefinita impostata nella dashboard.
<script
  src="https://sdk.cookiesh.eu/v1/consent.js"
  data-site-id="ck_live_8f2a91"
  data-language="de"
  async
></script>

Per cambiare il testo, apri Appearance → Copy, scegli una lingua e modifica titolo, corpo ed etichette dei pulsanti. Le modifiche valgono solo per quella lingua. Usa un testo specifico: indica le finalità (“misurare il traffico”, “mostrare annunci personalizzati”) invece di scrivere “migliorare la tua esperienza”.

CSS personalizzato

Con i piani Pro ed Enterprise, Appearance → Custom CSS ti permette di andare oltre le opzioni integrate. Il banner viene visualizzato all’interno di uno shadow root: gli stili del tuo sito non possono comprometterlo e i suoi stili non possono influire sul tuo sito. Personalizzalo con le proprietà personalizzate CSS e i nomi ::part() esposti:

cookiesh-banner {
  --ck-color-primary: #4f46e5;
  --ck-color-background: #0a0b10;
  --ck-color-text: #ededf2;
  --ck-radius: 12px;
  --ck-font-family: inherit;
}

cookiesh-banner::part(button-primary) {
  text-transform: none;
  letter-spacing: 0;
}

cookiesh-banner::part(title) {
  font-weight: 600;
}

Parti disponibili: container, title, body, button-primary, button-secondary, link, toggle e category.

I visitatori devono poter cambiare idea con la stessa facilità con cui hanno dato il consenso. Aggiungi al footer un link che riapra il centro preferenze. Funziona qualsiasi elemento con data-cookiesh-open:

<button type="button" data-cookiesh-open="preferences">Impostazioni privacy</button>

Puoi anche chiamare cookiesh.openPreferences() dal tuo codice (vedi l’API JavaScript). Se preferisci non aggiungere un link, attiva il pulsante privacy flottante in Appearance → Floating button.

Pubblicazione e versioni del banner

Le modifiche restano in bozza finché non fai clic su Publish. Ogni pubblicazione crea una nuova versione del banner e ogni record di consenso salva la versione vista dal visitatore, così puoi sempre dimostrare quale testo ha accettato una persona.

Quando modifichi categorie, fornitori o finalità, seleziona Ask again prima di pubblicare. I visitatori che hanno scelto con una versione precedente vedranno di nuovo il banner alla visita successiva. Le modifiche puramente visive, come colori o font, non richiedono una nuova scelta.

Le modifiche pubblicate arrivano sul tuo sito in circa un minuto. Non devi mai rifare il deploy del tuo sito.