Иногда нужно менять отображение виджета в зависимости от страницы, на которой находится пользователь. Например, скрывать виджет с мессенджерами и соцсетями на странице технической поддержки или, наоборот, раскрывать виджет на странице с оплатой, чтобы показать пользователю, что он может легко обратиться за помощью через удобный канал связи.
Для управления виджетом на странице используйте метод OmniWidgetApi.call('[parameter]'), у которого есть следующие параметры:
hide_btn — скрыть кнопку виджета;
show_btn — показать кнопку виджета;
open — раскрыть виджет;
close — свернуть виджет;
open_widget — открыть форму отправки email-запроса;
close_widget — свернуть форму отправки email-запроса;
identify — заполнить поля формы обратной связи по почте;
reset — очистить поля формы обратной связи по почте.
Если у вас размещено несколько виджетов на странице, вы можете управлять каждым из них в отдельности, указывая через точку id виджета после параметра. Например:
OmniWidgetApi.call('hide_btn.3225')
Чтобы получить список id-виджетов, которые есть на странице, используйте метод:
OmniWidgetApi.call('get_list')
Также получить id виджета можно через код основного скрипта (только числовое значение до дефиса):
Посмотреть, как именно работают разные параметры метода, можно здесь:
Если действие выполняется автоматически при загрузке страницы, рекомендуется вызывать метод после полной инициализации виджета. К примеру, чтобы виджет загружался в раскрытом состоянии, после основного скрипта добавьте этот код:
<script>
omni[0].email_widget.ready(function () {
OmniWidgetApi.call('open')
})
</script>