CookiezyCookiezy
ProduktPlatformeDokumentacijaCenikBlogKontakt
  1. Domov/
  2. Docs/
  3. Next.js 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 adapterjaNext.js adapter

Status izdaje Next.js adapterja

Trenutna verzija Next.js 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

Next.js še vedno uporablja plain adapter pot iz Platform Core z App Router slogom integracije.

Ključne rollout spremembe

1. Shared assete postavi v `public/` ali drugo pot, servirano iz korena.

2. Vsako locale policy pot ohrani usklajeno z runtime konfiguracijo.

3. Consent-aware obnašanje preveri skozi server in client prehode.

Pregled

Next.js adapter: uvajanje po nakupu

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

  • • Prenesi `platform-cookie-core.zip` iz uporabniškega področja.
  • • Plain adapter in shared assete skopiraj v `public/`.
  • • V obračunskem delu registriraj vsako produkcijsko domeno.
  • • Sistem naloži in zaženi iz `app/layout.tsx` z objektom `license`, ki vključuje `siteKey`, `verifyUrl` in `billingUrl`.
  • • Preveri lokalizirane poti do politike piškotkov, stanje soglasja in obnašanje pregleda piškotkov.
pogled tehnične dokumentacije za Cookiezy Next.js adapter, ki prikazuje zagon v korenski postavitvi in lokaliziran tok pregleda politike piškotkov.
Next.js tehnična referenca: nastavitev v korenski postavitvi, lokalizirana pot do politike piškotkov in preverjanje domene.
Korak 1

Serviraj assete iz `public/`

Korenska postavitev mora znati naložiti skupni CSS in datoteke izvajanja za vse poti in jezike.

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

Zaženi sistem iz korenske postavitve

Sloj za soglasje naj bo globalno na voljo v App Routerju, zato adapter naloži iz korenske postavitve.

Code snippet

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

Mapiraj locale segmente na policy poti v App Routerju

Če app uporablja `app/[locale]`, aktivni segment locale podaj neposredno in `localeRoutes` ohrani usklajen z lokaliziranimi potmi do politike piškotkov. Tako ostaneta jezik bannerja in policy link usklajena na vseh lokaliziranih route-ih.

  • • Kot `locale` uporabi aktivni route segment.
  • • `localeRoutes` uporabi za per-locale URL-je do politike piškotkov.
  • • V obračunavanju še vedno registriraj vsako produkcijsko domeno, tudi če vsi jeziki uporabljajo isto domeno.
Menjava jezika v aplikaciji

Po client-side menjavi jezika osveži Cookiezy

Če se aktivni locale zamenja client-side, uporabi `Cookiezy.setLocale()`, da se banner in modal takoj posodobita brez polnega reloada strani.

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

Preveri poti, pregled piškotkov in licenciranje

Pred objavo izvedi iste teste na domači strani, ceniku in policy poti.

  • • Banner se prikaže ob prvem obisku.
  • • Lokalizirane poti uporabljajo pravilen URL politike piškotkov.
  • • Audit na strani s politiko piškotkov se naloži in re-scan deluje.
  • • Opcijska analitika steče šele po podanem soglasju.
  • • Naslov za preverjanje za vsako produkcijsko domeno vrne `allowed: true`.
  • • Če obračunavanje ni aktivno ali domena ni registrirana, sistem preide v omejeni način samo z nujnimi piškotki.
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.