book() on kassan avaava metodi. Kaikki muu asiakkaassa joko määrittää sen asetuksia tai seuraa sitä.
entase.book(eventID);
entase.book(eventID, options);eventID on myytävän aikataulutetun tapahtuman tunniste. Se on sama tunniste, jota käytetään tapahtumasi jako- ja upotuskoodissa.
Kutsu palautuu välittömästi – se avaa paneelin tai ikkunan eikä odota, että kävijä viimeistelee varauksen. Reagoi seuraaviin tapahtumiin tapahtumien avulla.
Asetukset
| Nimi | Tyyppi | Oletus | Kuvaus |
|---|---|---|---|
checkoutMode | merkkijono | instanssin arvo | Vain tälle varaukselle 'pane' tai 'popup'. |
clientContext | objekti | null | Mielivaltainen data, joka välitetään kassalle, kun se on valmis. Katso alta. |
collectConsent | totuusarvo | instanssin arvo | Kysytäänkö kävijää hyväksymään ehtoilmoitus. |
backdrop | totuusarvo | instanssin arvo | Himmennetäänkö kassan takana oleva sivu. |
backdropColor | merkkijono | instanssin arvo | Himmennetyn alueen väri. |
pane | objekti | instanssin arvo | Upotetun paneelin { width, height }. |
popup | objekti | instanssin arvo | Ponnahdusikkunan { width, height }. |
Kaikki pois jättämäsi asetukset palautuvat instanssia luotaessa määritettyihin arvoihin, joten kutsukohtaiset asetukset täydentävät asetuksia eivätkä korvaa niitä.
entase.book('EVENT_ID', {
pane: { width: '60vw' },
backdrop: false,
clientContext: { source: 'homepage-hero' }
});Asiakaskonteksti
clientContext on itse määrittelemäsi objekti. Asiakas säilyttää sitä, kunnes kassa ilmoittaa olevansa valmis, ja välittää sen sitten kassalle. Sen avulla voit välittää kassasessioon tietoja, jotka vain sivusi tietää – mitä painiketta napsautettiin, minkä kampanjan kautta kävijä saapui, sisäinen asiakasviite.
Konteksti tallennetaan tapahtumatunnistekohtaisesti, joten kahden eri tapahtuman varaaminen samalta sivulta pitää niiden kontekstit erillään.
Älä laita siihen mitään arkaluonteista. Se kulkee selaimen kautta kassalle ja on kaikkien sivua tarkastelevien nähtävissä.
Useiden tapahtumien avaaminen yhdeltä sivulta
Yksi instanssi käsittelee minkä tahansa määrän tapahtumia. Luo se kerran ja anna sille eri tunniste joka kerta:
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 }
});
});
});Kun asiakas on tuhottu
Jos kutsut book()-metodia instanssissa, jonka olet jo tuhonnut, konsoliin kirjataan virhe eikä mitään avata. Tämä on tarkoituksellista – tuhottu instanssi ei enää kuuntele kassan viestejä, joten sen avaamaa ikkunaa ei voisi sulkea tai seurata. Luo sen sijaan uusi instanssi.
Kassan sulkeminen
Kävijä sulkee kassan itse: Escape-näppäimellä tai napsauttamalla himmennettyä aluetta paneelitilassa, tai ponnahdusikkunatilassa ikkunan säätimillä. Kassa sulkeutuu myös itse, kun varaus valmistuu.
Sitä ei voi sulkea koodistasi julkisella metodilla. Jos haluat tietää, milloin se sulkeutui, kuuntele checkout.closed-tapahtumaa.