Документация: Виджет сообщества ВКонтакте для Joomla
Системные требования
Системные требования отличаются для 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. Без ключа в данном поле модуль не сможет получить доступ к серверу обновлений и автоматически обновляться.
Подключить Open API
Опция отвечает за подключение публичного API социальной сети ВКонтакте к вашему сайту. Если у вас уже подключен публичный API ВКонтакте, то выберите в опции значение «Нет». Без публичного API виджеты от социальной сети ВКонтакте не будут работать на вашем сайте.
Идентификатор сайта
В поле необходимо ввести идентификатор вашего сайта, которое создается в кабинете по ссылке https://dev.vk.ru/ru/mini-apps/management/creating-new-apps. Детальнее читайте в разделе «Изменения в Open API ВКонтакте» документации ниже.
Идентификатор сообщества
В поле необходимо ввести числовой идентификатор сообщества в социальной сети ВКонтакте, информацию о котором вы хотите отобразить в виджете. О том как найти идентификатор сообщества описано на странице выше, в разделе «Получение идентификатора сообщества ВКонтакте».
Режим отображения
Данная опция отвечает за режим отображаемой информации на виджете о сообществе. Всего имеется три варианта отображаемой информации. Участники - в виджете будут отображаться участники, которые состоят в сообществе. Новости - в виджете будет отображаться лента с последними записями из сообщества. Только название - в виджете будет отображаться только название сообщества с кнопкой подписки.
Не использовать обложку
Если выставить в данной опции галку, то обложка, загруженная в сообщество, не будет отображаться в виджете.
Расширенный режим
Данная опция доступна только, если в опции «Режим отображения» выбрано значение «Новости». Если в поле выставлена галочка, то информация в виджете будет отображаться в расширенном режиме.
Ширина виджета
Опция отвечает за тип ширины, применяемой к виджету.Автоматически — ширина виджета будет равна ширине родительского блока. Вручную — ширина будет установлена виджету из поля «Ширина».
Ширина
В поле заполняется фиксированная ширина виджета, которая указывается числом в пикселях.
Высота виджета
Данная опция доступна только, если в опции «Режим отображения» выбрано значение «Новости». «Опция отвечает за тип высоты, применяемой к виджету. Автоматически — высота виджета будет равна высоте родительского блока. Вручную — высота будет установлена виджету из поля «Высота».
Высота
В поле заполняется фиксированная высота виджета, которая указывается числом в пикселях.
Цвет фона
В опции указывается цвет фона в блоке с виджетом. Значение указывается в HEX формате.
Цвет текста
В опции указывается цвет текста в блоке с виджетом. Значение указывается в HEX формате.
Цвет кнопок
В опции указывается цвет кнопок в блоке с виджетом. Значение указывается в HEX формате.
Получение идентификатора сообщества ВКонтакте
Перед началом настройки модуля, вам необходимо получить идентификатор вашего сообщества, для которого будет отображаться виджет. Перейдите в социальной сети ВКонтакте на страницу вашего сообщества. В правой части открывшейся страницы найдите пункт меню «Статистика».
Обратите внимание на адресную строку в вашем браузере, она содержит идентификатор сообщества ВКонтакте.
Число 111111111 — это и есть уникальный числовой идентификатор сообщества ВКонтакте. Запишите его.
Изменения в Open API ВКонтакте
7 сентября 2026 года ВКонтакте ввела обязательную регистрацию сайта, которое использует публичное API. Чтобы продолжить пользоваться бесплатными виджетами, необходимо зарегистрировать адрес сайта. Более детальнее по ссылке https://dev.vk.ru/ru/api/open-api/getting-started в разделе «Подготовка к работе». Вам нужно зарегистрировать сайт приложением с типом «Сайт» или «Standalone-приложение» по ссылке https://dev.vk.ru/ru/mini-apps/management/creating-new-apps. После регистрации вашему сайту будет присвоен уникальный идентификатор. Его необходимо использовать на сайте, чтобы виджеты продолжили работу. В модуле есть поле «Идентификатор сайта», который нужно заполнить полученным при регистрации. Внимание! Если на сайте уже используется идентификатор сайта, то рекомендуется оставить поле «Идентификатор сайта» пустым.
Ошибка обновления расширения
Если у Вас возникла ошибка при обновлении расширения в панели управления Joomla, то этот раздел инструкции необходим вам.
Ошибка появляется в нескольких случаях, они все связаны с лицензионным ключом расширения.
1) У вас не заполнен лицензионный ключ в настройках расширения.
Перейдите в настройки расширения и проверьте заполненность поля «Лицензионный ключ». Без лицензионного ключа обновления скачать невозможно. Бывает момент, когда лицензионный ключ вы добавили, но CMS Joomla его не сохранила правильно, для этого в настройках расширения после ввода лицензионного ключа нажмите кнопку «Сохранить», а затем кнопку «Сохранить и закрыть».
2) Срок действия вашего лицензионного ключа закончился.
Чтобы проверить срок действия вашего лицензионного ключа, перейдите по ссылке https://iws.by/my-account/view-license-keys/. В списке лицензионных ключей найдите ключ вашего расширения и в столбике «Действует до» проверьте его актуальность. В случае, если действие лицензионного ключа вышло, обновления получить невозможно. Для решения этого вопроса совершите новый заказ и получите актуальный лицензионный ключ.
3) Лицензионный ключ не действует на вашем текущем сайте.
Наша система обновлений устроена так, что при первом обращении к серверу обновлений, лицензионный ключ фиксируется за обратившимся сайтом. В случае, если вы попытаетесь использовать лицензионный ключ на нескольких сайтах, то обновления будут доступны только для одного сайта. Если вам нужны обновления для нескольких сайтов, совершите покупку на сайте нескольких лицензионных ключей. Сайты без лицензионных ключей не смогут получать обновления.
Внимание! Если вы изменили адрес сайта и не можете скачать обновления, напишите нам на support@iws.by с новым адресом сайта, мы обновим данные на нашем сервере обновлений, и в течение 24 часов вы сможете получать обновления.
Служба поддержки
Служба поддержки IWS.BY по вопросам работы наших продуктов доступна по электронной почте: support@iws.by.
Все доступные варианты службы поддержки доступны на странице «Поддержка»: Перейти.