Liigu sisu juurde

Keel

Dokumentatsiooni menüü

Bänneri kohandamine

Muuda nõusolekubänneri paigutust, värve, tekste ja keeli, lisa kohandatud CSS, seo eelistuste nupp ning avalda uusi bänneri versioone turvaliselt.

Viimati uuendatud 29. oktoober 2026

Igal Cookiesh saidil on üks bänneri seadistus. Piirkonnareegel otsustab, millise nõusolekukogemuse külastaja saab (eelnev nõusolek, loobumine või teavitus), ja bänneri seadistus otsustab, kuidas see välja näeb ja mida ütleb. Muuda seda jaotises Banners → Appearance ja eelvaata muudatusi reaalajas enne avaldamist.

Paigutused

Vali oma saidile sobiv paigutus. Igal paigutusel on hele, tume ja automaatne teema. Automaatne teema järgib külastaja seadet prefers-color-scheme.

Paigutus Sobib kõige paremini Käitumine
bar Turundussaidid Täislaiuses riba vaateala allservas
box Sisusaidid ja blogid Kompaktne kaart nurgas, ei kata sisu
modal Rakendused, mis ei tohi enne valikut midagi käivitada Keskele paigutatud dialoog, mis blokeerib lehe, kuni külastaja valiku teeb

Kõik paigutused reserveerivad endale ruumi ja laaditakse pärast sinu sisu, seega ei põhjusta need paigutuse nihet. Eelneva nõusoleku bänneritel on Keeldu kõigist alati esimesel tasandil ning sama suure ja sama rõhuga kui Nõustu kõigiga. Järelevalveasutused peavad peidetud keeldumisvõimalust pimemustriks, seega seda välja lülitada ei saa.

Värvid, fondid ja bränding

Jaotises Appearance → Style saad määrata:

  • Brändi värv. Seda kasutatakse põhinupu, lülitite ja fookusrõngaste jaoks. Cookiesh võrdleb seda taustaga ja hoiatab, kui kontrast jääb alla WCAG AA taseme.
  • Font. inherit (vaikeväärtus) kasutab sinu saidi fonti, nii et bänner näeb välja omane ilma lisafaile laadimata.
  • Nurkade ümarus ja vari, et sobitada bänner oma disainisüsteemiga.
  • Logo. Valikuline, kuvatakse eelistuste keskuses.

Pro- ja Enterprise-paketis saad eemaldada ka märgi „Powered by Cookiesh“.

Tekstid ja tõlked

Cookiesh pakub üle vaadatud bänneritekste enam kui 40 keeles. Keel valitakse selles järjekorras:

  1. Skriptimärgendi atribuut data-language, kui see on olemas.
  2. Sinu elemendi <html> atribuut lang.
  3. Külastaja brauseri keel.
  4. Töölaual määratud vaikekeel.
<script
  src="https://sdk.cookiesh.eu/v1/consent.js"
  data-site-id="ck_live_8f2a91"
  data-language="de"
  async
></script>

Sõnastuse muutmiseks ava Appearance → Copy, vali keel ning muuda pealkirja, põhiteksti ja nuppude silte. Muudatused kehtivad ainult selle keele kohta. Hoia tekst konkreetne: nimeta eesmärgid („liikluse mõõtmine“, „isikupärastatud reklaamide näitamine“), selle asemel et kirjutada „kasutuskogemuse parandamine“.

Kohandatud CSS

Pro- ja Enterprise-paketis saad jaotises Appearance → Custom CSS minna sisseehitatud valikutest kaugemale. Bänner renderdatakse shadow root’i sees, nii et sinu saidi stiilid ei saa seda lõhkuda ja bänneri stiilid ei leki sinu saidile. Kujunda seda CSS-i kohandatud omaduste ja avatud ::part() nimede abil:

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;
}

Saadaolevad osad: container, title, body, button-primary, button-secondary, link, toggle ja category.

Külastaja peab saama oma meelt muuta sama lihtsalt, kui ta nõusoleku andis. Lisa jalusesse link, mis avab uuesti eelistuste keskuse. Sobib iga element, millel on atribuut data-cookiesh-open:

<button type="button" data-cookiesh-open="preferences">Privacy settings</button>

Võid kutsuda ka oma koodist cookiesh.openPreferences() (vaata JavaScripti API-t). Kui sa ei soovi linki lisada, lülita jaotises Appearance → Floating button sisse hõljuv privaatsusnupp.

Avaldamine ja bänneri versioonid

Muudatused jäävad mustandiks, kuni klõpsad Publish. Iga avaldamine loob uue bänneri versiooni ja iga nõusolekukirje salvestab versiooni, mida külastaja nägi, nii et saad alati näidata, millise tekstiga keegi nõustus.

Kui muudad kategooriaid, teenusepakkujaid või eesmärke, märgi enne avaldamist Ask again. Külastajad, kes tegid valiku vanema versiooni ajal, näevad siis järgmisel külastusel bännerit uuesti. Puhtalt visuaalsed muudatused, näiteks värvid või fondid, uut valikut ei nõua.

Avaldatud muudatused jõuavad sinu saidile umbes minutiga. Saiti ei pea kunagi uuesti juurutama.