Инструкция по 👨💻 установке:
-
👇 Скачать:- Сконфигурируйте и скачайте 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: Для продажи товаров вместо билетов укажитеtruebank: Для открытия страницы банка в новом окне укажитеtrue
- Конструктор URL
-
Для работы виджета в формате листинга событий, измените адрес ссылки на:
<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: Для продажи товаров вместо билетов укажитеtruebank: Для открытия страницы банка в новом окне укажитеtrue
- Конструктор URL
-
-
💎 Для того, что бы виджет открывался во всплывающем окне:-
Вставьте следующий код в контейнер
<head>страницы:<script src="/widget/lib/cdn/jquery-3.5.1.min.js"></script>
<script src="/widget/lib/modernizr-custom.js"></script>
<script src="/widget/lib/cdn/jquery.fancybox-3.5.7.min.js"></script>
<link rel="stylesheet" href="/widget/lib/cdn/jquery.fancybox-3.5.7.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" …
-
Желаем ⏰ быстрой установки и 💰 успешной работы!!!
Кнопки для 🛴 тестирования:
Сочи
Афиша города
- ТЕСТОВАЯ ЗОНА: 1139
- Русский язык
Samara
Events
- ТЕСТОВАЯ ЗОНА: 1139
- Английский язык
Կրասնոդար
Պաստառ
- ТЕСТОВАЯ ЗОНА: 1139
- Армянский язык
- Банк в новом окне
Событие
29 апреля
- ТЕСТОВАЯ ЗОНА: 1139
- Русский язык
- Сеансы
- Схема зала
- Входные билеты
- Тарифы
Экскурсия
3 сентября
- ТЕСТОВАЯ ЗОНА: 1139
- Русский язык
- Сеансы
- Схема зала
- Входные билеты
- Тарифы
Football
12 december
- ТЕСТОВАЯ ЗОНА: 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
- Русский язык
- Сеансы
- Схема зала
- Входные билеты
- Тарифы
Что ⚡ нового, обновления 🔥 :
Обратите внимание
-
⏱ 27 Ноября 2024 v2.313🎖 Изменён URL API.
-
⏱ 10 Июня 2024 v2.v2.222🎖 Добавлено время сеанса в кнопку даты, если сеанс один.
-
⏱ 2 Мая 2024 v2.312 + v2.221🐞 Исправлен баг подключения сторонних библиотек в связи с блокировкой сайтаcdn.jsdelivr.net.
Внимание!
Теперь все сторонние библиотеки расположены локально.
В связи с этим изменился код для вставки в контейнер<head>
-
⏱ 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для кабинета пользователя.