О приложении

Виджет Fluwid (Flutter widget, флюид) – это веб-приложение, созданное для продажи билетов, товаров и услуг, загруженных в платформу BIL24. Виджет реализован на фреймфорке Flutter – инновационном инструменте Google для разработки мобильных, десктопных и веб-приложений.

Технологии

Flutter/Dart, CanvasKit.

Fluwid использует технологию отображения схем MChain, которая разработана BIL24 для отображения схем с большим количеством мест (больше 5000), и удобной навигации по ним.

Версии:

v3.5.0 - Актуальная версия, скачать


18.03.2025 v3.5.0 - Интерфейс виджета обновлен до Material3 (Стандарт Google для оформления приложений и интерфейсов). Добавлены новые режимы работы виджета - режим города и полного описания события (подробнне в разделе "Query-параметры").

28.12.2024 v3.0.1 - Применено мажорное обновление. Отрисовака схем работает по координатам x,y (GET_SCHEMA) и поддерживает svg декорации в полном объеме.

03.12.2024 v2.0.0 - Применено мажорное обновление. Полностью обновлен процесс отрисовки схем для повышения скорости загрузки и плавности работы виджета на мобильных устройствах.

Установка

Размещение виджета Fluwid на хостинге

Виджет Fluwid - это автономное веб-приложение, все программные данные которого содержатся в одной директории.

Чтобы виджет работал, необходимо распаковать zip-архив и поместить полученную директорию с названием fluwid в корневой каталог сайта.

Если директорию fluwid планируется расположить НЕ в корневом каталоге, то следует указать путь до этой директории в теге <base href="/fluwid/"> в файле fluwid/index.html.
Например, чтобы разместить виджет в папке directory_name, измените путь на <base href ="/directory_name/fluwid/">.

Конфигурация ссылки

Для работы виджета в режиме события, требуется ссылка определенного вида:

{путь до виджета} + {обязательные query-параметры} + {необязательные query-параметры}

https://{путь до виджета}/fluwid/?zone=test&frontendId=1111&token=1111111111fffffff&id=1&cityId=1&необязательные_параметры

Пример url для Fluwid в режиме события:
https://bil1.pro/fluwid/web/?id=889&cityId=5&frontendId=1233&token=caa3a6062ed7fb87ca58&zone=test&lng=ru&hint=off

Пример url для Fluwid в режиме события с полным описанием:
https://bil1.pro/fluwid/web/?id=889&cityId=5&cityMode=standalone&frontendId=1233&token=caa3a6062ed7fb87ca58&zone=test&lng=ru&hint=off

Пример url для Fluwid в режиме города:
https://bil1.pro/fluwid/web/?id=889&cityId=5&cityMode=on&frontendId=1233&token=caa3a6062ed7fb87ca58&zone=test&lng=ru&hint=off

Список Query-параметров:

Query-параметры виджета, указываются в любом порядке

id – actionId, id события (Обязательный);

cityId – id города (Обязательный);

agr - адрес страницы пользовательского соглашения (Необязательный);

frontendId – интерфейс (fid) (Обязательный);

token – токен интерфейса (Обязательный);

zone - режим работы (реальная зона - real, тестовая - test) (Обязательный);

fail - адрес страницы пользовательского соглашения (Необязательный);

success - aдрес страницы успешной покупки (Необязательный);

*Если fail/ success не заданы - используются страницы успешной/неуспешной покупки из виджета.

cityMode - если равно "on", то включается режим работы виджета, отображающий все доступные представления в городе. Если равно "standalone" и задан параметр id события, то включается режим, отображающий полное описание события с ссылкой на покупку билетов (Необязательный)

schemeStyle - стиль сеткторов (закрашенный - "fill", обводка - "stroke", по умолчанию - "fill") (Необязательный)

lng - язык интерфейса (По умолчанию определяется локаль браузера, поддерживает локали ru и en) (Необязательный);

hint - если равно "off", то подсказка о бронировании входных билетов не будет отображена (Необязательный);

date – режим отображения дат или валюты на кнопках сеансов. Если равно "off", то отображается валюта (Необязательный);

available - если равно "off", то на карточках категорий входных билетов не отображается количество оставшихся билетов (Необязательный);

promo – если равно on включается возможность ввода до 10 промокодов в корзине. (Необязательный);

decorations – если равно "off", svg декорации не будут отображены. (Необязательный);

hull – если равно "off", упрощенное отображение секторов схем будет отключено (Необязательный);

*С помощью отключения параметров decorations и/или hull можно настраивать желаемое отображение схем или улучшать их производительность. Например на устаревших и малопроизводительных мобильных устройствах отключение декораций svg (decorations=off) сокращает количество фриззов и джанков при работе со схемой

seatMode – если равно "theatre", в качестве мест на схеме отображаются сиденья. Может быть применимо для схем в кино, театрах и т.д. (Необязательный);

sectorName - если равно "off", названия секторов не будут отображены. (Необязательный);

Примеры событий в тестовой зоне платформы BIL24

Vivaldano the show (Театр Гиберния)

Cocteau Twins (ВТБ - Арена Динамо)

Нагрузочное тестирование (Лужники)

A Midsummer Night's Dream (Мариинский театр)

Кастомизация

Интерфейс виджета по умолчанию окрашен в палитру цветов BIL24, для кастомных версий виджета может быть применена любая другая версия палитры заказчика.