Обзор · JavaScript-клиент

JavaScript-клиент Entase – это небольшая библиотека, которую вы загружаете из нашей CDN. Он даёт вашему сайту возможность, недоступную ему самостоятельно: открывать оформление заказа Entase прямо на странице, чтобы посетитель мог купить билет, не покидая текущую страницу.

Он управляет панелью или всплывающим окном, фоном, блокировкой прокрутки страницы, этапом согласия, локалью и параметрами отслеживания. Ваш код определяет, когда открывать оформление заказа и для какого события.

Чем он не является

Клиент не отображает списки событий, даты, цены или доступность. Если вам нужен готовый виджет с вашей программой, используйте коды встраивания – их достаточно скопировать и вставить, и они не требуют разработки. См. Встраивание событий на ваш сайт.

Однако это не альтернативы друг другу. Виджет встраивания использует тот же клиент для открытия оформления заказа, поэтому вы можете передавать параметры клиента через конфигурацию встраивания. См. Расширенные параметры встраивания.

Когда его использовать

Используйте клиент напрямую, если у вас есть собственные страницы событий и вы хотите, чтобы ваша кнопка «Купить билеты» открывала оформление заказа Entase:

HTML

<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 клиент всегда использует всплывающее окно.
Ваш домен добавлен в доверенные источники в разделе «Настройки» → «Интеграции», если вы хотите использовать встроенное оформление заказа. См. Интеграции и настройка оформления заказа.
Не требуются этап сборки, бандлер или менеджер пакетов. Библиотека подключается одним тегом script.

Что дальше

Установка клиента – загрузка скрипта и создание экземпляра.
Параметры конструктора – все параметры и их значения по умолчанию.
Открытие оформления заказа – метод book() и переопределения для отдельных вызовов.
События – реакция на открытие, закрытие и завершение оформления заказа.