Dokumentacija nazadnje dopolnjena 27. maj 2026
Status izdaje Shopify adapterja
Trenutna verzija Shopify storefront poti in rollout opombe za extension, ki se dostavlja znotraj Platform Core.
Trenutna verzija
0.1.23
Dostavni kanal
Vključeno v Platform Core
Opombe o združljivosti
Shopify storefront rollout še vedno teče skozi Platform Core, medtem ko je samostojna app pot ločena.
Ključne rollout spremembe
1. Uporabi theme app extension iz Platform Core.
2. Embedded app pot obravnavaj kot ločeno admin površino, ne kot primarni storefront installer.
3. Embed blok preveri v development trgovini pred live rolloutom.
Shopify adapter: uvajanje po nakupu
Ta vodič uporabi po plačilu, da prideš od generiranega ZIP-a do preverjenega storefront rollouta. Shopify runtime plast živi v theme app extensionu. Opcijski embedded app ostaja ločen admin in billing lane za večje, bolj produktizirane rollout scenarije.
- • Iz `/sl/prenosi` prenesi `cookiezy-platform-core.zip`.
- • Za Shopify uporabi `packages/adapters/shopify/theme-app-extension/` iz tega paketa.
- • Prvi smoke test naredi na Shopify development storeu in extension-only appu, preden posežeš v živo temo.
- • Pred vklopom Cookiezy embed bloka v billingu registriraj točen storefront hostname.
- • V čisti seji preveri homepage, product, collection, cart in policy stran.
Prenesi Platform Core in ohrani Shopify datoteke nespremenjene
Shopify se trenutno dostavlja znotraj Platform Core in ne kot ločen ZIP. Imena datotek pusti nespremenjena, ker jih Liquid blok in loader referencirata neposredno.
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.liquid
packages/adapters/shopify/theme-app-extension/locales/en.default.json
packages/adapters/shopify/theme-app-extension/locales/en.default.schema.jsonZa prvi smoke test uporabi development store in extension-only app
Najmanj tvegan prvi test je Shopify development store skupaj z extension-only appom. Ustvari theme app extension, vanj kopiraj Cookiezy Shopify datoteke in najprej preveri storefront flow tam.
- • V Shopify Partner Dashboardu ustvari development store.
- • Za prvi storefront smoke test ustvari extension-only app.
- • Generiraj theme app extension in vanj kopiraj celotno vsebino `theme-app-extension/`.
- • Pred testom odstrani demo scaffold ostanke, da ostane samo Cookiezy blok.
V Theme Editorju prikaži polja, ki jih merchant dejansko potrebuje
Embed block mora v Theme Editorju prikazati produkcijska polja, da merchant ali delivery ekipa lahko dokonča setup brez ročnega urejanja Liquid datotek.
- • Cookie policy URL
- • Cookiezy Site Key
- • License verification URL
- • Billing / portal URL
- • Banner layout
- • Theme CSS class
Pred objavo registriraj točen storefront hostname
Cookiezy licensing v runtimeu preverja točen storefront hostname. Registriraj tisti host, na katerem storefront dejansko teče, ne le tistega, ki se zdi ekvivalenten v Shopify adminu.
- • `my-shop.myshopify.com` in custom storefront domena nista isti hostname.
- • Če testiraš na custom domeni, registriraj custom domeno.
- • Če testiraš na `myshopify.com` hostu, registriraj ta točen hostname.
- • Po nastavitvi potrdi, da `/api/licensing/verify` za storefront hostname vrne `allowed: true`.
Objavi extension in preveri storefront vedenje
Objavi theme app extension, v aktivni temi omogoči `cookiezy-embed`, nato pa vse preveri v theme previewju ali v čisti seji, preden objaviš spremembe v živo temo.
- • Pred shranjevanjem potrdi, da Theme Editor prikazuje vsa pričakovana polja.
- • Na prvem obisku se mora prikazati banner.
- • Product, collection in cart strani ne smejo naložiti opcijskega sledenja pred soglasjem.
- • Zavrni opcijsko in preveri, da analitika ter marketing ostaneta blokirana.
- • Audit na policy strani se mora po ponovnem skenu osvežiti na trenutno stanje.
Hitri pregledi, ko Shopify consent ne deluje po pričakovanjih
Večina Shopify rollout težav izhaja iz vidnosti konfiguracijskih polj, exact hostname neskladij ali zastarelih assetov in ne iz samega consent runtime jedra.
- • Če `verify_url` ali `billing_url` v Theme Editorju nista vidna, preveri extension schema in locale datoteke.
- • Če storefront pade v restricted mode, preveri `window.CookiezyConfig` in potrdi, da so `siteKey`, `verifyUrl` in `billingUrl` zapolnjeni.
- • Če licensing še vedno pade, preveri, ali je v Cookiezy billingu registriran točen storefront hostname.
- • Če si paket posodobil, poskrbi, da so theme app extension asseti znova objavljeni in da aktivna tema uporablja nov embed build.