Главная » Документация » Joomla » Модули » Документация: Виджет чата с сообществом ВКонтакте для Joomla от iws.by

Документация: Виджет чата с сообществом ВКонтакте для Joomla от iws.by

Дата обновления документации: 28.09.2025

Документация актуальна для версии: 1.1.3

Совместимость

Системные требования

Системные требования отличается для Joomla 3, Joomla 4, Joomla 5 и Joomla 6, поэтому, обратите внимание на раздел, соответствующий вашей версии.

Joomla 3

Joomla: 3.0.0 - 3.10.x.
PHP: 5.3 и выше.
MySQL: 5.1 и выше.
MariaDB: 10.1 и выше.
PostgreSQL: 8.3.18 и выше.
Виртуальная память: 128Мб и выше.

Joomla 4

Joomla: 4.0.0 - 4.x.x.
PHP: 7.2 и выше.
MySQL: 5.6 и выше.
MariaDB: 10.3.35 и выше.
PostgreSQL: 11.0 и выше.
Виртуальная память: 128Мб и выше.

Joomla 5 и Joomla 6

Joomla: 5.0.0 - 5.x.x. / 6.0.0 - 6.x.x.
PHP: 8.1 и выше.
MySQL: 8.0.11 и выше.
MariaDB: 10.4 и выше.
PostgreSQL: 12.0 и выше.
Виртуальная память: 128Мб и выше.

Установка модуля

Процесс установки модуля немного отличается для Joomla 3 и Joomla 4/5/6, поэтому, обратите внимание на раздел, соответствующий вашей версии.

Установка для Joomla 3

Скачайте пакет модуля.
Перейдите в административную панель Joomla 3.
Откройте «Расширения» -> «Менеджер расширений».
Перейдите на вкладку «Загрузить пакет».
Выберите скачанный пакет модуля и нажмите «Загрузить и установить».

Установка для Joomla 4, Joomla 5 и Joomla 6

Скачайте пакет модуля.
Перейдите в административную панель Joomla 4/5/6.
Откройте «Система» -> «Расширения».
Перейдите на вкладку «Загрузить пакет».
Перетащите скачанный пакет модуля в область загрузки или нажмите «Выбрать пакет».
Нажмите «Загрузить и установить».

Получение идентификатора сообщества ВКонтакте

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

Обратите внимание на адресную строку в вашем браузере, она содержит идентификатор сообщества ВКонтакте.

Число 111111111 — это и есть уникальный числовой идентификатор сообщества ВКонтакте. Запишите его.

Настройка сообщества ВКонтакте

Далее необходимо настроить сообщество ВКонтакте, так как без настроек не будет работать чат с сообществом. В правом меню сообщества перейдите в пункт меню «Управление».

Откроется раздел управления сообществом. Найдите справа в меню пункт «Сообщения». Перейдите в него.

Приступим к активации возможностей сообщества для работы с сообщениями. Значение в опции «Сообщения сообщества» переключите на «Включены».

Чтобы раздел сообщений отображался в левом меню в социальной сети ВКонтакте, активируйте опцию «Добавить в левое меню».

В поле «Приветствие» необходимо ввести текст, который будет отображаться у посетителя в чате при открытии чата. Введите необходимое приветствие.

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

Нажмите кнопку «Сохранить». Сообщество успешно настроено и готово к работе с сообщениями.

Настройка модуля

Настройки модуля находятся в разных местах в зависимости от версии Joomla. Пожалуйста, используйте приведенные ниже пути, чтобы найти модуль:

Joomla 3: «Расширения» -> «Менеджер модулей»
Joomla 4/5/6: «Контент» -> «Модули сайта»

В списке модулей найдите «IWS.BY Виджет чата с сообществом ВКонтакте». Нажмите на название модуля, перед вами откроется страница с доступными настройками. Рассмотрим каждое поле ниже.

Лицензионный ключ

Тип: Текстовое поле

Описание: Введите лицензионный ключ, полученный при покупке модуля на сайте IWS.BY. Без ключа в данном поле модуль не сможет получить доступ к серверу обновлений и автоматически обновляться.

Пример: IWSBY-111-111-111

Подключить Open API

Тип: Сегментированные кнопки

