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.
Włączanie
- W Sklep → Zamówienia zaznacz Dodawaj bransoletkę do koszyka mojego sklepu.
- Wpisz adres swojej strony, na przykład
https://www.my-shop.com(zwwwi bez działa tak samo). - 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.
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ść;beadsielements: lista zname,qtyiunit_price(pluslength_mmdla elementów,size_mmdla 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';
});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