Логика открытия виджета
Виджет чата Webim открывается одним из двух способов: в окне чата на текущей странице сайта или в отдельном окне чата (/visitor/chat). Способ открытия виджет выбирает при загрузке, при старте чата и при изменении его состояния.
Если нужно, чтобы чат был развёрнут сразу при загрузке страницы или при переходе по специальной ссылке, см. Как открыть страницу сайта сразу с развёрнутым чатом.
Чат открывается в отдельном окне, если выполнена первая группа условий или вторая. Внутри группы условия соединены через «и».
Первая группа:
-
На странице сайта в объекте
webimзадано истинное значениеchatInSeparateWindow— см. Опция виджетаchatInSeparateWindow. -
Виджет загружен не в отдельном окне чата — см. Уже открытое отдельное окно чата.
-
Режим виджета — не
preview.
Режим определяется при загрузке виджета. Он берётся из параметра адреса страницы webim-invitation-mode, а если параметра нет — из поля mode объекта webim в коде кнопки. Если не задано ни то, ни другое, режим — standard. Режим preview задан в превью редактора размещений Панели управления: там в объекте webim указано mode: 'preview'. Служебные режимы cobrowsing и off на выбор отдельного окна не влияют. Отдельной проверки Internet Explorer в режиме Quirks в текущей версии виджета нет.
Вторая группа:
-
Браузер считается мобильным — см. Мобильный браузер.
-
В account config параметр
open_chat_in_new_tab_for_mobileвключён (true). -
Виджет загружен не в отдельном окне чата — см. Уже открытое отдельное окно чата.
Режим preview ограничивает только первую группу. На вторую группу он не влияет: если в мобильном браузере задан режим preview, при включённом open_chat_in_new_tab_for_mobile чат открывается в отдельном окне. В превью Панели управления этого не происходит: там задано smallScreen: false, и браузер мобильным не считается.
Если ни одна группа не выполнена, чат открывается в окне чата на текущей странице.
Опция виджета chatInSeparateWindow
chatInSeparateWindow — внутренняя опция виджета. Она задаётся в объекте webim в коде кнопки на странице сайта. К настройкам размещения она не относится. Виджет копирует её из этого объекта при загрузке:
webim = {
accountName: "companyname",
domain: "companyname.webim.ru",
location: "default",
chatInSeparateWindow: true
};
Значение true удовлетворяет первому условию первой группы. Код кнопки вставляется на сайт по инструкции установки виджета.
В коде виджета сохранилась проверка настройки размещения chat.inSeparateWindow = "Y" как альтернативы chatInSeparateWindow. Сервер не передаёт это поле в виджет, поэтому на практике проверка не срабатывает.
N.B.
Добавление или редактирование параметра chatInSeparateWindow в объекте webim является единственным санкционированным вендором изменением сниппета кода. Любые другие правки сниппета не допускаются, корректная работа системы при внесении изменений не гарантируется.
Мобильный браузер
Виджет считает браузер мобильным по следующим правилам:
-
Если в объекте
webimзадан параметрsmallScreenс логическим значением, используется оно. В отдельном окне чата (/visitor/chat) его выставляет параметр адресаsmall-screen:1— мобильный браузер,0— нет. Явноеfalseотключает признак мобильного браузера: ширина окна и платформа в этом случае не проверяются. -
Если
smallScreenне задан, браузер мобильный, когда выполняется хотя бы одно из условий:-
ширина окна не больше 1024 пикселей в альбомной ориентации (
landscape); -
ширина окна не больше 768 пикселей в книжной ориентации (
portrait); -
платформа iOS (
navigator.platform—iPhone,iPadилиiPod) или iPadOS (navigator.platformравенMacIntel, аnavigator.maxTouchPointsбольше 2).
-
Результат проверки запоминается до перезагрузки страницы. Поворот устройства или изменение размера окна после загрузки на него не влияют.
На обычной странице сайта smallScreen обычно не задан, поэтому срабатывают проверки ширины окна и платформы.
Уже открытое отдельное окно чата
Отдельное окно чата (/visitor/chat) при загрузке выставляет webim.separateChatWindow = true. Если виджет загружен в нём и это не режим iframe (webim.chatInIframeMode), виджет считает, что отдельное окно уже открыто, и повторно его не создаёт: диалог продолжается в текущем окне. При этом неважно, идёт диалог или нет: проверяются только флаги страницы.
Режим iframe включается автоматически: если /visitor/chat загружена во фрейме, страница перезагружается с параметром iframe-mode=true. Подробнее об установке чата в iframe — в статье Процедура установки чата Webim на сайт в iframe.
В режиме iframe флаг separateChatWindow на это решение не влияет: чат в iframe отдельным окном чата не считается. Поэтому на смартфоне или небольшом планшете чат из iframe при open_chat_in_new_tab_for_mobile = true открывается в отдельном окне. Признак мобильного экрана в iframe передаёт родительская страница параметром адреса small-screen. Она проверяет ширину устройства (max-device-width: не больше 1024 пикселей в альбомной ориентации и не больше 768 пикселей в книжной), а не ширину окна (max-width), как при обычной проверке мобильного браузера.
Параметр open_chat_in_new_tab_for_mobile
Параметр account config open_chat_in_new_tab_for_mobile имеет тип Boolean и значение по умолчанию true. При true в мобильном браузере чат открывается в отдельном окне (вторая группа условий). При false вторая группа не выполняется, и на мобильном устройстве чат открывается в окне чата на текущей странице, если не выполнены условия первой группы. Изменить параметр можно в редакторе настроек account config.
Адрес отдельного окна чата
Отдельное окно чата открывается по адресу из параметра account config client_php_url. Если параметр пуст, виджет подставляет базовый URL аккаунта и путь /visitor/chat.
Перед повторным открытием виджет закрывает окно, которое он открыл ранее с этой же страницы, и открывает новое. В мобильном браузере чат открывается в новой вкладке (_blank). В остальных браузерах окно получает имя webim_chat_<имя аккаунта>. Если после перезагрузки страницы сайта ссылка на прежнее окно потеряна, браузер загрузит чат в уже открытое окно с этим именем, а не создаст новое.