Home » Documentation » Joomla » Modules » Documentation: Pinterest Board Widget for Joomla from iws.by

Documentation: Pinterest Board Widget for Joomla from iws.by

Documentation update date: 03.01.2026
Documentation is relevant for version: 1.2.2
Contents

Compatibility

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

System Requirements

System requirements differ for Joomla 3, Joomla 4, Joomla 5, and Joomla 6, so please refer to the section corresponding to your version.

Joomla 3
  • Joomla: 3.0.0 - 3.10.x.
  • PHP: 5.3 and above.
  • MySQL: 5.1 and above.
  • MariaDB: 10.1 and above.
  • PostgreSQL: 8.3.18 and above.
  • Virtual memory: 128Мб and above.
Joomla 4
  • Joomla: 4.0.0 - 4.x.x.
  • PHP: 7.2 and above.
  • MySQL: 5.6 and above.
  • MariaDB: 10.3.35 and above.
  • PostgreSQL: 11.0 and above.
  • Virtual memory: 128Мб and above.
Joomla 5 and Joomla 6
  • Joomla: 5.0.0 - 5.x.x. / 6.0.0 - 6.x.x.
  • PHP: 8.1 and above.
  • MySQL: 8.0.11 and above.
  • MariaDB: 10.4 and above.
  • PostgreSQL: 12.0 and above.
  • Virtual memory: 128Мб and above.

Installing the module

The module installation process is slightly different for Joomla 3 and Joomla 4/5/6, so please refer to the section corresponding to your version.

Installation for Joomla 3
  1. Download the module package.
  2. Go to the Joomla 3 administration panel.
  3. Open “Extensions” -> “Extension Manager”.
  4. Click on the “Upload Package” tab.
  5. Select the downloaded module package and click “Upload and Install”.
Installation for Joomla 4, Joomla 5, and Joomla 6
  1. Download the module package.
  2. Go to the Joomla 3 administration panel 4/5/6.
  3. Open “System” -> “Extensions”.
  4. Click on the “Upload Package” tab.
  5. Drag and drop the downloaded module package into the download area or click “Select Package”.
  6. Click “Upload and Install”.

Configuring the module

The module settings are located in different places depending on the Joomla version. Please use the paths below to find the module:

  • Joomla 3: “Extensions” -> “Module Manager”
  • Joomla 4/5/6: “Content” -> “Site modules”

In the list of modules, find “IWS.BY Pinterest Profile Widget“. Click on the name of the module and you will see a page with the available settings. Consider each field below.

License key

Type: Text field

Description: Enter the license key obtained when purchasing the module on the IWS.BY website. Without the key in this field, the module will not be able to access the update server and update automatically.

Example: IWSBY-111-111-111

Enable API script Pinterest?

Type: Segmented buttons

Description: The option is responsible for connecting the Pinterest public API to your website. If you already have the Pinterest public API connected, select No in the option. Without the public API, the Pinterest widgets will not work on your website.

Possible values:

  • Yes
  • No

Default: Yes

Widget language

Type: Drop-down list

Description: This option sets the language in which the data in the widget will be displayed when received from the Pinterest social network.

URL Pinterest profile

Type: Text field

Description: In the field, you need to enter a direct link to your Pinterest social network profile, which data should be displayed in the widget on the site.

Example: https://www.pinterest.com/pinterest/

Profile widget view

Type: Drop-down list

Description: The option is responsible for the appearance of the profile widget from Pinterest. The module supports four possible options, let’s look at each one.

Possible values:

  • Square — the widget will be of the rectangular type. The size of this widget is 420×349 pixels.
  • Sidebar — the widget will be of the vertical type. The size of this widget is 150×800 pixels.
  • Header — widget will be horizontal type. The size of this widget is 900×120 pixels.
  • Custom size — widget will be of any type. The size of such a widget is set in the corresponding fields below.

Default: Square

Image width in pixels

Type: Number field

Description: The field is responsible for the width of images in the profile widget at a non-standard size. It is specified as a number in pixels.

Exanple: 115

Profile widget height in pixels

Type: Number Field

Description: The field is responsible for the height of the block with the profile widget at a non-standard size. It is specified as a number in pixels.

Example: 120

Profile widget width in pixels

Type: Number Field

Description: The field is responsible for the width of the block with the profile widget at a non-standard size. It is specified as a number in pixels.

Example: 900

Module Activation

To activate the module in the CMS Joomla need to do several actions:

  1. Select the desired position of the template, where the module should be displayed on the site, in the «Position» option, on the right side of the module settings page.
  2. In the option below «Status» you must select the «Published» value.
  3. Next, you need to bind the module to the pages of the site. In the upper part of the settings on the module page, click on the «Menu assignment» tab.
  4. A tab opens with a single option «Module assignment». Select the value depending on the pages on which you want the module to be displayed. In the example, select «On all pages» – the module will be available on all pages of the site. 
  5. Click the «Save» button. The settings will be saved and the module will be displayed on the site.

Error update module

If you have an error when updating a module in the control panel of Joomla, then this section of the instructions is necessary for you. Usually the error when updating looks like this:

Joomla extension update error

This error appears in several cases, they are all related to the module’s license key.

1) You have not filled in the license key in the module settings.

Go to the module settings and check if the «License key» field is filled in. Without a license key it is not possible to download updates. There is a time when you added a license key, but CMS Joomla did not save it correctly, for this module settings after entering a license key, click «Save» and then click «Save and Close».

2) Your license key has expired.

To check the expiration date of your license key, go to https://iws.by/en/my-account/view-license-keys. In the list of license keys, find the key of your module and in the «Valid until» column check its relevance. If the license key has expired, it is not possible to get updates. To resolve this issue: place a new order and get a current license key.

3) The license key is not valid on your current site.

Our update system is designed so that the first time you access the update server, the license key is assigned to the site that accessed it. In case you try to use the license key on several sites, the updates will be available only for one site. If you need updates for multiple sites, make a purchase of multiple license keys from the site. Sites without license keys will not be able to receive updates.

Attention! If you have changed the address of the site and can not download updates, write to us at support@iws.by with the new address of the site, we will update the data on our update server and within 24 hours you will be able to receive updates.

Support

IWS.BY support service for questions regarding our products is available via email support@iws.by.

All available support options are available on the Support page: Go to.

The support service also responds on the official support forum iws.by: Go to.