CookiezyCookiezy
ProduktPlatformeDokumentacijaCenikBlogKontakt
  1. Domov/
  2. Docs/
  3. React adapter

Dokumentacija nazadnje dopolnjena 29. maj 2026

Navigacija po dokumentaciji

Pregled

DokumentacijaTehnična dokumentacija za namestitev, konfiguracijo in preverjanje Cookiezy na vseh podprtih adapterjih.UvodPreveri pripravljenost, generiraj pravi paket in nato preveri uvajanje v živo.NamestitevNamestitev povsod sledi istemu temeljnemu vzorcu: generiraj izdani paket, registriraj domeno, namesti adapter in pred objavo preveri delovanje.KonfiguracijaKonfiguracija uskladi jezik, stran s politiko piškotkov, kategorije, postavitev in licenčni kontekst.

Referenca

APIMetode izvajanja v brskalniku, dogodki in integracijske opombe, ki upoštevajo preverjanje delovanja.

Adapterji

Webflow adapterTehnični vodič za Webflow nastavitev Cookiezy: kaj dobiš po nakupu, kam spadajo datoteke in kako preveriš delovanje na objavljeni Webflow strani.Shopify adapterTehnični vodič za Shopify nastavitev Cookiezy: prenesi Platform Core, uvedi theme app extension, prikaži prava Theme Editor polja in preveri storefront vedenje pred objavo.Wix adapterTehnični vodič za Wix nastavitev Cookiezy: namesti private ali unlisted Wix app, poveži pravi Cookiezy račun, objavi app-hosted runtime in ohrani custom code samo kot fallback.Hugo adapterTehnični vodič za Hugo nastavitev Cookiezy: generiraj namenski Hugo paket, kopiraj izdani config scaffold, uskladi locale routes in preveri banner ter cookie audit vedenje.Headless adapterTehnični vodič za headless nastavitev Cookiezy: zaženi plain adapter, poveži preverjanje delovanja ter preveri pregled piškotkov, nastavitve in omejeni način samo z nujnimi piškotki v lastnih frontendih.WordPress adapterTehnični vodič za WordPress nastavitev Cookiezy: naloži ZIP z vtičnikom, nastavi vtičnik z upoštevanjem licenciranja in preveri shortcode nastavitve ter obnašanje pregleda piškotkov.React adapterTehnični vodič za React nastavitev Cookiezy: plain adapter naloži iz lupine aplikacije, opcijske storitve pogojuj s stanjem soglasja in preveri obnašanje enostranske aplikacije.Next.js adapterTehnični vodič za Next.js nastavitev Cookiezy: plain adapter naloži iz korenske postavitve, poti do politike piškotkov ohrani lokalizirane in preveri blokiranje brez soglasja na straneh App Routerja.Strapi adapterTehnični vodič za Strapi nastavitev Cookiezy: izvajanje ohrani na frontendu, Strapi uporabi kot konfiguracijski most, večjezične poti do politike piškotkov pa poveži prek skupnega modela.DatoCMS adapterTehnični vodič za DatoCMS nastavitev Cookiezy: visitor-facing runtime naj ostane v frontend aplikaciji, Platform Core naj dostavi runtime assete, samostojni DatoCMS plugin pa naj služi samo za editor-side konfiguracijo in generated frontend config preview.
Verzija adapterjaReact adapter

Status izdaje React adapterja

Trenutna verzija React rollout poti in opombe za plain adapter znotraj Platform Core.

Trenutna verzija

0.1.23

Dostavni kanal

Vključeno v Platform Core

Opombe o združljivosti

React še vedno uporablja plain adapter pot iz Platform Core in ne ločenega React paketa.

Ključne rollout spremembe

1. Adapter naloži enkrat iz app shella.

2. Po client-side menjavi jezika uporabi `window.Cookiezy.setLocale(...)`.

3. Policy audit naj ostane montiran na policy poti.

Pregled

React adapter: uvajanje po nakupu

