Открытие формы виджета

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

Используя функцию открытия формы виджета Вы сможете:

• настроить показ формы по каким-либо событиям на сайте (скролл, наведение курсора на определенную область, открытие/закрытие какой-либо другой формы и так далее);
• привязать открытие формы к своим встроенным кнопкам;
• с помощью настроек мультикнопки открывать избранные формы виджетов, если загружено более одного виджета определенного типа.

Показывает форму виджета или одного из виджетов мультикнопки, которые подошли под настройки условий и графика показа для текущий страницы.

Сигнатура функции

window.ct('modules', 'widgets', 'openExternal', widgetType, callback);

widgetType — определяет какой тип виджета показать, принимает одно из значений:

• callback — обратный звонок;
• request — умная заявка;
• calltovisit — CallToVisit;
• chat — чат;
  
• trade-in — виджет Трейд-ин;
  
• wheel-fortune — виджет Колесо фортуны;
  
• promo-banner — виджет Промо-баннер.
  

callback — функция обратного вызова, которая будет вызвана после успешного открытия кнопки или ошибки вида

function (result) {}

result — это объект вида:

{
error: <boolean>
errorCode: <string|null>
errorMessage: <string|null>
}
   

• error — true если была ошибки, false если форма успешно показалась;
• errorCode — если error - true код ошибки иначе null;
• errorMessage — если error - true сообщение ошибки иначе null.

Возможные ошибки:

• OPENED — на странице уже открыта форма виджета;
• NOT_FOUND — вызываемая форма виджета, который не показан на странице или не существует.

Вызывает показ формы одного из виджетов мультикнопки, которые подошли под настройки условий и графика показа для текущий страницы.

В настройках виджетов с формой расположено поле "Ключ виджета", с помощью которого можно вызвать открытие определенной формы виджета.

Поле ввода ключа редактируемое, по умолчанию подставляется значение, равное типу виджета.

Сигнатура функции

window.ct('modules', 'widgets', 'openExternal', widgetKey, callback);

widgetKey определяет какую форму виджета показать, принимает значение, заданное в настройках виджета.

callback функция обратного вызова, которая будет вызвана после успешного открытия кнопки или ошибки вида

function (result) {}

result это объект вида:

{
error: <boolean>
errorCode: <string|null>
errorMessage: <string|null>
}
   

• error — true если была ошибки, false если форма успешно показалась;
• errorCode — если error - true код ошибки иначе null;
• errorMessage — если error - true сообщение ошибки иначе null.

Возможные ошибки:

• OPENED — на странице уже открыта форма виджета;
• NOT_FOUND — вызываемая форма виджета, который не показан на странице или не существует.

Открытие формы виджетов по ссылке

С помощью данной функции вы сможете настроить открытие формы каждого доступного виджета по ссылке.

Формат ссылки:

site.ru/?widgetKey={ключ виджета}
   

Как настроить?

• В виджете должно быть доступно поле: "Ключ виджета".
  


• Ключ виджета может быть уникальный для всех виджетов или общий для группы виджетов, что позволяет вносить различные корректировки в виджеты, не меняя ссылку. 

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

Где применимо?

• E-mail рассылка. Например, вы можете настроить акционную рассылку с розыгрышем, а из письма направить на сайт с автоматическим открытием Колеса Фортуны.
  


• Использование перехода на форму трейд-ин через QR-код, который можно разместить на стойке информации в салоне или листовке. При сканировании клиент увидит форму трейд-ин с персонализированным заголовком.

Если Вам необходимо настроить открытие определенной формы виджета при клике на определенный элемент, необходимо воспользоваться функцией ниже. Например, функция для открытия формы виджета обратного звонка будет выглядеть так:

window.ct('modules', 'widgets', 'openExternal', 'callback');
   

Ниже представлен пример открытия формы виджета обратного звонка при клике на кнопку "Перезвоните мне". Для этого можно использовать событие "onclick".

Тогда HTML код данного элемента будет иметь вид:

<input type="button" value="Перезвоните мне" onclick="window.ct('modules','widgets','openExternal','callback')">

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

• виджет 1:

window.ct('modules', 'widgets', 'openExternal', 'callback_1');

• виджет 2:

window.ct('modules', 'widgets', 'openExternal', 'callback_2');

Если необходимо добавить открытие определенной формы в HTML код, то вызов можно оформить так:

<input type="button" value="Записаться на осмотр!" onclick="window.ct('modules','widgets','openExternal','callback_1')">

<input type="button" value="Записаться на консультацию!" onclick="window.ct('modules','widgets','openExternal','callback_2')">