Виджет BIL24 | BIL24 web widget

Скачать

Инструкция по 👨‍💻 установке:

👇 Скачать:
- Сконфигурируйте и скачайте Zip-архив
- Распакуйте Zip-архив
- Если необходимо - переименуйте полученную папку, по умолчанию она имеет имя /widget, далее в примерах используется именно это имя
🧘‍♂️ Разместить на сайте:
- Поместите папку /widget в корневую директорию вашего сайта (не обязательно того, где будет открываться виджет)
- Проверьте видна ли папка widget через браузер: https://your-site/widget (если всё в порядке, вы увидите крутящиеся шестерёнки)
🎭 Формат работы:
- Для работы виджета в формате одного события, сформируйте ссылку следующего вида:
  
  <a href="/widget/#/ ?frontendId=1111 &token=55a7a636b26fbb3c3956 &id=122 &cityId=1">Текст ссылки</a>
  - Конструктор URL 🧩 для одного события
  Полный список GET-параметров:
  - frontendId: FID (Обязательный)
  - token: Token (Обязательный)
  - zone: Режим работы (Обязательный для продакшн real, по умолчанию test)
  - id: ID события (Обязательный)
  - cityId: ID города (Обязательный)
  - venueId: ID площадки (Обязательный, если событие проходит на разных площадках в одном городе)
  - agr: Адрес страницы пользовательского соглашения (Необязательный)
  - success: Адрес страницы успешной покупки (По умолчанию /widget/success/)
  - fail: Адрес страницы неудачной покупки (По умолчанию /widget/fail/)
  - lng: Язык интерфейса (По умолчанию en)
  - goods: Для продажи товаров вместо билетов укажите true
  - bank: Для открытия страницы банка в новом окне укажите true
- Для работы виджета в формате листинга событий, измените адрес ссылки на:
  
  <a href="/widget/city/#/ …
  - Конструктор URL 🧩 для листинга событий
  Список GET-параметров для листинга событий:
  - frontendId: FID (Обязательный)
  - token: Token (Обязательный)
  - zone: Режим работы (Обязательный для продакшн real, по умолчанию test)
  - cityId: ID города (Обязательный)
  - venueId: ID площадки (Необязательный)
  - kindId: ID вида события (Необязательный)
  - agr: Адрес страницы пользовательского соглашения (Необязательный)
  - success: Адрес страницы успешной покупки (По умолчанию /widget/success/)
  - fail: Адрес страницы неудачной покупки (По умолчанию /widget/fail/)
  - lng: Язык интерфейса (По умолчанию en)
  - goods: Для продажи товаров вместо билетов укажите true
  - bank: Для открытия страницы банка в новом окне укажите true
💎 Для того, что бы виджет открывался во всплывающем окне:
- Вставьте следующий код в контейнер <head> страницы:
  
  <script src="https://cdn.jsdelivr.net/npm/jquery@3.5.1/dist/jquery.min.js"></script>
  <script src="/widget/lib/modernizr-custom.js"></script>
  <script src="https://cdn.jsdelivr.net/gh/fancyapps/fancybox@3.5.7/dist/jquery.fancybox.min.js"></script>
  <link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/fancyapps/fancybox@3.5.7/dist/jquery.fancybox.min.css"/>
  <script>$(document).ready(function(){$(document).on('click','.widget-trigger',function(e){if(Modernizr.mq('(min-width:1280px)')){e.preventDefault();$.fancybox.open({src:$(this).attr('href'),type:'iframe',opts:{iframe:{css:{width:'90vw',height:'80vh'}}}})}})})</script>
- Добавьте к тегу a класс и дополнительный атрибут:
  
  <a class="widget-trigger" data-fancybox-type="iframe" …

Желаем ⏰ быстрой установки и 💰 успешной работы!!!

Кнопки для 🛴 тестирования:

Событие

29 апреля

Купить билет

ТЕСТОВАЯ ЗОНА: 1139
Русский язык
Сеансы
Схема зала
Входные билеты
Тарифы

Экскурсия

3 сентября

Купить билет

