Відкриття оформлення замовлення · JavaScript-клієнт

book() – це метод, який відкриває оформлення замовлення. Усе інше в клієнті налаштовує або відстежує його.

JavaScript

entase.book(eventID);
entase.book(eventID, options);

eventID – це ідентифікатор запланованого заходу, квитки на який продаються. Це той самий ідентифікатор, що використовується в кодах поширення та вбудовування вашого заходу.

Виклик повертає результат негайно – він відкриває панель або вікно й не чекає, доки відвідувач завершить оформлення. Використовуйте події, щоб реагувати на подальші дії.

Параметри

Назва	Тип	Типове значення	Опис
`checkoutMode`	рядок	значення екземпляра	`'pane'` або `'popup'` лише для цього бронювання.
`clientContext`	об’єкт	`null`	Довільні дані, що передаються до оформлення замовлення, щойно воно буде готове. Дивіться нижче.
`collectConsent`	логічне значення	значення екземпляра	Чи просити відвідувача прийняти повідомлення про умови.
`backdrop`	логічне значення	значення екземпляра	Чи затемнювати сторінку за оформленням замовлення.
`backdropColor`	рядок	значення екземпляра	Колір затемненої області.
`pane`	об’єкт	значення екземпляра	`{ width, height }` для вбудованої панелі.
`popup`	об’єкт	значення екземпляра	`{ width, height }` для спливного вікна.

Усі пропущені параметри використовують значення, з яким було створено екземпляр, тому параметри окремого виклику доповнюють, а не замінюють набір параметрів.

JavaScript

entase.book('EVENT_ID', {
  pane: { width: '60vw' },
  backdrop: false,
  clientContext: { source: 'homepage-hero' }
});

Контекст клієнта

clientContext – це об’єкт, структуру якого визначаєте ви. Клієнт зберігає його, доки оформлення замовлення не повідомить, що воно готове, а потім передає його. Використовуйте його для передавання до сеансу оформлення замовлення інформації, відомої лише вашій сторінці – яку кнопку було натиснуто, з якої кампанії прийшов відвідувач, внутрішній ідентифікатор клієнта.

Контекст зберігається окремо для кожного ідентифікатора заходу, тому бронювання двох різних заходів з однієї сторінки зберігає їхні контексти окремими.

Не додавайте до нього конфіденційну інформацію. Він передається до оформлення замовлення через браузер і видимий кожному, хто перевіряє сторінку.

Відкриття кількох заходів з однієї сторінки

Один екземпляр обробляє будь-яку кількість заходів. Створіть його один раз і щоразу передавайте інший ідентифікатор:

JavaScript

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 }
    });
  });
});

Після знищення клієнта

Виклик book() для екземпляра, який ви вже знищили, записує помилку в консоль і нічого не відкриває. Це зроблено навмисно – знищений екземпляр більше не отримує повідомлень від оформлення замовлення, тому відкрите ним вікно не можна було б закрити або відстежувати. Натомість створіть новий екземпляр.

Закриття оформлення замовлення

Відвідувач закриває оформлення замовлення самостійно: клавішею Escape або натисканням затемненої області в режимі панелі, елементами керування вікна в режимі спливного вікна. Оформлення замовлення також закривається автоматично після завершення бронювання.

Загальнодоступного методу для закриття з вашого коду немає. Якщо вам потрібно знати, коли його закрито, відстежуйте подію checkout.closed.