A karkötő az üzleted kosarába (Shopify…)

A tervező a webáruházad egyik oldalába van ágyazva? A gomb „Kosárba” lesz, és a karkötő az oldaladra kerül.

Ha a terveződ a webáruházad egyik oldalába van ágyazva (Shopify, WooCommerce, Wix…), a vásárlód egyenesen a kosaradba teheti a karkötőjét, és a te oldaladon fizethet, ahelyett hogy e-mailben küldene kérést.

WordPress + WooCommerce oldal? Egy kész, telepíthető bővítmény mindent elvégez, fejlesztő nélkül: lásd WooCommerce kosár: a kész bővítmény.

Bekapcsolás

  1. Az Üzlet → Rendelések részben jelöld be A karkötő az üzletem kosarába kerüljön lehetőséget.
  2. Add meg a weboldalad címét, például https://www.my-shop.com (www-vel és anélkül is működik).
  3. Ments, majd kérd meg a fejlesztődet, hogy tegye az alábbi kis szkriptet arra az oldalra, amelyen a tervező van.

Az oldaladon a rendelés gomb Kosárba lesz. Máshol (közvetlen link a tervezőhöz, másik oldal) az e-mailes rendelés marad.

A karkötőt csak a weboldalad címére küldjük, soha máshová.

Mit kap az oldalad

Kattintáskor a tervező üzenetet küld az oldaladnak (postMessage):

  • total, currency: a teljes ár és a pénznem;
  • wrist_cm, bead_mm, real_length_cm: kért csuklóméret, gyöngyméret (lista, például [8, 10], ha a méretek keverednek), tényleges hossz;
  • beads és elements: a lista, name, qty és unit_price adatokkal (az elemeknél length_mm, minden kőnél size_mm: kövenként és méretenként egy sor);
  • order_text: az összetétel szövegként, rendelési megjegyzéshez készen;
  • design_url: a link, amely pontosan ezt a karkötőt nyitja meg újra.

Befejezetlen karkötő: semmit sem küldünk

A karkötőt csak akkor küldjük el, ha a tényleges hossza (felhelyezett gyöngyök, elemek és kapocs, az üres helyek nélkül) a tűréshatáron belül van: -5 mm és +8 mm között a választott csuklóméret körül. Különben a tervező a „Túl rövid a karkötő…” (vagy „túl hosszú”) üzenetet mutatja, és semmit sem küld.

Az oldalad is elutasíthat egy karkötőt. Ekkor ezt az üzenetet küldi vissza a tervezőnek, amely a „Kosárba téve” helyett megmutatja a vásárlódnak (egyszerű szövegként):

document.querySelector('iframe').contentWindow.postMessage(
  { source: 'shop', type: 'bracelet:error', message: 'Your text' }, 'https://lochness-paris.com');

Saját „Kosárba” sávod (nem kötelező)

Kosár módban a tervező már mutatja a „Kosárba” gombot az árral (telefonon külön sorban), és egy alul rögzített sávot, amint a karkötő elkészült. Ha inkább a saját sávodat mutatnád az oldaladon, a telefon képernyőjének alján, két üzenet áll rendelkezésre.

Minden alkalommal, amikor a karkötő változik, a tervező ezt küldi az oldaladnak (csak a te címedre):

{ source: 'lochness', type: 'bracelet:state', version: 1, filled: 24, max: 24, complete: true,
  total_cents: 3320, currency: 'EUR', length_ok: true, demo_ok: true, ready: true }

A ready értéke true, ha a karkötő megrendelhető (kész, megfelelő hosszú). Az állapot azonnali lekéréséhez (például az oldal betöltésekor): { source: 'shop', type: 'bracelet:state?' }.

A sávod ezután elindíthatja a rendelést, pontosan úgy, mint a tervező gombja (ugyanazok a hosszellenőrzések, majd a szokásos bracelet:order üzenet):

document.querySelector('iframe').contentWindow.postMessage(
  { source: 'shop', type: 'bracelet:checkout' }, 'https://lochness-paris.com');

A fejlesztődnek (Shopify-példa)

window.addEventListener('message', async (e) => {
  if (e.origin !== 'https://lochness-paris.com') return;   // only the builder
  const d = e.data;
  if (!d || d.source !== 'lochness' || d.type !== 'bracelet:order') return;
  await fetch('/cart/add.js', {
    method: 'POST', headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ items: [{
      id: YOUR_BRACELET_VARIANT, quantity: 1,
      properties: { 'Composition': d.order_text, 'See the bracelet': d.design_url }
    }] })
  });
  window.location.href = '/cart';
});
Ne bízz vakon a végösszegben: számold újra a saját áraiddal (qty × a te árad minden kőnél), vagy ellenőrizd a rendelést szállítás előtt.

Hogy a kosárban hogyan áll be az ár, az az üzletedtől függ (áranként egy termék, egyedi árazó alkalmazás…): ezt a fejlesztőd választja ki.

Lásd még: Rendelések fogadása, A tervező hozzáadása a weboldaladhoz.

Frissítve: 2026. november 16.