ТЕСТОВАЯ ЗОНА: 1139
Русский язык
Сеансы
Схема зала
Входные билеты
Тарифы

Football

12 december

Buy tickets

ТЕСТОВАЯ ЗОНА: 1139
Английский язык
Сеансы
Схема зала
Входные билеты
Тарифы

Вход

1 января

Купить билет

ТЕСТОВАЯ ЗОНА: 1139
Русский язык
Сеансы
Схема зала
Входные билеты
Тарифы

ТЕСТ КДП

1 июня - 7 мая

Купить билет

ТЕСТОВАЯ ЗОНА: 1139
Русский язык
Сеансы
Схема зала
Входные билеты
Тарифы
КДП

Мышата и Луна

5 августа

Купить билет

ТЕСТОВАЯ ЗОНА: 1233
Русский язык
Сеансы
Схема зала
Входные билеты
Тарифы

We The Fest 2028

Festival

Купить билет

ТЕСТОВАЯ ЗОНА: 1233
Русский язык
Сеансы
Схема зала
Входные билеты
Тарифы

Онлайн консультация Алины Макрон

WhatsApp AUTH 2.0
попробовать

Купить билет

ТЕСТОВАЯ ЗОНА: 1236
Русский язык
Сеансы
Схема зала
Входные билеты
Тарифы
Товар

Посещение Музея Фаберже

Вход AUTH 2.0
попробовать

Купить билет

ТЕСТОВАЯ ЗОНА: 1185
Русский язык
Сеансы
Схема зала
Входные билеты
Тарифы

Тест Fan ID

Я против! AUTH 2.0
попробовать

Купить билет

ТЕСТОВАЯ ЗОНА: 1139
Русский язык
Сеансы
Схема зала
Входные билеты
Тарифы
Карта болельщика

Экскурсия на Плесецкие водопады

Juli AUTH 2.0
попробовать

Купить билет

ТЕСТОВАЯ ЗОНА: 1233
Английский язык
Сеансы
Схема зала
Входные билеты
Тарифы

Кнопки для 🚀 тестирования в продакшне:

Футболка BIL24 Classic, черная

Товар

Купить

РЕАЛЬНАЯ ЗОНА: 1756
Русский язык
Сеансы
Схема зала
Входные билеты
Тарифы
Товар

Знамя — Спартак-Тамбов

5 мая AUTH 2.0
попробовать

Купить билет

РЕАЛЬНАЯ ЗОНА: 1756
Русский язык
Сеансы
Схема зала
Входные билеты
Тарифы

Что ⚡ нового, обновления 🔥:

Обратите внимание ⚠️ на версию виджета 🤷🏼‍♀️ 🤦‍♀️ для которой выпущено обновление!

⏱ 21 Сентября 2023 v2.311
- 🐞 Исправлен баг php в коде виджета data-source.
⏱ 8 Сентября 2023 v2.310
- 🐞 Исправлен баг дублирования времени сеанса.
⏱ 9 Июня 2023 v2.307
- 🎖 Добавлено время сеанса в кнопку даты, если сеанс один.
⏱ 8 Июня 2023 v2.306 + v2.220
- 📌 Изменен принцип кэширования переводов.
  Теперь переводы кэшируются в рамках версии виджета.
⏱ 8 Июня 2023 v2.219
- 📌 Изменены файлы переводов.
⏱ 7 Июня 2023 v2.305
- 🐞 Исправлен баг пользовательского соглашения.
  Теперь при переходе между страницами ссылка на Пользовательское соглашение не теряется.
⏱ 6 Июня 2023 v2.304 + v2.218
- 🎖 Изменен принцип расчета лимитов по категориям.
  Теперь внутри общего лимита билетов можно использовать разное количество для каждой категории.
  Не очень понятно, но очень ☝ полезно!
- 📌 Изменены файлы переводов.
- 🐞 Исправлен баг с отправкой письма подтвержедния email.
⏱ 5 Июня 2023 v2.303 + v2.217
- 🎖 Изменена система локализации виджета.
  Теперь язык виджета определяется согласно следующим приоритетам:
  — Из параметра lng (если он определен и язык присутствует в списке доступных);
  — Из настроек браузера пользователя(если язык присутствует в списке доступных);
  — По умолчанию en.
