Клієнт Entase JavaScript — це невелика бібліотека, яку ви завантажуєте з нашої CDN. Він дає вашому вебсайту можливість, якої той не має самостійно: відкривати оформлення замовлення Entase безпосередньо на місці, щоб відвідувач міг придбати квиток, не залишаючи поточну сторінку.
Він керує панеллю або спливним вікном, фоном, блокуванням прокручування сторінки, кроком надання згоди, мовою та параметрами відстеження. Ваш код визначає, коли відкривати оформлення замовлення і для якої події.
Чим він не є
Клієнт не відображає переліки подій, дати, ціни чи доступність. Якщо вам потрібен готовий віджет із вашою програмою, скористайтеся натомість кодами вбудовування — їх достатньо скопіювати й вставити, і вони не потребують розробки. Див. Вбудовування подій на ваш вебсайт.
Однак це не альтернативи одне одному. Віджет вбудовування використовує цей самий клієнт для відкриття оформлення замовлення, тому ви можете передавати параметри клієнта через конфігурацію вбудовування. Див. Розширені параметри вбудовування.
Коли його використовувати
Використовуйте клієнт безпосередньо, якщо у вас є власні сторінки подій і ви хочете, щоб ваша кнопка «Купити квитки» відкривала оформлення замовлення Entase:
<button id="buy">Buy tickets</button>
<script src="https://js.entase.com/client.js"></script>
<script>
const entase = new Entase({ pk: 'YOUR_PUBLISHABLE_KEY' });
document.getElementById('buy').addEventListener('click', () => {
entase.book('EVENT_ID');
});
</script>На цьому інтеграцію завершено. Усе інше в цьому розділі — уточнення: які параметри доступні, як оформлення замовлення обирає між панеллю та спливним вікном і які події ви можете відстежувати.
Два режими оформлення замовлення
Оформлення замовлення відкривається одним із двох способів:
- Панель — вбудована панель на вашій сторінці, яка виїжджає справа на комп’ютері та знизу на мобільних пристроях. Відвідувач не залишає ваш сайт.
- Спливне вікно — окреме вікно браузера.
Режим панелі забезпечує кращий досвід, але доступний лише для доменів, які ви додали як довірені джерела у налаштуваннях Entase. Клієнт визначає, який із режимів дозволено використовувати, і переходить до спливного вікна, якщо вбудоване оформлення замовлення не дозволене. Це найважливіша особливість, яку слід зрозуміти перед інтеграцією — див. Режими оформлення замовлення.
Вимоги
- Сторінка, що працює через HTTPS. За звичайного HTTP клієнт завжди використовує спливне вікно.
- Ваш домен, доданий до довірених джерел у Налаштування → Інтеграції, якщо ви хочете використовувати вбудоване оформлення замовлення. Див. Інтеграції та налаштування оформлення замовлення.
- Без етапу збірки, бандлера чи менеджера пакетів. Бібліотека складається з одного тегу скрипту.
Що далі
- Встановлення клієнта — завантаження скрипту та створення екземпляра.
- Параметри конструктора — усі параметри та їхні значення за замовчуванням.
- Відкриття оформлення замовлення — метод
book()і перевизначення для окремих викликів. - Події — реакція на відкриття, закриття та завершення оформлення замовлення.