#1108: Параметры инициализации виджетов

Симптомы

Какие есть параметры инициализации виджета и в какой последовательности они применяются?

Решение

Встраиваемые виджеты в Swarmica могут быть настроены в соответствии с требуемым пользовательским опытом в том приложении, куда виджет встраивается.

Порядок применения

Настройки для параметров применяются по следующей логике:

Настройки пользователя, которые он/она задали в своем профиле Swarmica (например, язык)
Параметры, переданные в URL встраивания (см. пример ниже, значения в src после знака ?)
Настройки, заданные администратором Swarmica в настройках соответствующего канала
Настройки по умолчанию

Пример кода встраивания виджета:

<!-- start embedded Swarmica widget script -->
  <iframe src="https://your.swarmica.domain/widgets/index.html?id=123qwe&locale=ru&auth_provider=email&button_color=%23dc0d1d&telegram_link=https%253A%252F%252Ft.me%252Fswarmica&open=true&page=new_chat" id="123qwe" style="position: fixed; right: 12px; bottom: 12px; width: 56px; height: 56px; overflow: hidden; "
    allowTransparency="true"
    frameborder="0"
    allowTransparency="true" frameborder="0"></iframe>
  <script src="https://your.swarmica.domain/widgets/render.js"></script>
  <script>
    const iframe = document.getElementById("123qwe")
    iframe.onload = () => {
      renderWidget("123qwe")
    }
  </script>
  <!-- end embedded Swarmica widget scripts -->

Доступные параметры

Параметр	Значение по умолчанию	Возможные значения
locale - язык интерфейса	en	en, ru
auth_provider - провайдер авторизации по умолчанию	email	email - авторизация по email + password, code - авторизация по otp коду, для такого варианта необходимо еще передавать параметр otpdata, anonymous - без авторизации
button_color - цвет кнопки открытия виджета	#93BEE6	HEX код цвета
telegram_link - ссылка на канал в Telegram	не установлено	ссылка на телеграм, если не установлено - выбор опции Телеграм не отображается в виджете
open - открывать или нет виджет сразу	false	true - открывать виджет сразу, false - отображать только кнопку
fullscreen - разворачивать виджет на весь экран без возможности свернуть	false	true - разворачивать на весь экран, false - показывать сворачиваемым окошком
page - стартовая страница виджета	не установлено	chats - список чатов, last_chat - последний открытый чат, new_chat - новый чат. Если не установлено, то первая страница - это выбор приложения внутри виджета