Η book() είναι η μέθοδος που ανοίγει το checkout. Όλα τα υπόλοιπα στοιχεία στον client το ρυθμίζουν ή παρακολουθούν τη λειτουργία του.
entase.book(eventID);
entase.book(eventID, options);Το eventID είναι το αναγνωριστικό της προγραμματισμένης εκδήλωσης για την οποία θα πωληθούν εισιτήρια. Είναι το ίδιο αναγνωριστικό που χρησιμοποιείται στους κώδικες κοινοποίησης και ενσωμάτωσης της εκδήλωσής σας.
Η κλήση επιστρέφει αμέσως – ανοίγει το πλαίσιο ή το παράθυρο και δεν περιμένει να ολοκληρώσει ο επισκέπτης. Χρησιμοποιήστε τα συμβάντα για να αντιδράσετε σε ό,τι συμβεί στη συνέχεια.
Επιλογές
| Όνομα | Τύπος | Προεπιλογή | Περιγραφή |
|---|---|---|---|
checkoutMode | string | τιμή instance | 'pane' ή 'popup' μόνο για αυτή την κράτηση. |
clientContext | object | null | Αυθαίρετα δεδομένα που παραδίδονται στο checkout μόλις είναι έτοιμο. Δείτε παρακάτω. |
collectConsent | boolean | τιμή instance | Αν θα ζητηθεί από τον επισκέπτη να αποδεχτεί την ειδοποίηση όρων. |
backdrop | boolean | τιμή instance | Αν θα γίνεται σκίαση της σελίδας πίσω από το checkout. |
backdropColor | string | τιμή instance | Χρώμα της σκιασμένης περιοχής. |
pane | object | τιμή instance | { width, height } για το ενσωματωμένο πλαίσιο. |
popup | object | τιμή instance | { width, height } για το αναδυόμενο παράθυρο. |
Οτιδήποτε παραλείψετε χρησιμοποιεί την τιμή με την οποία κατασκευάστηκε το instance, επομένως οι επιλογές ανά κλήση είναι προσθετικές και όχι ένα σύνολο αντικατάστασης.
entase.book('EVENT_ID', {
pane: { width: '60vw' },
backdrop: false,
clientContext: { source: 'homepage-hero' }
});Περιβάλλον πελάτη
Το clientContext είναι ένα αντικείμενο δικού σας σχεδιασμού. Ο client το διατηρεί μέχρι το checkout να σηματοδοτήσει ότι είναι έτοιμο και έπειτα το παραδίδει. Χρησιμοποιήστε το για να μεταφέρετε πληροφορίες που γνωρίζει μόνο η σελίδα σας – ποιο κουμπί έγινε κλικ, από ποια καμπάνια ήρθε ένας επισκέπτης, μια εσωτερική αναφορά πελάτη – στη συνεδρία checkout.
Το περιβάλλον αποθηκεύεται ανά αναγνωριστικό εκδήλωσης, επομένως η κράτηση δύο διαφορετικών εκδηλώσεων από την ίδια σελίδα διατηρεί τα περιβάλλοντά τους ξεχωριστά.
Μην τοποθετείτε σε αυτό οτιδήποτε ευαίσθητο. Μεταφέρεται στο checkout μέσω του προγράμματος περιήγησης και είναι ορατό σε οποιονδήποτε επιθεωρεί τη σελίδα.
Άνοιγμα πολλών εκδηλώσεων από μία σελίδα
Ένα instance διαχειρίζεται οποιονδήποτε αριθμό εκδηλώσεων. Δημιουργήστε το μία φορά και περνάτε κάθε φορά διαφορετικό αναγνωριστικό:
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 }
});
});
});Μετά την καταστροφή του client
Η κλήση της book() σε ένα instance που έχετε ήδη καταστρέψει καταγράφει ένα σφάλμα στην κονσόλα και δεν ανοίγει τίποτα. Αυτό είναι σκόπιμο – ένα κατεστραμμένο instance δεν ακούει πλέον μηνύματα από το checkout, επομένως το παράθυρο που άνοιξε δεν θα μπορούσε να κλείσει ή να παρακολουθηθεί. Δημιουργήστε αντί γι’ αυτό ένα νέο instance.
Κλείσιμο του checkout
Ο επισκέπτης κλείνει ο ίδιος το checkout: με Escape ή με κλικ στη σκιασμένη περιοχή στη λειτουργία pane, ή με τα στοιχεία ελέγχου του παραθύρου στη λειτουργία pop-up. Το checkout κλείνει επίσης μόνο του όταν ολοκληρωθεί μια κράτηση.
Δεν υπάρχει δημόσια μέθοδος για να το κλείσετε από τον κώδικά σας. Αν χρειάζεται να γνωρίζετε πότε έκλεισε, παρακολουθήστε το συμβάν checkout.closed.