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

Документация: Виджет приложения ВКонтакте для Joomla от iws.by

Дата обновления документации: 28.09.2025
Документация актуальна для версии: 1.2.4
Содержание

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

  • Joomla 3.x
  • Joomla 4.x
  • Joomla 5.x
  • Joomla 6.x

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

Системные требования отличается для 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
  1. Скачайте пакет модуля.
  2. Перейдите в административную панель Joomla 3.
  3. Откройте «Расширения» -> «Менеджер расширений».
  4. Перейдите на вкладку «Загрузить пакет».
  5. Выберите скачанный пакет модуля и нажмите «Загрузить и установить».
Установка для Joomla 4, Joomla 5 и Joomla 6
  1. Скачайте пакет модуля.
  2. Перейдите в административную панель Joomla 4/5/6.
  3. Откройте «Система» -> «Расширения».
  4. Перейдите на вкладку «Загрузить пакет».
  5. Перетащите скачанный пакет модуля в область загрузки или нажмите «Выбрать пакет».
  6. Нажмите «Загрузить и установить».

Получение идентификатора приложения Вконтакте

Для работы модуля необходимо получить идентификатор приложения в социальной сети ВКонтакте.

Перейдите в социальной сети ВКонтакте в раздел «Игры». Используя поиск, найдите нужное вам приложение или игру.

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

Идентификатор приложения в социальной сети ВКонтакте

 Число 5327745 — это уникальный числовой идентификатор приложения ВКонтакте. Запомните его или сохраните, он необходим для настройки модуля.

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

Настройки модуля находятся в разных местах в зависимости от версии 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 ВКонтакте виджет работать не будет.

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

  • Да
  • Нет

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

Идентификатор приложения

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

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

Пример: 3083242

Тип виджета

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

Описание: Опция отвечает за тип виджета приложения. Имеется три варианта отображаемой информации: карточка, список участников и кнопка.

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

  • Карточка — виджет будет показывать логотип приложения, название, категория, количество участников и кнопку «Играть».
  • Список участников — виджет будет показывать логотип приложения, название, категория, количество участников, аватары участников и кнопку «Играть».
  • Кнопка — виджет будет показывать кнопку «Играть».

По умолчанию: Карточка

Ширина

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

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

Пример: 200

Высота кнопки

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

Описание: Опция отвечает за высоту кнопки в пикселях. Можно только выбрать значение, ввести свое нельзя. Данное поле доступно, если в опции «Вид» выбрано значение «Кнопка».

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

  • 18px.
  • 20px.
  • 22px.
  • 24px.
  • 30px.

По умолчанию: 18px

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

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

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

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

Если у Вас возникла ошибка при обновлении модуля в панели управления 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: Перейти.