Magento 2 Pinterest Widget improves the look of your website pages via configurable Pinterest boards. Choose among three board display options with individual customization options. Define the pages and page locations to put your Pinterest boards on.
Compatibility: Magento Open Source 2.2.X, Magento Commerce 2.2.X
Thank you for choosing Aheadworks!
Installing Pinterest Widget
Introducing Pinterest Widget
Magento 2 Pinterest Widget is a convenient extension that displays boards with images from Pinterest.com profiles in your Magento 2 store. The module is easy to use and fully customizable.
The Pinterest widget can display boards from any owner and works in three handy and clear display modes:
- Pinterest Board;
- Image Grid;
- Image Slider.
All three display modes are easy to fit into any store page and adjust to your requirements. Each display mode has its own settings so you can make your boards truly eye-catching.
Generating an Access Token
Before enabling the Pinterest module for your online store, you need to configure the Pinterest API.
At first, you need to log in to your Pinterest account and create a Pinterest Application here: https://developers.pinterest.com/apps/. Follow the steps suggested there.
Further, you need to generate an Access Token. To get the token, you need the Postman app. Follow the instructions in the 'Using Postman to get an auth token' section at https://developers.pinterest.com/docs/api/overview/.
The Access Token is generated.
After the Access Token is generated, you will have a limited access to the Pinterest API: only up to 10 requests per hour. To get a full access, you need to submit your application for approval.
Go to your application page at https://developers.pinterest.com/apps/ and choose the application you created. To authorize the application, fill out the form following the instructions provided on the app's page and send your submission. For the App Description, you can use this User Guide or the Pinterest extension's product page link.
Once you've had the app created and the access token generated, you can enable the Pinterest widget for your store by following these steps:
Log to your Admin Panel and go to Stores > Configuration > Neklo > Pinterest.
To enable the widget, choose Yes in the 'Enabled' field.
Insert your generated access token in the 'Access Token' field to enable the API access. This field is required for the 'Images Grid' and 'Images Slider' board view modes.
If you need a specific cache lifetime, enter the required value in the 'Cache Lifetime' field. By default, the value is set to 86400 seconds.
Adding the Pinterest Widget
To add the Pinterest widget to your store pages, follow these steps:
Log in to your Admin Panel and go to Content > Elements > Widgets. Click .
Select '[NEKLO] Pinterest widget' in the 'Type' field.
Select a design theme for your widget in the 'Design Theme' field.
Click to proceed to the 'Storefront Properties' settings.
Widget Storefront Properties
With the 'Storefront Properties' options, you can configure where the widget will be displayed in the store along with some basic settings.
- To view the storefront settings, go to Content > Elements > Widgets > Select the Pinterest widget in the widget grid > Storefront Properties.
- In the 'Widget Title' field, enter the name of the widget to identify it in the widget grid under Content > Widgets.
- Choose the store view for the Pinterest Widget in the 'Assign to Store Views' field.
- Choose categories, product and page types where the widget will be displayed in your store in the 'Layout Updates' section.
- Click to apply the changes.
'Widget Options' is the tab where you can configure style settings and display mode details for the Pinterest widget.
To enable the widget, choose Yes in the 'Is Enabled' field.
In the 'Title' field, you can enter the name of the Pinterest widget that will be displayed on the storefront.
The 'Description' field adds a text description to the Pinterest widget. The description text will be displayed on the storefront.
'Board Id' is the mandatory field that specifies the Pinterest board that will be displayed on the storefront. To enter the Board's ID, copy the last part of the Board's URL from https://www.pinterest.com/pinterest/board_id and insert it into the field.
There are three display modes for the Pinterest widget: Pinterest Board, Images Grid, and Images Slider. You can choose the display mode in the 'Type' box. Every display mode has its own set of settings.
'Pinterest Board' Display Mode
The 'Pinterest Board' display mode builds the original Pinterest board exactly as on your Pinterest page. In this mode, you can adjust the image width, board width, and height parameters.
Click Save to apply the changes.
'Images Grid' Display Mode
In this mode, Pinterest images are displayed as an infinite grid. On the storefront, you can load more images by clicking Show more.
In the 'Rows' box, you can choose the number of image rows to be displayed. The maximum number of rows is 16.
In the 'Columns' box, you can choose the number of image columns to be displayed. The maximum number of columns is 16.
In the 'Show More With' box, you can specify how a user can load more images: with a button or by scrolling (infinite scroll). If you don’t want more images to load, choose 'Do not open more images'.
In the 'Show More Animation' box, you can enable animation for loading images.
In the 'Show More Step' box, you can choose how many image rows should be loaded after clicking 'Show More'. The maximum number of rows is 16.
'Images Slider' Display Mode
The 'Images Slider' display mode presents the Pinterest board as a rotating horizontal row of images. On the storefront, you can view the images in the slider one by one by clicking 'Next' .
The 'Total Number of Images on Page' field specifies how many images the slider will contain. The maximum number of images is 100.
In the 'Number of visible Images' box, you can choose how many images will be displayed in the visible row of the slider. The row can contain up to 12 images.
To enable automatic scrolling for the slider, choose Yes in the 'Slide Autostart' field.
To specify the type of scrolling animation, choose the 'Swing' or 'Linear' options in the 'Slide Step Easing' box.
To enable navigation dots for the slider, choose Yes in the 'Use Navigation Dots' box.
You can specify how the image details will be displayed after clicking on the image. Choose the preferable option in the 'Open Pin Details In' box:
- The 'Lightbox' option opens the image with the details in the same window.
- The 'Pinterest page' option redirects the user to the original Pinterest pin.
- Choose the 'Don’t open details' option if you don’t want the details to be shown.
Thank you for using this extension. You will find more our great solutions for Magento here: store.neklo.com.
You can always find the latest version of the software, full documentation, demos, screenshots, and reviews on http://ecommerce.aheadworks.com
License agreement: https://ecommerce.aheadworks.com/end-user-license-agreement/
Contact Us: http://ecommerce.aheadworks.com/contacts/
Copyright © 2019 Aheadworks Co. http://www.aheadworks.com