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

Виджет встраивается в сайт путем вставки JS кода в HTML код Вашего сайта.

Код
<!-- Start SiteHeart code -->
<script>
(function(){
// your widget ID
var widget_id = 1;
_shcp = [{widget_id : widget_id}]; 
// set default language
var lang = (navigator.language || navigator.systemLanguage 
	|| navigator.userLanguage ||  "en")
	.substr(0, 2).toLowerCase();
// script url
var url  = "widget.siteheart.com/widget/sh/" + widget_id + "/" 
  +  lang + "/widget.js"; 
var hcc = document.createElement("script"); 
hcc.type = "text/javascript"; 
hcc.async = true; 
hcc.src = ("https:" == document.location.protocol ? "https" : "http") 
  +   "://" + url; 
var s = document.getElementsByTagName("script")[0]; 
s.parentNode.insertBefore(hcc, s.nextSibling);
})();
</script>
<!-- End SiteHeart code -->

Настроить виджет можно в административной панели https://admin.siteheart.com/settings/widget/edit

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

Например:

На данной странице виджет будет отображаться вверху.

_shcp = [{widget_id : 1, side : ‘top’}];
Таблица параметров
Параметр Значение Описание
side right | left | top | bottom Положение кнопки
position top | center | bottom при side = left | right
left | center | right при side = top | bottom
Сдвиг кнопки
template red | green | blue | dark | orange | pink | purple Шаблон темы
divisions true | false Отображать или нет меню с выбором отдела перед началом диалога
hide true | false Скрывать виджет или нет когда есть доступные (online) операторы
hide_offline true | false Скрывать виджет или нет когда нет доступных (offline) операторов
invite_image URL картинки, которая будет отображаться в автопригашении
invite_text Текст автоприглашения
invite_timeout 1...100000000 Время в миллисекундах, через которое посетителю будет показано автоприглашение в чат
text_layout trans Раскладка текста на кнопке
title Текст кнопки, когда есть доступные (online) операторы
title_offline Текст кнопки когда нет доступных (offline) операторов
track true | false Включить или отключить мониторинг посетителей
track_widget true | false Включить или отключить отображение счетчика посетителей сайта на кнопке. Доступно только если track=true
autostart true | false Запускать чат автоматически, когда посетитель заходит на страницу
w_type embed Отображать виджет встроенным в страницу.
w_selector #element_id jQuery селектор элемента, в который будет добавлен блок с виджетом чата. Только если w_type=embed
callback function Функция, которая будет вызвана после того,как виджет будет загружен и готов к работе. Функция принимает параметр, который будет содержать в себе экземпляр виджета.
auth Дополнительная информация о клиенте см.подробнее.
Стили

Виджет спроектирован таким образом, чтобы его можно было адаптировать к стилям Вашего сайта. Вы можете изменить практически все элементы, настроить шрифт, цвет, размер, отступы, фон, границы и т.д. Единственный элемент,который запрещается изменять это copyright (ссылка на siteheart.com).
Для того чтобы изменить стили элемента, Вам нужно просто переопределить основные стили виджета. Сделать это очень просто. Вам нужно в CSS файле Вашего сайта прописать нужный селектор и задать для него стили с высшим приоритетом используя слово important.

Например,чтобы изменить цвет кнопки пропишите в css:

.sh_btn{ 
   background-color: #4d90fe!important;
}
Таблица стилей
Селектор Описание
.sh_btn кнопка виджета
.sh_btn_right кнопка виджета справа(возможные варианты: sh_btn_top, sh_btn_bottom, sh_btn_right, sh_btn_left)
.sh_btn_right_center кнопка виджета справа по центру
.sh_chat виджет
.sh_header шапка виджета
.sh_hico_close иконка закрыть виджет
.sh_hico_popup иконка развернуть виджет
.sh_hico_hide иконка скрыть виджет
.sh_input поле формы input
.sh_textarea поле формы textarea
.sh_mess_text текст сообщения
.sh_mess_time время сообщения
.sh_button_gray_complete кнопка завершить
.sh_ic_smiles иконка смайлы
.sh_ic_sound иконка sound
.sh_ic_attach иконка прикрепить файл
.sh_button_back кнопка назад
.sh_mess_nick_sel ник оператора
.sh_mess_nick ник клиента
JavaScript API

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

_shcp = [{widget : “Chat”, callback : function(chat){ } }];

Используя экземпляр виджета chat можно подписаться на разные события, изменять их и отменять. Например:

callback = function(chat){
   // не показывает, что оператор подключился к диалогу
   chat.on("clientRoomSellerAccepted", function(data){ 
         return false; 
   });
		
   // вызывается когда клиент закрывает окно чата
   chat.on("eventJSWidgetExit", function(){
	  $('#embed_chat').hide();  
   });
};
Таблица событий
Событие Описание
enterpriseOnline Отдел онлайн, диалог создан.
clientRoomSellerAccepted Первый оператор подключился к диалогу
clientRoomSellerClosed Оператор завершил диалог
clientMessage Сообщение оператора
clientPostEdit Сообщение оператора отредактировано
chatAutoMessage Сообщение робота
clientNewBill Выставлен новый счет
clientBillDone Счет оплачен
Form Выставлена форма
enterpriseOffline Отдел оффлайн, нет доступных операторов
sellerRoomInvite Оператор пригласил другого оператора к диалогу
clientTyping Оператор печатает сообщение
inviteGuest Оператор приглашает клиента в чат
eventJSWidgetShow Клиент открыл виджет чата
eventJSWidgetExit Клиент закрыл виджет чата (exit)