Перейти к основному содержимому
Версия: 4.11-refactoring

Настройка виджета

<script type="text/javascript">
var widget = new IQChannelsWidget({
channel: 'support',
credentials: 'some user secret',
mode: 'web', // web || mobile
project: 'my-project',
width: 280,
padBody: true,
requireName: false,
DOMIdentifier: 'chat-widget-button',
chats: [
{ channel: 'support', credentials: 'user-token' },
{ channel: 'sales' }
],
imgModalOptions: {
enabled: true,
state: 'web'
},
handlers: {
onLinkClick: function (type, value) {
console.log('Клик по ссылке', type, value);
}
},
url: 'https://app.iqstore.ru/widget/'
});
</script>

Параметры:

  • mode — режим работы виджета web или mobile, по умолчанию web, в мобильном режиме отключается открытие файлов в новых вкладках браузера.
  • width — ширина виджета в пикселях.
  • padBody — автоматическое добавление паддинга к тегу body при открытии виджета.
  • requireName — выключает требование представиться у анонимного клиента.
  • project — сегмент, к которому подключается виджет; используется, когда сервер обслуживает несколько сегментов.
  • DOMIdentifier — id DOM-контейнера, внутрь которого помещается кнопка виджета; если не указан, кнопка добавляется на страницу стандартно.
  • chats — список чатов для режима мультичата: массив объектов {channel, credentials}; при непустом списке виджет работает с несколькими чатами одновременно.
  • imgModalOptions — настройки встроенного просмотра изображений: enabled — включить или выключить просмотрщик, state — режим просмотрщика, web или mobile.
  • handlers.onLinkClick — обработчик клика по ссылке в сообщении; принимает тип ссылки URL, PHONE или EMAIL и её значение. По умолчанию ссылки открываются в новой вкладке, телефоны и почтовые адреса — через tel: и mailto:.
  • iconOptions — настройки отображения кнопки виджета (устаревшая опция).
  • iconOptions.show — отображать кнопку или нет.
  • iconOptions.style — дополнительные CSS-стили для кнопки.
  • iconOptions.color — цвет иконки.
  • iconOptions.backgroundColor — цвет фона кнопки.
  • enableImgModals — включение встроенного просмотра изображений (устаревшая опция, используйте imgModalOptions).
  • url — опциональный адрес сервера с виджетом, если не указан, то определяется автоматически.

Для более глубокой стилизации виджета см. Стилизация виджета.