Виджет встраивается в сайт путем вставки 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 | ник клиента |
Если в коде вставки виджета указать 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) |
