Документация: Виджет чата с сообществом ВКонтакте для Joomla от iws.by
Системные требования
Системные требования отличаются для Joomla 3, Joomla 4, Joomla 5 и Joomla 6, поэтому обратите внимание на раздел, соответствующий вашей версии.
Joomla 3
Joomla 4
Joomla 5 и Joomla 6
Установка расширения
Процесс установки расширения немного отличается для Joomla 3 и Joomla 4/5/6, поэтому обратите внимание на раздел, соответствующий вашей версии.
Установка для Joomla 3
- Скачайте пакет расширения.
- Перейдите в административную панель Joomla 3.
- Откройте "Расширения" -> "Менеджер расширений".
- Перейдите на вкладку "Загрузить пакет".
- Выберите скачанный пакет расширения и нажмите "Загрузить и установить".
Установка для Joomla 4, Joomla 5 и Joomla 6
- Скачайте пакет расширения.
- Перейдите в административную панель Joomla 4/5/6.
- Откройте "Система" -> "Расширения".
- Перейдите на вкладку "Загрузить пакет".
- Перетащите скачанный пакет расширения в область загрузки или нажмите "Выбрать пакет".
- Нажмите "Загрузить и установить".
Настройки расширения
Настройки модуля находятся в разных местах в зависимости от версии 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 секунд
По умолчанию: Сразу
Раскрывать со звуком
Тип: Сегментированные кнопки
Описание: Если в опции выбрано значение «Да» и в опции «Раскрывать через» выбрано значение с автоматическим открытием чата, то при открытии чата будет воспроизводится звук.
Возможные значения:
- Да
- Нет
По умолчанию: Да
Звук нового сообщения
Тип: Сегментированные кнопки
Описание: После каждого ответа от администратора сообщества в чате будет воспроизводится звуковое уведомление.
Возможные значения:
- Да
- Нет
По умолчанию: Да
Подсказка
Тип: Сегментированные кнопки
Описание: Опция отвечает за активацию текстовой подсказки рядом с иконкой чата.
Возможные значения:
- Выключена
- Включена
По умолчанию: Выключена
Текст подсказки
Тип: Текстовое поле
Описание: Текст подсказки, который будет отображаться рядом с иконкой чата.
Пример: Есть вопрос?
Получение идентификатора сообщества ВКонтакте
Перед началом настройки модуля, вам необходимо получить идентификатор вашего сообщества, для которого будет отображаться виджет. Перейдите в социальной сети ВКонтакте на страницу вашего сообщества. В правой части открывшейся страницы найдите пункт меню «Статистика».
Обратите внимание на адресную строку в вашем браузере, она содержит идентификатор сообщества ВКонтакте.
Число 111111111 — это и есть уникальный числовой идентификатор сообщества ВКонтакте. Запишите его.
Настройка сообщества ВКонтакте
Далее необходимо настроить сообщество ВКонтакте, так как без настроек не будет работать чат с сообществом. В правом меню сообщества перейдите в пункт меню «Управление».
Откроется раздел управления сообществом. Найдите справа в меню пункт «Сообщения». Перейдите в него.
Приступим к активации возможностей сообщества для работы с сообщениями. Значение в опции «Сообщения сообщества» переключите на «Включены».
Чтобы раздел сообщений отображался в левом меню в социальной сети ВКонтакте, активируйте опцию «Добавить в левое меню».
В поле «Приветствие» необходимо ввести текст, который будет отображаться у посетителя в чате при открытии чата. Введите необходимое приветствие.
И в последнюю очередь активируйте возможность работы сообщений с виджетом для сайта в опции «Виджет сообщений».
Нажмите кнопку «Сохранить». Сообщество успешно настроено и готово к работе с сообщениями.
Ошибка обновления расширения
Если у Вас возникла ошибка при обновлении расширения в панели управления Joomla, то этот раздел инструкции необходим вам. Обычно ошибка при обновлении выглядит так:
Эта ошибка появляется в нескольких случаях, они все связаны с лицензионным ключом расширения.
1) У вас не заполнен лицензионный ключ в настройках расширения.
Перейдите в настройки расширения и проверьте заполненность поля «Лицензионный ключ». Без лицензионного ключа обновления скачать невозможно. Бывает момент, когда лицензионный ключ вы добавили, но CMS Joomla его не сохранила правильно, для этого в настройках расширения после ввода лицензионного ключа нажмите кнопку «Сохранить», а затем кнопку «Сохранить и закрыть».
2) Срок действия вашего лицензионного ключа закончился.
Чтобы проверить срок действия вашего лицензионного ключа, перейдите по ссылке https://iws.by/my-account/view-license-keys/. В списке лицензионных ключей найдите ключ вашего расширения и в столбике «Действует до» проверьте его актуальность. В случае, если действие лицензионного ключа вышло, обновления получить невозможно. Для решения этого вопроса совершите новый заказ и получите актуальный лицензионный ключ.
3) Лицензионный ключ не действует на вашем текущем сайте.
Наша система обновлений устроена так, что при первом обращении к серверу обновлений, лицензионный ключ фиксируется за обратившимся сайтом. В случае, если вы попытаетесь использовать лицензионный ключ на нескольких сайтах, то обновления будут доступны только для одного сайта. Если вам нужны обновления для нескольких сайтов, совершите покупку на сайте нескольких лицензионных ключей. Сайты без лицензионных ключей не смогут получать обновления.
Внимание! Если вы изменили адрес сайта и не можете скачать обновления, напишите нам на support@iws.by с новым адресом сайта, мы обновим данные на нашем сервере обновлений, и в течение 24 часов вы сможете получать обновления.
Служба поддержки
Служба поддержки IWS.BY по вопросам работы наших продуктов доступна по электронной почте: support@iws.by.
Все доступные варианты службы поддержки доступны на странице «Поддержка»: Перейти.