Dodawanie do koszyka sklepu (Shopify…)

Twój konfigurator jest osadzony na stronie sklepu internetowego? Przycisk staje się „Dodaj do koszyka”, a bransoletka trafia na twoją stronę.

Jeśli twój konfigurator jest osadzony na stronie sklepu internetowego (Shopify, WooCommerce, Wix…), klientka może włożyć bransoletkę prosto do twojego koszyka i zapłacić na twojej stronie, zamiast wysyłać prośbę e-mailem.

Strona na WordPress + WooCommerce? Gotowa do zainstalowania wtyczka robi wszystko, bez programisty: zobacz Koszyk WooCommerce: gotowa wtyczka.

Włączanie

  1. W Sklep → Zamówienia zaznacz Dodawaj bransoletkę do koszyka mojego sklepu.
  2. Wpisz adres swojej strony, na przykład https://www.my-shop.com (z www i bez działa tak samo).
  3. Zapisz, a potem poproś programistę o dodanie poniższego małego skryptu na stronie, na której jest konfigurator.

Na twojej stronie przycisk zamówienia staje się Dodaj do koszyka. Gdzie indziej (link bezpośredni do konfiguratora, inna strona) zostaje zamówienie e-mailem.

Bransoletka jest wysyłana tylko na adres twojej strony, nigdy na inny.

Co otrzymuje twoja strona

Po kliknięciu konfigurator wysyła wiadomość do twojej strony (postMessage):

  • total, currency: cena łączna i waluta;
  • wrist_cm, bead_mm, real_length_cm: zamówiony obwód nadgarstka, rozmiar koralików (lista, na przykład [8, 10], gdy rozmiary są łączone), rzeczywista długość;
  • beads i elements: lista z name, qty i unit_price (plus length_mm dla elementów, size_mm dla każdego kamienia: jeden wiersz na kamień i rozmiar);
  • order_text: skład jako tekst, gotowy do notatki w zamówieniu;
  • design_url: link, który otwiera dokładnie tę bransoletkę.

Niedokończona bransoletka: nic nie jest wysyłane

Bransoletka jest wysyłana tylko wtedy, gdy jej rzeczywista długość (umieszczone koraliki, elementy i zapięcie, bez pustych miejsc) mieści się w tolerancji: od -5 mm do +8 mm wokół wybranego obwodu nadgarstka. W przeciwnym razie konfigurator pokazuje „Bransoletka za krótka…” (lub „za długa”) i nic nie wysyła.

Twoja strona też może odrzucić bransoletkę. Odsyła wtedy do konfiguratora tę wiadomość, którą konfigurator pokazuje klientce (jako zwykły tekst) zamiast „Dodano do koszyka”:

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

Własny pasek „Dodaj do koszyka” (opcjonalnie)

W trybie koszyka konfigurator już pokazuje przycisk „Dodaj do koszyka” z ceną (na telefonie w osobnym wierszu) i pasek przypięty na dole, gdy tylko bransoletka jest gotowa. Jeśli wolisz pokazywać własny pasek na swojej stronie, na dole ekranu telefonu, dostępne są dwie wiadomości.

Za każdym razem, gdy bransoletka się zmienia, konfigurator wysyła do twojej strony (tylko na twój adres):

{ 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 }

ready ma wartość true, gdy bransoletkę można zamówić (gotowa, właściwa długość). Aby od razu pobrać stan (na przykład przy ładowaniu strony): { source: 'shop', type: 'bracelet:state?' }.

Twój pasek może wtedy uruchomić zamówienie, dokładnie jak przycisk konfiguratora (te same kontrole długości, potem zwykła wiadomość bracelet:order):

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

Dla twojego programisty (przykład Shopify)

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';
});
Nie ufaj ślepo sumie: przelicz ją według swoich cen (qty × twoja cena każdego kamienia) albo sprawdź zamówienie przed wysyłką.

Sposób ustawienia ceny w koszyku zależy od twojego sklepu (jeden produkt na cenę, aplikacja do cen niestandardowych…): wybiera go twój programista.

Zobacz też: Przyjmowanie zamówień, Dodawanie konfiguratora do strony.

Aktualizacja: 16 listopada 2026