JL VK Group

Официальная страница (RU)
Official page (EN)

Модуль для Joomla 4.4/5.x

Версия: 2.9.0
Автор: JoomLine (https://joomline.ru)
Лицензия: GNU/GPL
Copyright: © 2010–2025 JoomLine

---

Описание

JL VK Group — модуль для отображения виджета группы или страницы ВКонтакте на вашем сайте Joomla. Позволяет гибко настраивать внешний вид, режимы отображения, цвета, размеры и дополнительные параметры виджета.

---

Требования

• Joomla 4.4.x или 5.x
• PHP 8.1 и выше

---

Установка

1. Установите модуль через стандартный менеджер расширений Joomla.
2. Перейдите в "Расширения" → "Модули", найдите "JL VK Group" и включите его.
3. Настройте параметры модуля по своему усмотрению.

---

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

• VK Group ID — идентификатор сообщества ВКонтакте (только цифры, без минуса).
• Width — ширина блока (в пикселях или 'auto').
• Height — высота блока (только цифры, от 200 до 1200).
• Display mode — режим отображения (участники, только название, стена).
• Wall mode settings — расширенный режим стены (Yes/No).
• Show cover — показывать обложку группы (Yes/No).
• Background color / Text color / Button color — выбор цвета через колорпикер.
• Hide link — скрыть дополнительную ссылку (Yes/No).
• VK Application ID (optional) — ID приложения VK для опциональной инициализации VK.init (только цифры).

---

Как получить VK Group ID

1. Откройте вашу группу или публичную страницу ВКонтакте в браузере.
2. Посмотрите на адресную строку. Пример: https://vk.com/club17291036 или https://vk.com/public17291036
3. Число после 'club' или 'public' — это и есть идентификатор группы. Введите его в поле VK Group ID (только цифры, без минуса).
4. Если адрес вида https://vk.com/somegroupname, используйте сервис https://regvk.com/id/ чтобы узнать числовой ID.

---

Использование

1. Разместите модуль в нужной позиции шаблона.
2. При необходимости настройте CSS-стили для адаптации под дизайн сайта.
3. Если требуется, используйте параметр VK Application ID для явной инициализации VK API.

---

FAQ

• Виджет не отображается:
  Проверьте правильность ID группы, наличие подключения openapi.js, корректность параметров ширины/высоты.

• Цвета не применяются:
  Убедитесь, что выбранные цвета корректны и не конфликтуют с CSS шаблона.

• Нужно ли указывать VK Application ID?
  Обычно не требуется. Используйте только если виджет не работает без инициализации VK.init.

---

JL VK Group (English)

Module for Joomla 4.4/5.x

Version: 2.9.0
Author: JoomLine (https://joomline.ru)
License: GNU/GPL
Copyright: © 2010–2025 JoomLine

---

Description

JL VK Group is a module for displaying a VKontakte group or page widget on your Joomla site. It allows flexible customization of appearance, display modes, colors, sizes, and additional widget options.

---

Requirements

• Joomla 4.4.x or 5.x
• PHP 8.1 or higher

---

Installation

1. Install the module via Joomla Extensions Manager.
2. Go to "Extensions" → "Modules", find "JL VK Group" and enable it.
3. Configure the module parameters as needed.

---

Module Parameters

• VK Group ID — VKontakte community ID (digits only, no minus).
• Width — block width (in pixels or 'auto').
• Height — block height (digits only, from 200 to 1200).
• Display mode — display mode (members, title only, wall).
• Wall mode settings — wide wall mode (Yes/No).
• Show cover — show group cover (Yes/No).
• Background color / Text color / Button color — color picker for easy selection.
• Hide link — hide additional link (Yes/No).
• VK Application ID (optional) — VK application ID for optional VK.init initialization (digits only).

---

How to get VK Group ID

1. Open your VK group or public page in your browser.
2. Look at the address bar. Example: https://vk.com/club17291036 or https://vk.com/public17291036
3. The number after 'club' or 'public' is your group ID. Enter it in the VK Group ID field (digits only, no minus).
4. If the address is like https://vk.com/somegroupname, use https://regvk.com/id/ to find the numeric ID.

---

Usage

1. Place the module in the desired template position.
2. Optionally, adjust CSS styles for your site design.
3. Use VK Application ID only if explicit VK.init initialization is required.

---

FAQ

• Widget not displayed:
  Check the group ID, openapi.js connection, and width/height parameters.

• Colors not applied:
  Make sure the selected colors are valid and not overridden by template CSS.

• Do I need to specify VK Application ID?
  Usually not required. Use only if the widget does not work without VK.init.

---

You can support the project:

Donate - https://joomline.org/donation.html