Dokumentacija zadnji put dopunjena 27. svibnja 2026.
Status izdanja Shopify adaptera
Trenutna verzija Shopify storefront putanje i rollout napomene za extension koji se isporučuje unutar Platform Core.
Trenutna verzija
0.1.23
Delivery kanal
Uključeno u Platform Core
Napomene o kompatibilnosti
Shopify storefront rollout još uvijek ide kroz Platform Core, dok je samostalna app putanja odvojena.
Ključne rollout promjene
1. Koristi theme app extension iz Platform Core.
2. Embedded app putanju tretiraj kao odvojenu admin površinu, a ne kao primarni storefront installer.
3. Provjeri embed blok u development trgovini prije live rollouta.
Shopify adapter nakon kupnje
Shopify runtime dolazi kroz theme app extension. Embedded app lane ostaje zaseban admin i billing smjer za naprednije rollout scenarije.
- • Preuzmi `cookiezy-platform-core.zip` iz korisničkog područja.
- • Za Shopify koristi `packages/adapters/shopify/theme-app-extension/`.
- • Prvi smoke test napravi na development storeu i extension-only appu.
- • Prije uključivanja embeda registriraj točan storefront hostname u naplati.
Zadrži Shopify datoteke netaknute
Liquid blok i loader izravno referenciraju nazive datoteka, zato ih nemoj preimenovati.
Code snippet
packages/adapters/shopify/theme-app-extension/assets/cookie-consent-shopify-loader.js
packages/adapters/shopify/theme-app-extension/assets/cookie-consent.js
packages/adapters/shopify/theme-app-extension/assets/cookie-consent-ui.js
packages/adapters/shopify/theme-app-extension/assets/cookie-consent-scanner.js
packages/adapters/shopify/theme-app-extension/assets/cookie-consent.css
packages/adapters/shopify/theme-app-extension/assets/shopify-customer-privacy-bridge.js
packages/adapters/shopify/theme-app-extension/blocks/cookiezy-embed.liquidProvjeri Theme Editor postavke
Merchant ili delivery tim trebaju vidjeti sva ključna polja bez ručnog uređivanja Liquida.
- • Cookie policy URL
- • Cookiezy Site Key
- • License verification URL
- • Billing / portal URL
- • Banner layout
- • Theme CSS class
Registriraj exact storefront hostname
Cookiezy licensing provjerava točan storefront hostname u runtimeu.
- • `my-shop.myshopify.com` i custom domena nisu isti hostname.
- • Ako testiraš na custom domeni, registriraj custom domenu.
- • Ako testiraš na `myshopify.com` hostu, registriraj taj točan hostname.
- • Potvrdi da `/api/licensing/verify` vraća `allowed: true`.
Minimalni storefront checklist prije go-livea
Prije objave testiraj u preview temi ili čistoj sesiji preglednika.
- • Banner se prikazuje pri prvom posjetu.
- • Homepage, product, collection i cart ne pokreću opcionalno praćenje prije privole.
- • Audit na stranici politike kolačića odražava trenutno stanje nakon ponovnog skena.
- • Ako `verify_url` ili `billing_url` nisu vidljivi, provjeri schema i locale datoteke extensiona.