Dokumentacija nazadnje dopolnjena 29. maj 2026
Status izdaje headless adapterja
Trenutna verzija headless runtime poti in rollout opombe za plain adapter znotraj Platform Core.
Trenutna verzija
0.1.23
Dostavni kanal
Vključeno v Platform Core
Opombe o združljivosti
Headless rollout še vedno temelji na plain adapterju znotraj Platform Core.
Ključne rollout spremembe
1. Naloži `cookiezy-plain-adapter.js` skupaj s shared runtime asseti.
2. Pred objavo registriraj vse live hostname-e.
3. Locale routes in policy URL-je ohrani usklajene s frontend usmerjevalnikom.
Headless adapter: uvajanje po nakupu
Ta vodič uporabi za poljuben lasten frontend, ki uporablja plain adapter iz ZIP paketa.
- • Prenesi `platform-cookie-core.zip` iz uporabniškega področja.
- • Plain adapter in shared core assete skopiraj v global shell ali CDN.
- • V obračunskem delu registriraj vsak produkcijski hostname.
- • Runtime zaženi z `license.siteKey`, `license.verifyUrl` in `license.billingUrl`, preden naložiš UI in scanner.
- • Preveri `allowed: true`, consent gating, audit na strani s politiko piškotkov in necessary-only fallback, ko licensing ni aktiven.
Naloži runtime iz app shell-a
Shared CSS, core runtime, UI, scanner in kanonično datoteko `cookiezy-plain-adapter.js` serviraj s poti, dostopne vsem route-om.
Code snippet
<link rel="stylesheet" href="/cookie-consent.css" />
<script src="/cookiezy-plain-adapter.js"></script>
<script src="/cookie-consent.js"></script>
<script src="/cookie-consent-ui.js"></script>
<script src="/cookie-consent-scanner.js"></script>Boot z vključenim licensing preverjanjem
Preverjanje runtime-a je v produkciji obvezno, da se adapter ne more nekontrolirano kopirati na neomejeno število domen brez aktivnega licenciranega hostname-a.
Code snippet
window.CookiezyPlainAdapter.boot({
defaultLocale: "en",
localeRoutes: {
en: { policyUrl: "/en/cookie-policy", pathPrefixes: ["/en"] },
sl: { policyUrl: "/sl/politika-piskotkov", pathPrefixes: ["/sl"] },
de: { policyUrl: "/de/cookie-policy", pathPrefixes: ["/de"] }
},
storageKey: "cookiezy_headless_v1",
license: {
siteKey: "ck_live_cookiezy_demo",
verifyUrl: "https://cookiezy.com/api/licensing/verify",
billingUrl: "https://cookiezy.com/sl/billing"
}
});Uporabi locale routes, ko ima stran lokalizirane URL-je
Shared core zdaj podpira `defaultLocale` in `localeRoutes`. Na plain headless straneh je to priporočeni način, da je jezik bannerja in povezava do politike piškotkov usklajena z `/en`, `/sl` ali drugimi locale mapami.
- • Če locale že poznaš iz routerja, ga lahko še vedno podaš neposredno prek `locale`.
- • Če uporabljaš folder-based poti, določi `pathPrefixes`, da Cookiezy prepozna aktivni locale iz URL-ja.
- • Vsak locale route naj kaže na ustrezno verzijo strani s politiko piškotkov.
Poveži helperje in izvedi produkcijske teste
Na vsakem produkcijskem frontendu uporabi helper metode, da lahko obiskovalci ponovno odprejo settings in pregledajo audit na strani s politiko piškotkov.
Code snippet
window.CookiezyPlainAdapter.registerSettingsLink(document);
window.CookiezyPlainAdapter.mountAudit(document);