Documentation: Pinterest Board Widget for Joomla from iws.by
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 4
Joomla 5 and Joomla 6
Extension Installation
The extension 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
- Download the extension package.
- Go to the Joomla 3 administration panel.
- Open "Extensions" -> "Extension Manager".
- Click on the "Upload Package" tab.
- Select the downloaded extension package and click "Upload and Install".
Installation for Joomla 4, Joomla 5, and Joomla 6
- Download the extension package.
- Go to the Joomla 4/5/6 administration panel.
- Open "System" -> "Extensions".
- Click on the "Upload Package" tab.
- Drag and drop the downloaded extension package into the upload area or click "Select Package".
- Click "Upload and Install".
Extension settings
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
Extension update error
If you encounter an error when updating an extension in the Joomla control panel, this section of the instructions is for you. Usually, the update error looks like this:
This error appears in several cases, all of which are related to the extension's license key.
1) You have not filled in the license key in the extension settings.
Go to the extension settings and check if the "License key" field is filled in. Without a license key, it is not possible to download updates. Sometimes, you may have added a license key, but the Joomla CMS did not save it correctly. In this case, in the extension settings, after entering the license key, click "Save" and then click "Save & 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 for your extension and check its validity in the "Valid until" column. If the license key has expired, it is not possible to get updates. To resolve this issue, place a new order and obtain 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 requested it. If you try to use the license key on multiple sites, updates will be available for only one site. If you need updates for multiple sites, purchase multiple license keys on our website. Sites without license keys will not be able to receive updates.
Attention! If you have changed your site's address and cannot download updates, write to us at support@iws.by with the new site address. 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.