Instructions for the module «Article widget VK Pro» for Joomla

First, get the module by clicking the button above «Get module», if the module has already been received, then proceed further.

Installation in CMS Joomla 3

Go to your site’s dashboard.

In the top menu, follow the path to the extension installation manager along the path «Extensions» – «Manage» – «Install»:

Joomla 3 Extension Manager

On the page that opens, press the green button and select the archive received on the IWS.BY website when ordering.

After successful installation, you will receive a notification about successful installation:

Joomla 3 Successful Installation Notice

Including the module in CMS Joomla 3

To work, the module must be enabled.

Go to the CMS Joomla 3 module management manager along the «Extensions╗ – «Modules» path.

On the page that opens, in the search bar, enter the name of the module for a quick search. Name «Article widget VK Pro».

Only one module we need will remain in the list of modules. There will be a red cross next to the name, click on it to activate the module.

The red cross will change to a green check mark, the module has been successfully activated.

Including plugins in CMS Joomla 3

To work, you need to enable two plugins.

Go to Joomla 3 CMS Module Management Manager along the path «Extensions» – «Plugins».

On the page that opens, in the search bar, enter the name of the plugin for a quick search. Name «Button – IWS.BY Widget article VK Pro».

Only one plugin we need will remain in the list of plugins. There will be a red cross next to the name, click on it to activate the module.

The red cross will change to a green checkmark, the plugin has been successfully activated.

Now go to the plugins page and look for the second plugin we need to work.

On the page that opens, in the search bar, enter the name of the plugin for a quick search. Name «Content – IWS.BY Widget article VK Pro».

Only one plugin we need will remain in the list of plugins. There will be a red cross next to the name, click on it to activate the module.

The red cross will change to a green checkmark, the plugin has been successfully activated.

Setting up a module in Joomla 3

In the list of modules, click on the name of the module. The module configuration page will open. Let’s consider the required fields.

First field «License Key».

«License Key» field

It is necessary to fill in the license key received when registering and downloading the module from the IWS.BY website. The key must be filled in to receive regular module updates. Without this key, an error will be displayed when updating to a new version.

Field «Enable OpenAPI VK?»

If you select the «Yes» option, a public API service will be connected to the site, which are necessary for the work of the widgets of the Vkontakte social network.

If your site already has a public API connected, then set the option to «No».

Field «ID article VK»

ID of the article on the Vkontakte social network. You can get it from the page with the article from the address bar. The identifier starts with the @ symbol.

Now you need to adjust the display position of the widget in the right place.

Field «Status»

This field must be set to Published.

Field «Position»

In this option, you must select the position of the module in the template, where the community widget will be displayed.

Next, go to the «Menu Assignment» tab

A tab with one field will open «Module Assignment»

At this point, it is important to select a value, otherwise the module will not be displayed on the site pages. In our case, we chose the value «On all pages».

These are all fields and options, by filling in which on the site you will see a widget with an article on Vkontakte.

Configuring plugins in Joomla 3

In the list of plugins, click on the name of the pluginа «Button – IWS.BY Widget article VK Pro». The plugin settings page will open. Let’s consider the required fields.

First field «License Key».

«License Key» field

It is necessary to fill in the license key received during the registration and download of the plugin from the IWS.BY website. The key must be filled in to receive regular plugin updates. Without this key, an error will be displayed when updating to a new version.

Field «Status»

This field must be set to Published.

Now go back to the plugins page.

In the list of plugins, click on the name of the plugin «Content – IWS.BY Widget article VK Pro». Откроется страница настройки плагина. Рассмотрим необходимые поля.

First field «License Key».

«License Key» field

It is necessary to fill in the license key received during the registration and download of the plugin from the IWS.BY website. The key must be filled in to receive regular plugin updates. Without this key, an error will be displayed when updating to a new version.

Field «Enable OpenAPI VK?»

If you select the «Yes» option, a public API service will be connected to the site, which are necessary for the work of the widgets of the Vkontakte social network.

If your site already has a public API connected, then set the option to «No».

Field «Status»

This field must be set to Published.

The plugins are configured, you can start adding the widgets.

Adding a widget to JCE

The principle of adding a widget in the JCE Joomla editor is very simple.

Go to editing the desired page. A page with a text editor will open in front of you. The example uses TinyMCE.

On the icon panel, click on the button «Widget article VK»

A pop-up window will open with a field for entering the article ID.

The identifier can be obtained from the address bar on the Vkontakte social networking site. The identifier begins with the @ symbol. After filling in the field with the identifier, click on the green button «Add widget».

A shortcode like {iwsbywidgetarticlevk @id_art_vk} should appear in the place where the cursor is in the JCE text editor

Save the edited material. On the page of the site where the shortcode is added instead of the shortcode text, the article widget from the Vkontakte social network will be displayed.