Yandex.Metrika
Instructions for the module «Vkontakte chat widget» for Joomla 4 - IWS.BY

Instructions for the module «Vkontakte chat widget» for Joomla 4

Vkontakte chat widget for Joomla 3 and Joomla 4

Vkontakte chat widget for Joomla 3 and Joomla 4

The module is designed to add a chat widget with the community from the social network Vkontakte to the site.

Installing the module

Log in to your site’s control panel.

In the menu of the admin panel, on the left side of the site go to «System»

Joomla 4 - System

On the page that opens, in the center, find the section «Install» – «Extensions» and go into it.

Joomla 4 - Extension Installation Manager

You will see a page with an extension installation manager.

Extensions installation page in Joomla 4

Click on the green button, the explorer will open, in which you must select the archive obtained by downloading from IWS.BY for Joomla 4.

After successful installation, a green notification will appear in the Extension Installation Manager.

Notification of successful installation in Joomla 4

Getting a Vkontakte community ID

Before you start setting up the module, you need to get the ID of your community, for which the widget will be displayed.

Go to your community page on the social network Vkontakte.

On the right side of the page that opens, find the menu item «Statistics».

Vkontakte community statistics

Pay attention to the address bar in your browser, it contains the identifier of the Vkontakte community.

Vkontakte community identifier

The number 111111111 is the unique numeric identifier of the Vkontakte community. Write it down.

Next, you need to configure the community Vkontakte, because without settings will not work chat with the community.

Setting up a VKontakte community

On the right-hand menu of the community, go to the menu item «Manage».

Community management point on Vkontakte

The Community Management section opens. From the menu on the right, find «Messages». Get into it.

Manage posts in the Vkontakte community

Let’s begin to activate the community’s messaging capabilities.

Value in option «Community messages» переключите на «Enabled».

Activating community messages

To display the messages section in the left menu of the Vkontakte social network, activate the option «Add to left-side menu».

Activate messages in the left menu of Vkontakte

In field «Greeting» you must enter the text that will be displayed to the visitor in the chat when the chat opens. Enter the desired greeting.

Greeting in Vkontakte community settings

And lastly, activate the possibility of working with the widget messages for the site in the option «Messages widget».

Click the «Save» button.

The community is successfully set up and ready for messaging.

Configuring the module

Go to the list of installed modules in the admin panel by the path «Система» – «Manage» – «Site modules».

Joomla 4 - Module Manager

In the list, find the module «IWS.BY Widget VK community chat». Click on it and you will see a page with the available module settings. Consider each field below.

Field «License key»

Widget application Vkontakte for Joomla 3 and 4 - Field «License key»

In this field, enter the license key obtained when downloading the module from the IWS.BY website. Without the key in this field, the module will not be able to access the update server and automatically update.

Option «Enable OpenAPI VK?»

Widget application Vkontakte for Joomla 3 and 4 - Option «Connect OpenAPI Vkontakte?»

This option is responsible for connecting the public API of the Vkontakte social network to your site. If you already have the public Vkontakte API connected, then select «No» in the option. Without the public API, widgets from the Vkontakte social network will not work on your site.

Field «ID community VK»

Vkontakte chat widget for Joomla 3 and Joomla 4 - Vkontakte community identifier

In the field, enter the numeric ID of the community in the social network Vkontakte. How to find the community ID is described on the page above, in the section «Obtaining a Vkontakte Community ID».

Option «Chat position»

Vkontakte chat widget for Joomla 3 and Joomla 4 - Chat position

The option is responsible for the side of the site visitor’s chat location in relation to the screen. You can choose right or left side.

Option «Disclose through»

Vkontakte chat widget for Joomla 3 and Joomla 4 - Open via

The option is responsible for opening chat after the user has fully loaded the page. You can set to open immediately, after a certain number of seconds, or disable the automatic opening of chat.

Option «Disclose with sound»

Vkontakte chat widget for Joomla 3 and Joomla 4 - Open with sound

If «Yes» is selected and «Open Through» is selected with automatic chat opening, a sound will play when the chat opens.

Option «The sound of a new message»

Vkontakte chat widget for Joomla 3 and Joomla 4 - Sound of a new message

After each response from a community administrator, an audible notification will play in the chat.

Option «Hint»

Vkontakte chat widget for Joomla 3 and Joomla 4 - Hint

The option is responsible for activating the text prompt next to the chat icon.

Option «Hint text»

Vkontakte chat widget for Joomla 3 and Joomla 4 - Hint text

The tooltip text that will be displayed next to the chat icon.

Module Activation

The module is activated as usual. To do this, you need to:

1. Select the desired position in the template, where the widget should be displayed in the «Position» option, on the right side of the module settings page.

Module position

2. Below will be the «Status» option. Toggle the value in the option to «Published».

Module status

3. The final step is to bind the module to the pages on the site.

At the top above the settings on the module page, switch to the «Menu Assignment» tab.

Linking to menu items

On the open tab, there will be one field «Module Assignment».

Binding the module

Select the pages on which you want the module to be displayed in the module. In the example, “On all pages” is selected – the module will be displayed on all pages, on the selected position.

Click the «Save» button to save all the settings and display the module on your site.

These are all module settings «Vkontakte chat widget for Joomla 3 and Joomla 4».

If you have any questions that are not mentioned in the instructions, email us at admin@iws.by and we will help you.

Сontents

© 2013-2021 IWS.BY. All rights reserved.

Individual entrepreneur Alexander Berezuev, Republic of Belarus, UNP 490772447.
Certificate of state registration No. 490772447 issued by the Vetka District Committee on August 15, 2013.
The site is registered in the commercial register of the Republic of Belarus dated July 27, 2015 No. 280215.
Reprinting of materials from the IWS.BY website in whole or in part without the written permission of IWS.BY is prohibited.