Описание: Если выбрано значение «Да», то к сайту будет подключено API социальной сети ВКонтакте. Если к вашему сайту подключено API ВКонтакте по ссылке https://vk.com/js/api/openapi.js?169, то выберите значение «Нет». Без подключенного API ВКонтакте виджет работать не будет.

Возможные значения:

Да
Нет

По умолчанию: Да

Идентификатор сообщества

Тип: Числовое поле

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

Пример: 127607773

Расположение чата

Тип: Сегментированные кнопки

Описание: Опция отвечает за расположение чата относительно стороны экрана у посетителя сайта.

Возможные значения:

В правом нижнем углу
В левом нижнем углу

По умолчанию: В правом нижнем углу

Раскрывать через

Тип: Сегментированные кнопки

Описание: Опция отвечает за раскрытие чата после полной загрузки страницы у пользователя.

Возможные значения:

Не раскрывать
Сразу
5 секунд
10 секунд
15 секунд
30 секунд
40 секунд
50 секунд
60 секунд
120 секунд

По умолчанию: Сразу

Раскрывать со звуком

Тип: Сегментированные кнопки

Описание: Если в опции выбрано значение «Да» и в опции «Раскрывать через» выбрано значение с автоматическим открытием чата, то при открытии чата будет воспроизводится звук.

Возможные значения:

Да
Нет

По умолчанию: Да

Звук нового сообщения

Тип: Сегментированные кнопки

Описание: После каждого ответа от администратора сообщества в чате будет воспроизводится звуковое уведомление.

Возможные значения:

Да
Нет

По умолчанию: Да

Подсказка

Тип: Сегментированные кнопки

Описание: Опция отвечает за активацию текстовой подсказки рядом с иконкой чата.

Возможные значения:

Выключена
Включена

По умолчанию: Выключена

Текст подсказки

Тип: Текстовое поле

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

Пример: Есть вопрос?

Активация модуля

Для активации модуля в CMS Joomla нужно сделать несколько действий:

Выберите необходимую позицию шаблона, где должен отображаться модуль на сайте, в опции «Позиция», в правой части на странице настроек модуля.
В опции ниже «Состояние» необходимо выбрать значение «Опубликовано».
Далее необходимо совершить привязку модуля к страницам сайта. В верхней части части настроек на странице модуля нажмите на вкладку «Привязка к пунктам меню».
Откроется вкладка с единственной опцией «Привязка модуля». Выберите значение в зависимости от страниц, на которых вы хотите отображать модуль. В примере выбирается значение «На всех страницах» — модуль будет доступен на всех страницах сайта.
Нажмите кнопку «Сохранить». Настройки будут сохранены, модуль будет отображен на сайте.

Ошибка обновления модуля

Если у Вас возникла ошибка при обновлении модуля в панели управления Joomla, то этот раздел инструкции необходим вам. Обычно ошибка при обновлении выгляди так:

Эта ошибка появляется в нескольких случаях, они все связаны с лицензионным ключом модуля.

1) У вас не заполнен лицензионный ключ в настройках модуля.

Перейдите в настройки модуля и проверьте заполненность поля «Лицензионный ключ». Без лицензионного ключа обновления не возможно скачать. Бывает момент, когда лицензионный ключ вы добавили, но CMS Joomla его не сохранила правильно, для этого в настройках модуля после ввода лицензионного ключа нажмите кнопку «Сохранить», а затем кнопку «Сохранить и закрыть».

2) Срок действия вашего лицензионного ключа закончился.

Чтобы проверить срок действия вашего лицензионного ключа, перейдите по ссылке https://iws.by/my-account/view-license-keys/. В списке лицензионных ключей найдите ключ вашего модуля и в столбике «Действует до» проверьте его актуальность. В случае, если действие лицензионного ключа вышло, обновления получить не возможно. Для решения этого вопроса: совершите новый заказ и получите актуальный лицензионный ключ.

3) Лицензионный ключ не действует на вашем текущем сайте.

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

Внимание! Если вы изменили адрес сайта и не можете скачать обновления, напишите нам на support@iws.by с новым адресом сайта, мы обновим данные на нашем сервере обновлений и в течении 24 часов вы сможете получать обновления.

Служба поддержки

Служба поддержки IWS.BY по вопросам работы наших продуктов доступна по электронной почте support@iws.by.

Все доступные варианты службы поддержки доступны на странице «Поддержка»: Перейти.

Служба поддержки так же отвечает на официальном форуме поддержки iws.by: Перейти.