book() ist die Methode, die den Checkout öffnet. Alles andere im Client konfiguriert oder überwacht ihn.
entase.book(eventID);
entase.book(eventID, options);eventID ist die Kennung der geplanten Veranstaltung, für die Tickets verkauft werden sollen. Es ist dieselbe ID, die in den Freigabe- und Einbettungscodes Ihrer Veranstaltung verwendet wird.
Der Aufruf wird sofort zurückgegeben – er öffnet das Panel oder Fenster und wartet nicht, bis der Besucher fertig ist. Verwenden Sie Ereignisse, um auf das zu reagieren, was als Nächstes passiert.
Optionen
| Name | Typ | Standard | Beschreibung |
|---|---|---|---|
checkoutMode | Zeichenfolge | Instanzwert | 'pane' oder 'popup' nur für diese Buchung. |
clientContext | Objekt | null | Beliebige Daten, die an den Checkout übergeben werden, sobald dieser bereit ist. Siehe unten. |
collectConsent | Boolean | Instanzwert | Ob der Besucher aufgefordert werden soll, den Hinweis zu den Bedingungen zu akzeptieren. |
backdrop | Boolean | Instanzwert | Ob die Seite hinter dem Checkout abgedunkelt werden soll. |
backdropColor | Zeichenfolge | Instanzwert | Farbe des abgedunkelten Bereichs. |
pane | Objekt | Instanzwert | { width, height } für das Inline-Panel. |
popup | Objekt | Instanzwert | { width, height } für das Pop-up-Fenster. |
Alles, was Sie weglassen, übernimmt den Wert, mit dem die Instanz erstellt wurde. Optionen pro Aufruf ergänzen diese daher, statt sie vollständig zu ersetzen.
entase.book('EVENT_ID', {
pane: { width: '60vw' },
backdrop: false,
clientContext: { source: 'homepage-hero' }
});Client-Kontext
clientContext ist ein Objekt nach Ihrem eigenen Entwurf. Der Client speichert es, bis der Checkout signalisiert, dass er bereit ist, und übergibt es dann. Verwenden Sie es, um Informationen, die nur Ihre Seite kennt – welche Schaltfläche angeklickt wurde, über welche Kampagne ein Besucher gekommen ist, eine interne Kundenreferenz – an die Checkout-Sitzung weiterzugeben.
Der Kontext wird pro Veranstaltungs-ID gespeichert. Wenn Sie also zwei verschiedene Veranstaltungen von derselben Seite aus buchen, bleiben ihre Kontexte getrennt.
Legen Sie keine vertraulichen Daten darin ab. Sie werden über den Browser an den Checkout übertragen und sind für jeden sichtbar, der die Seite untersucht.
Mehrere Veranstaltungen von einer Seite aus öffnen
Eine Instanz verarbeitet beliebig viele Veranstaltungen. Erstellen Sie sie einmal und übergeben Sie jedes Mal eine andere 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 }
});
});
});Nachdem der Client zerstört wurde
Wenn Sie book() bei einer Instanz aufrufen, die Sie bereits zerstört haben, wird ein Fehler in der Konsole protokolliert und nichts geöffnet. Das ist beabsichtigt – eine zerstörte Instanz lauscht nicht mehr auf Nachrichten vom Checkout, sodass das von ihr geöffnete Fenster weder geschlossen noch überwacht werden könnte. Erstellen Sie stattdessen eine neue Instanz.
Den Checkout schließen
Der Besucher schließt den Checkout selbst: mit Escape oder durch einen Klick auf den abgedunkelten Bereich im Panel-Modus, über die Fenstersteuerelemente im Pop-up-Modus. Der Checkout schließt sich auch selbst, wenn eine Buchung abgeschlossen ist.
Es gibt keine öffentliche Methode, um ihn über Ihren Code zu schließen. Wenn Sie wissen müssen, wann er geschlossen wurde, lauschen Sie auf das Ereignis checkout.closed.