- 📌 Изменены файлы переводов.
⏱ 20 Апреля 2023 v2.302
- 🐞 Исправлена сортировка сеансов.
- 📌 В виджет добавлены страницы - результаты успешной и неуспешной оплаты по умолчанию.
  Параметры success и fail по-прежнему можно указать в адресе ссылки.
- 📌 Параметр agr теперь не является обязательным.
  В случает отсутствия параметра agr в меню не будет ссылки Соглашение, также в корзине не потребуется подтверждение ознакомления с пользовательским соглашением.
⏱ 18 Апреля 2023 v2.301
- 🐞 Устранён конфликт виджета Авторизации и Яndex метрики.
⏱ 14 Апреля 2023 v2.300
- 🎖 Изменен процесс Авторизации.
  Начиная с версии v2.300 авторизация присходит по упрощенной схеме. Вместо кода подтверждения пользователю на email приходит ссылка. На сегодняшний день BIL24 поддерживает обе схемы авторизации, но мы рекомендыем использовать новую.
- ✂ Удалена реализация методов: BIND_EMAIL, CONFIRM_EMAIL для авторизации пользователя.
- 📌 Добавлено взаимодействие с виджетом Авторизация 2.0.
  Попробуйте новую авторизацию для событий со значком AUTH 2.0
⏱ 12 Апреля 2023 v2.216
- 📌 Изменен принцип сортировки входных категорий.
  Категории сортируются по алфавиту.
⏱ 7 Апреля 2023 v2.215
- 📌 Добавлен файл /README.md
- 📌 Добавлен файл /custom/README.md
⏱ 6 Апреля 2023 v2.214
- 🐞 Усовершенстован механизм хранения Сессии пользователя.
  Мы разделили авторизацию в тестой- и продакш- зонах. Теперь при переключении между зонами никаких ошибок доступа вы не увидите.
- ✂ Удалена поддержка аудиогидов Orpheo.
⏱ 5 Апреля 2023 v2.213
- 🎖 Изменена Система обновления виджета.
  При обновлении просто замените все папки в виджете кроме /custom, содержащей ваши персональные настройки.
- 📌 Добавлена возможность встроить пользовательский JS-код в тег <head>.
  Полезно для размещения на странице виджета кода метрики.
- 📌 Добавлена возможность встроить пользовательский JS в отдельный файл.
  Теперь можно добавить свой JS-код в файл, и он не пропадёт при обновлении виджета.
- 📌 Добавлена возможность встроить пользовательский CSS в отдельный файл.
  Все ваши стили теперь тоже в полной безопасности, обновляйте виджет не боясь потерять персональный дизайн.
- 📌 Все языковые настройки вынесены в отдельный файл.
- 🎖 Создана Система обработки пользовательских событий.
  Мы собрали стек наиболее интересных пользовательских событий и дали вам возможность назначить им произвольные обработчики. Это поможет вам создать конверсионную воронку, а следовательно, повысить продажи.
- 📌 Добавлен обработчик события BIND_EMAIL.
- 📌 Добавлен обработчик события CONFIRM_EMAIL.
- 📌 Добавлен обработчик события RESERVE.
- 📌 Добавлен обработчик события UN_RESERVE.
- 📌 Добавлен обработчик события BASKET.
- 📌 Добавлен обработчик события UN_RESERVE_ALL.
- 📌 Добавлен обработчик события CREATE_ORDER.
- 🐞 Изменен метод получения Кабинета пользователя.
  Теперь при открытии кабинета пользователя виджет отправляет в 4 раза меньше запросов к билетной системе, что сказывается на скорости работы и уменьшает нагрузку на билетныю систему.
- 📌 Добавлена реализация метода GET_USER_INFO.
- ✂ Удалена реализация методов: GET_ORDERS, GET_ACTION_EVENTS_GROUPED_BY_TICKETS, GET_PROMO_CODES, GET_MECS для кабинета пользователя.