Документация: Виджет приложения ВКонтакте для 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 ВКонтакте по ссылке https://vk.com/js/api/openapi.js?169, то выберите значение «Нет». Без подключенного API ВКонтакте виджет работать не будет.
Идентификатор приложения
В поле необходимо ввести числовой идентификатор приложения в социальной сети ВКонтакте, информацию о котором вы хотите отобразить в виджете. О том как найти идентификатор приложения описано на странице выше, в разделе «Получение идентификатора приложения ВКонтакте».
Идентификатор сайта
В поле необходимо ввести идентификатор вашего сайта, которое создается в кабинете по ссылке https://dev.vk.ru/ru/mini-apps/management/creating-new-apps. Детальнее читайте в разделе «Изменения в Open API ВКонтакте» документации ниже.
Тип виджета
Опция отвечает за тип виджета приложения. Имеется три варианта отображаемой информации: карточка, список участников и кнопка. Карточка — виджет будет показывать логотип приложения, название, категория, количество участников и кнопку «Играть». Список участников — виджет будет показывать логотип приложения, название, категория, количество участников, аватары участников и кнопку «Играть». Кнопка — виджет будет показывать кнопку «Играть».
Ширина
Поле отвечает за ширину виджета с приложением. Указывается числом в пикселях. Данное поле доступно, если в опции «Вид» выбрано значение «Список участников».
Высота кнопки
Опция отвечает за высоту кнопки в пикселях. Можно только выбрать значение, ввести свое нельзя. Данное поле доступно, если в опции «Вид» выбрано значение «Кнопка».
Получение идентификатора приложения ВКонтакте
Для работы модуля необходимо получить идентификатор приложения в социальной сети ВКонтакте.
Перейдите в социальной сети ВКонтакте в раздел «Игры». Используя поиск, найдите нужное вам приложение или игру.
Нажмите на изображение найденного приложения. Вам откроется информационное окно с приложением. Обратите внимание на адресную строку открывшейся страницы. Она будет содержать идентификатор приложения в социальной сети.
Число 5327745 — это уникальный числовой идентификатор приложения ВКонтакте. Запомните его или сохраните, он необходим для настройки модуля.
Изменения в 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.
Все доступные варианты службы поддержки доступны на странице «Поддержка»: Перейти.