Установка онлайн чата на сайт WordPress

Перед тем как установить онлайн чат SAN на сайт, на базе CMS WordPress, необходимо зарегистрироваться в системе и подключить домен, на который устанавливается чат-консультант, в Личном кабинете.

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

Мы рекомендуем установить чат на сайт с помощью нашего плагина. Данный плагин подключает JS скрипт в секции <head>, и позволяет выводить чат на определенных страницах сайта.

Установка плагина с онлайн чатом SAN

Загрузите плагин SAN_consultant.zip Загрузить
Войдите в административный интерфейс WordPress Вашего сайта. Для этого нужно перейти по адресу: ваш_сайт.ru/wp-admin. (Данный адрес может быть другим в зависимости от настроек)
На вкладке Плагины, выберите пункт Добавить новый
Откроется страница "Добавить плагины". Нажмите кнопку Загрузить плагин
Нажмите на кнопку Обзор..., выберите загруженный плагин SAN_consultant.zip и нажмите Установить
После установки, нажмите Активировать плагин
Готово. Кнопка чата-консультанта будет отображаться на всех страницах сайта.

Настройка плагина

При необходимости работы онлайн чата на определенных страницах, необходимо выполнить настройку плагина. Система может показать предупреждение о том, уверенны ли вы в том, что делаете. Нажимаем "Да".

На вкладке Плагины, выберите пункт Редактор плагинов
Откроется страница "Изменение плагинов". Выберите плагин для изменения SAN_consultant, и нажмите кнопку Выбрать
Откроется содержимое файла, с комментариями, содержащими инструкции по настройке.
По умолчанию плагин будет подключать JS скрипт чата на всех страницах сайта. Вы можете воспользоваться одним из двух вариантов: показывать чат на определенных страницах, либо показывать чат на всех страницах кроме выборочных.
В файле имеются два массива: Включенные страницы ($included_pages) и Исключенные страницы ($excluded_pages). В соответствующие массивы нужно добавить ID страниц. Например, нужно отображать чат на страницах с ID 1, 24 и 17. Для этого редактируем строку: $included_pages = array(1, 24, 17); После внесения изменений, нажмите "Обновить файл".
ID страниц можно узнать на вкладке Страницы. Если навести указатель мыши на нужную страницу из списка, в углу окна браузера отобразится ссылка на данную страницу. Параметр "post=8" (тут 8 - для примера, у вас может быть другим) укажет на ID страницы.

Также кликнув на требуемую страницу можно открыть её для редактирования. В строке запроса браузера будет ID данной страницы. Например: ваш_сайт.ru/wp-admin/post.php?post=8&action=edit. В данном примере ID страницы 8 (post=8).
На своё усмотрение, вы можете добавить атрибуты async/defer у итогового тега script. Для этого снимите комментарий с блок async/defer:

Редактирование темы сайта

Установить чат на сайт WordPress, отредактировав файл темы сайта, менее предпочтительный способ, но вы тоже можете им воспользоваться. Важно помнить, что в данном случае, если тема (шаблон) сайта обновляется, автоматически или самостоятельно, то после обновления, файл темы будет перезаписан, и вам придется делать всё заново.

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

На вкладке Внешний вид, выберите пункт Редактор тем
Выберите тему для изменения. Далее файл Основной шаблон. В редакторе откроется файл основного шаблона (как правило, это index.php)
Скопируйте строчку HTML кода:

Копировать

<script src="https://san-consultant.ru/st/st_clients/js/san_bbc.js" async></script>

Разметите этот код внутри тега <head>.

<!--index.php-->
<html>
	<head>
		...
		...
		<script src="https://san-consultant.ru/st/st_clients/js/san_bbc.js" async></script>
	</head>

Обновите файл. Готово.

Вы можете не использовать атрибут async тега "script", это не обязательно. Async указывает браузеру, что скрипт может выполнятся асинхронно.

Подключение скрипта онлайн чата в коде

Что бы добавить чат на сайт WordPress, достаточно подключить единственный файл javascript. Для этого используется функция wp_enqueue_script(), которая добавляет файл скрипта и зависимости единожды, тем самым предотвращая возможные конфликты.

Подключить скрипт можно (но очень не желательно), в файле functions.php, который находится в каталоге /wp-includes/ или в файле functions.php вашей темы, находящийся в /wp-content/themes/ваша_тема/. Как и в случае редактирования темы сайта, путем изменения файлов самой темы (шаблона), очередное обновление перезапишет все файлы темы, включая functions.php, и ваш код будет удален.

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

Рассмотрим пример создания небольшого плагина.

В каталоге wp-content/plugins/ создайте каталог, например с названием "my_plugin". Имя Каталога должно быть уникальным и понятным.

В созданном каталоге "my_plugin", создайте файл с таким же названием (это считается хорошей практикой)my_plugin.php, со следующим содержимым:

<?php
/**
 * Plugin Name: my_plugin
 * Description: Онлайн чат
 * Author: Имя Автора
 */

function include_script_san_consultant() {	
	wp_enqueue_script('san_consultant', 'https://san-consultant.ru/st/st_clients/js/san_bbc.js');
}
add_action('wp_enqueue_scripts', 'include_script_san_consultant');
?>

Во вкладке Плагины, появится новый плагин my_plugin
Нажмите Активировать. Готово.

Данный плагин будет подключать js скрипт на все страницы сайта. Функция add_action привязывает нашу функцию "include_script_san_consultant" к действию "wp_enqueue_scripts". Функция "wp_enqueue_script" регистрирует скрипт "https://san-consultant.ru/st/st_clients/js/san_bbc.js".

Комментарии в приведенном примере обязательны. Они несут в себе специальную информацию для WordPress.