book() je metoda, ki odpre nakupni postopek. Vse drugo v odjemalcu ga konfigurira ali spremlja.
entase.book(eventID);
entase.book(eventID, options);eventID je identifikator načrtovanega dogodka, za katerega želite prodajati vstopnice. To je isti ID, kot se uporablja v kodah za deljenje in vdelavo vašega dogodka.
Klic se vrne takoj – odpre podokno ali okno in ne čaka, da obiskovalec zaključi postopek. Z dogodki se odzovite na naslednje dogajanje.
Možnosti
| Ime | Vrsta | Privzeto | Opis |
|---|---|---|---|
checkoutMode | niz | vrednost primerka | 'pane' ali 'popup' samo za to rezervacijo. |
clientContext | objekt | null | Poljubni podatki, predani nakupnemu postopku, ko je pripravljen. Glejte spodaj. |
collectConsent | logična vrednost | vrednost primerka | Ali obiskovalca vprašati, naj sprejme obvestilo o pogojih. |
backdrop | logična vrednost | vrednost primerka | Ali zatemniti stran za nakupnim postopkom. |
backdropColor | niz | vrednost primerka | Barva zatemnjenega območja. |
pane | objekt | vrednost primerka | { width, height } za vdelano podokno. |
popup | objekt | vrednost primerka | { width, height } za pojavno okno. |
Vse, kar izpustite, se vrne na vrednost, s katero je bil primerek ustvarjen, zato se možnosti posameznega klica dodajajo, namesto da bi predstavljale nadomestni nabor.
entase.book('EVENT_ID', {
pane: { width: '60vw' },
backdrop: false,
clientContext: { source: 'homepage-hero' }
});Kontekst odjemalca
clientContext je objekt po vaši zasnovi. Odjemalec ga hrani, dokler nakupni postopek ne sporoči, da je pripravljen, nato pa mu ga preda. Uporabite ga za prenos informacij, ki jih pozna samo vaša stran – kateri gumb je bil kliknjen, prek katere kampanje je obiskovalec prišel, notranja referenca stranke – v sejo nakupnega postopka.
Kontekst se shrani za vsak ID dogodka posebej, zato pri rezervaciji dveh različnih dogodkov z iste strani njuna konteksta ostaneta ločena.
Vanjo ne vnašajte občutljivih podatkov. Do nakupnega postopka potuje prek brskalnika in je viden vsakomur, ki pregleda stran.
Odpiranje več dogodkov z ene strani
En primerek obravnava poljubno število dogodkov. Ustvarite ga enkrat in vsakič posredujte drug ID:
const entase = new Entase({ pk: 'YOUR_PUBLISHABLE_KEY' });
document.querySelectorAll('[data-event-id]').forEach(button => {
button.addEventListener('click', () => {
entase.book(button.dataset.eventId, {
clientContext: { source: button.dataset.source }
});
});
});Ko je odjemalec uničen
Klic book() na primerku, ki ste ga že uničili, zapiše napako v konzolo in ne odpre ničesar. To je namerno – uničen primerek ne posluša več sporočil iz nakupnega postopka, zato okna, ki ga je odprl, ne bi bilo mogoče zapreti ali spremljati. Namesto tega ustvarite nov primerek.
Zapiranje nakupnega postopka
Obiskovalec nakupni postopek zapre sam: s tipko Escape ali klikom na zatemnjeno območje v načinu podokna oziroma s kontrolniki okna v pojavnem načinu. Nakupni postopek se zapre tudi sam, ko je rezervacija dokončana.
Ni javne metode za zapiranje iz vaše kode. Če morate vedeti, kdaj se je zaprl, poslušajte dogodek checkout.closed.