Ta vodič uporabi po plačilu, da prideš od prenosa ZIP-a do testirane React integracije.

  • • Prenesi `platform-cookie-core.zip` iz uporabniškega področja.
  • • Plain adapter in shared assete skopiraj v `public/` ali CDN.
  • • V obračunskem delu registriraj produkcijsko domeno.
  • • Sistem enkrat naloži iz lupine React in ga zaženi z objektom `license`, ki vključuje `siteKey`, `verifyUrl` in `billingUrl`.
  • • Preveri navigacijo enostranske aplikacije, stanje soglasja in obnašanje pregleda piškotkov.
pogled tehnične dokumentacije za Cookiezy React adapter, ki prikazuje zagon lupine aplikacije in blokiranje glede na soglasje.
React tehnična referenca: global shell bootstrap in analytics gating z upoštevanjem soglasja.
Korak 1

Serviraj assete globalno

Plain adapter datoteke in shared assete postavi tja, kjer jih React aplikacija lahko globalno servira iz shell-a.

Code snippet

public/cookiezy-plain-adapter.js
public/cookie-consent.js
public/cookie-consent-ui.js
public/cookie-consent-scanner.js
public/cookie-consent.css
Korak 2

Bootaj Cookiezy iz shell-a

Adapter zaženi pred opcijskimi integracijami. V produkciji vedno vključi ključ spletnega mesta in naslov za preverjanje.

Code snippet

window.CookiezyPlainAdapter.boot({
  locale: currentLocale,
  defaultLocale: "en",
  localeRoutes: {
    en: { policyUrl: "/en/cookie-policy", pathPrefixes: ["/en"] },
    sl: { policyUrl: "/sl/politika-piskotkov", pathPrefixes: ["/sl"] }
  },
  storageKey: "cookiezy_react_v1",
  license: {
    siteKey: "ck_live_cookiezy_demo",
    verifyUrl: "https://cookiezy.com/api/licensing/verify",
    billingUrl: "https://cookiezy.com/sl/billing"
  }
});
Večjezičnost

Cookiezy poveži z istim locale virom kot React router

V React appih uporabi isti locale, ki ga uporablja route layer ali i18n provider. Shared core tako pravilno izbere prevode in pravo policy stran za aktivni jezik.

  • • Pri router-driven locale-jih `locale` vedno podaj iz trenutne poti.
  • • `localeRoutes` naj bo glavni vir resnice za jezikovno odvisne URL-je politike piškotkov.
  • • Če app menja locale client-side brez polnega reloada, po menjavi jezika ponovno kliči `boot()` z novim locale configom.
Menjava jezika v aplikaciji

Posodobi jezik bannerja brez reloada strani

Če React app locale menja client-side, lahko Cookiezy posodobiš na mestu brez polnega reloada. Tako se osvežijo banner copy, modal copy in policy link za novi jezik.

Code snippet

window.Cookiezy.setLocale("sl", {
  localeRoutes: {
    en: { policyUrl: "/en/cookie-policy", pathPrefixes: ["/en"] },
    sl: { policyUrl: "/sl/politika-piskotkov", pathPrefixes: ["/sl"] }
  },
  license: {
    billingUrl: "https://cookiezy.com/sl/billing"
  }
});
Korak 3

Gate-aj integracije in testiraj SPA obnašanje

Opcijske analitične in marketinške storitve morajo počakati na soglasje, tudi po spremembah poti.

  • • Banner se prikaže ob prvem obisku.
  • • Consent state preživi client-side navigacijo.
  • • Opcijska analitika se zažene šele po eksplicitnem consentu.
  • • Audit na strani s politiko piškotkov se pravilno naloži.
  • • Endpoint za preverjanje na produkcijskem hostname-u vrne `allowed: true`.
  • • Če obračunavanje ni aktivno ali hostname ni registriran, runtime preide v omejeni necessary-only način.
Cookiezy

Lahka platforma za soglasje za piškotke za sodobne spletne strani.

Produkt

FunkcionalnostiPlatformeCenikDokumentacijaBlogKontakt

Pravno

Politika piškotkovPolitika zasebnostiPogoji uporabe

Jezik

Slovenščina
EnglishenSlovenščinaslHrvatskihrItalianoit

Upravljanje piškotkov

© 2026 Cookiezy. Vse pravice pridržane.