Установка виджета

Для включения виджета на сайте достаточно разместить единственную строчку (сгенерированную для этого в настройках виджета) внутри тегов <body>...</body>.
Например: <script id = "mygarage_widget" async src = "https://bt.mygarage.pro/mygarage_garage_widget.js" num = "widget_id"></script>,
где widget_id - уникальный идентификатор клиента.

Большинство остальных настроек доступны в личном кабинете виджета и представляют собой выбор необходимых параметров по одному клику.

Дополнительная настройка виджета

Управление виджетом с помощью специальных JavaScript-функций доступно для всех клиентов.
Используя эти настройки вы сможете:

Список дополнительных функций

Для работы дополнительные функции необходимо поместить внутри следующей JavaScript конструкции, если они не обозначены как отдельные:
<script>function mygarage_init(mygarage) { //... }</script>
Располагать данный код рекомендуется после основной строки загрузки виджета.

Например:
<script>
  function mygarage_init(mygarage) {
    mygarage.push_button_chat = function(){ main_chat.open(); };
    mygarage.lang_change("en");
  }
</script>
  <button onclick="mygarage.map_form_open()">Открыть карту</button>
(отдельная функция)


mygarage.callback_form_open(); - отдельная функция открытия окна обратного звонка.


mygarage.vin_form_open(); - отдельная функция открытия окна запроса по VIN.


mygarage.garage_form_open(); - отдельная функция открытия окна для Гаража.


mygarage.map_form_open(); - отдельная функция открытия окна c картой.


mygarage.button_on_the_list_off(tag); - отключение любой кнопки виджета при загрузке по следующим значениям tag:
'chat': чат.
'callback': обратный вызов.
'call': позвонить.
'map': показать на карте.
'telegram': написать в телеграм.
'vk': написать в ВКонтакте.
'viber': написать в Viber.
'whatsapp': написать в WhatsApp.
Например: mygarage.button_on_the_list_off('map'); mygarage.button_on_the_list_off('chat'); (отключение кнопок с чатом и картой)


mygarage.phone_number_change(phone); - назначение номера телефона для кнопки "Позвонить".
phone: номер телефона.
Например: mygarage.phone_number_change('8(900)000-00-00');


mygarage.link_vk_change(url); - назначение ссылки для кнопки "Написать в ВКонтакте".
url: адрес ссылки.
Например: mygarage.link_vk_change('vk.com/...');


mygarage.name_change(name); - заполнение формы с именем пользователя по умолчанию.
name: имя.
Например: mygarage.name_change('Имя пользователя');


mygarage.mail_change(mail); - заполнение формы с адресом E-mail пользователя по умолчанию.
mail: адрес электронной почты.
Например: mygarage.mail_change('E-mail');


mygarage.vin_change(num); - подстановка номера VIN по умолчанию.
num: VIN-номер.
Например: mygarage.vin_change('00000000000000000');


mygarage.frame_change(num); - подстановка номера FRAME по умолчанию.
num: FRAME-номер.
Например: mygarage.frame_change('XXXXXX-0000000');


mygarage.user_phone_change(phone); - подстановка пользовательского номера телефона по умолчанию.
phone: номер телефона.
Например: mygarage.user_phone_change('8(900)000-00-00');


mygarage.user_can_edit_change(num); - определяет, может ли пользователь изменять данные в полях, где эти данные подставлены по умолчанию.
num: 0 (разрешено) или 1 (запрещено).
Например: mygarage.user_can_edit_change(0);


mygarage.map_label_change(coord_x,coord_y,point,desc); - установка данных для отображения метки на карте.
coord_x: географическая широта.
coord_y: географическая долгота.
point: надпись над меткой.
desc: описание, выводимое под картой.
Например: mygarage.map_label_change('0.00000000','0.00000000','Название метки','Описание метки');


mygarage.user_variable_set(name,value); - добавление дополнительных данных к отправке (в формате название-значение передаваемой величины).
name: название.
value: значение.
Например: mygarage.user_variable_set('Параметр 1','0000'); mygarage.user_variable_set('Параметр 2','XXXX');


mygarage.lang_change(lang); - установка указанного языка для виджета.
lang: ru (Русский), en (Английский) или de (Немецкий).
Например: mygarage.lang_change('en');


mygarage.push_button_chat = function(){ //... }; - позволяет прикрепить собственный скрипт к кнопке "Написать в чат".
Например: mygarage.push_button_chat = function(){ main_chat.open(); };


<div class="mygarage_section"></div> - вывод пользовательских авто из Гаража виджета с передачей выбранных значений сайту.
В месте вставки данной строки в коде сайта формируется блок с выбором машин из Гаража. Демонстрируемый контент подстраивается под размеры этого блока, которые можно устанавливать стандартными средствами.
При выборе в блоке данные могут приниматься в отдельную функцию:
<script>function mygarage_car_selected(data,fnum){ //... }</script>
data: значение в формате объекта вида {brand: "", model: "", vin: "", frame: "", car_id: ""}.
data.brand: бренд, например "BMW".
data.model: модель, например "X5 (E70) 2007-2013".
data.vin: VIN-номер(если есть).
data.frame: FRAME-номер(если есть).
data.car_id: внутренний номер авто в Гараже виджета.
fnum: порядковый номер блока, установленного на сайте, в котором произведен выбор.