Overview

Shopify adapter: post-purchase rollout

Ta vodič uporabi po plačilu, da prideš od ZIP downloada do storefront verifikacije. Theme app extension je storefront runtime layer; opcijski embedded app je ločen admin in billing sloj.

• Prenesi `platform-cookie-core.zip`.
• Mapo `packages/adapters/shopify/theme-app-extension/` prenesi v Shopify extension workspace.
• V billing delu registriraj produkcijski storefront hostname.
• V theme editorju vklopi Cookiezy embed block.
• Validiraj obnašanje na homepage, product, collection, cart in policy strani.

Developer docs pogled za Cookiezy Shopify adapter, ki prikazuje theme app extension in storefront embed flow. — Shopify tehnična referenca: extension package, embed block in storefront verification.

Step 1

Pripravi Shopify extension package

Shopify package pusti nespremenjen, ker Liquid block neposredno referencira asset imena.

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

Step 2

V embed block config dodaj licensing vrednosti

Embed block mora storefrontu posredovati produkcijske licensing vrednosti, da lahko pred normalnim delovanjem preveri account in hostname.

Code snippet

window.CookiezyConfig = {
  locale: "sl",
  policyUrl: "/sl/cookie-policy",
  license: {
    siteKey: "ck_live_cookiezy_demo",
    verifyUrl: "https://cookiezy.com/api/licensing/verify",
    billingUrl: "https://cookiezy.com/sl/billing",
    adapter: "shopify",
    version: "1.0.0"
  },
  shopify: {
    assets: {
      coreUrl: "{{ 'cookie-consent.js' | asset_url }}",
      uiUrl: "{{ 'cookie-consent-ui.js' | asset_url }}",
      scannerUrl: "{{ 'cookie-consent-scanner.js' | asset_url }}",
      bridgeUrl: "{{ 'shopify-customer-privacy-bridge.js' | asset_url }}"
    }
  }
};

Step 3

Deployaj in vklopi embed block

Theme app extension deployaj, nato pa `cookiezy-embed` v aktivni temi vklopi skozi theme customizer.

• Block vključi enkrat za vsako aktivno temo.
• V previewju preveri, da sta stylesheet in loader dejansko prisotna.
• Policy route in locale uskladi z jezikom storefronta.

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

window.CookiezyConfig = { locale: "sl", policyUrl: "/sl/cookie-policy", license: { siteKey: "ck_live_cookiezy_demo", verifyUrl: "https://cookiezy.com/api/licensing/verify", billingUrl: "https://cookiezy.com/sl/billing", adapter: "shopify", version: "1.0.0" }, shopify: { assets: { coreUrl: "{{ 'cookie-consent.js' | asset_url }}", uiUrl: "{{ 'cookie-consent-ui.js' | asset_url }}", scannerUrl: "{{ 'cookie-consent-scanner.js' | asset_url }}", bridgeUrl: "{{ 'shopify-customer-privacy-bridge.js' | asset_url }}" } } };