WordPress плагин VK Community Messages

Установка

1. Скачайте последнюю стабильную версию в zip-архиве.
2. Распакуйте архив, переименуйте папку в mihdan-vk-community-messages и зазуипуйте её обратно.
3. Перейдите в Плагины -> Добавить новый -> Загрузить новый.
4. Загрузите скачанный архив.
5. Перейдите в Плагины и активируйте установленный плагин.

Настройка

На текущий момент плагин проходит стадию активной разработки, поэтому в нем отсутствует страница с настройками, но эти самые настройки можно задать через фильтр mihdan_vk_community_messages_options внутри вашей темы в файле functions.php:

add_filter( 'mihdan_vk_community_messages_options', function( $options ) {

	// Тут переопределяем дефолтные настройки, например:
	$options['welcomeScreen'] = true;

	// Возвращаем новые настройки
	return $options;
} );

// Массив дефолтных настроек выглядит так:
$options = array(
	'onCanNotWrite' => 'function() {}',
	'welcomeScreen' => false,
	'expandTimeout' => 0,
	'expanded' => 0,
	'widgetPosition' => 'right',
	'buttonType' => 'blue_circle',
	'disableButtonTooltip' => false,
	'tooltipButtonText' => 'Ответим на любые ваши вопросы',
	'disableNewMessagesSound' => false,
	'disableExpandChatSound' => false,
	'disableTitleChange' => false,
);

Где $options — опции блока с виджетом. Массив, который может содержать поля:

• onCanNotWrite (function) — функция, которая будет вызвана, если пользователь по каким-то причинам не может писать сообщения;
• welcomeScreen (integer, [0,1]) — информация о том, нужно ли показывать экран приветствия (1 — да, 0 — нет);
• expandTimeout (integer) — интервал до раскрытия виджета в миллисекундах. Обратите внимание, при обновлении страницы сохраняется состояние виджета — если он уже раскрыт пользователем, этот параметр не применяется.
• expanded (integer, [1]) — 1, если нужно раскрыть виджет сразу;
• widgetPosition (string) — выравнивание кнопки (left или right);
• buttonType (string) — внешний вид кнопки (no_button или blue_circle);
• disableButtonTooltip (integer, [1]) — 1, если нужно отключить всплывающую подсказку;
• tooltipButtonText (string) — текст всплывающей подсказки;
• disableNewMessagesSound (integer, [1]) — 1, если нужно отключить звук о новом сообщении;
• disableExpandChatSound (integer, [1]) — 1, если нужно отключить звук при раскрытии виджета;
• disableTitleChange (integer, [1]) — 1, если нужно отключить изменение заголовка страницы, когда приходит новое сообщение.

Комментарии, пулл реквесты, ишью приветствуются.