Pinterest Plugin for WordPress: AccessPress Pinterest Pro – Documentation

Documentation of AccessPress Pinterest Pro Plugin

Installation

  1. Unzip accesspress-pinterest-pro.zip
  2. Upload all the files to the /wp-content/plugins/accesspress-pinterest-pro
  3. Activate the plugin through the ‘Plugins’ menu in WordPress.
  4. For customizing the plugin’s settings, click on AccessPress Pinterest Pro menu in WordPress of left admin menu.

backend

Pinterest Pin it Settings

You can configure all the plugin settings in the Plugin’s Settings Panel as per your requirements.

Pinterest pinit.js javascript loading

Check this option if you have pinit.js already called in another plugin or theme. Multiple insertion of pinit.js on a page can cause conflicts.

Custom Pinit Buttons Settings

Enable Custom Pin It button over images

Please disable the native pin it button below to use this custom pin it button.

On which pages the pinterest button should be displayed?

Pinit button display options for pages, posts, archives, front page and home page. If you have custom post types and taxonomies you can enable or disable the display of custom pinit buttons here.

Container selector

This is the selector used to find the container that holds the entire single post. It looks for an element that is a parent of the content of the post. Usually it’s a div or article element.

Image selector

jQuery selector for all the images that should have the “Pin it” button. Set the value to .apspp-container img if you want the “Pin it” button to appear only on class apspp-container. If you know about jQuery, you can use your own selector.

Feeds Template

There are 3 pre available feeds template from which you can choose any one.You can still change the template while displaying in the widget section.

Disabled classes

Images with these CSS classes won’t show the “Pin it” button. Please separate multiple classes with comma.

Enabled classes

Only images with these CSS classes will show the “Pin it” button. Please separate multiple classes with commas. If this field is empty, images with any (besides disabled ones) classes will show the Pin It button.

“Pin it” button position

You can select the pin it button positions Available options are:

  1. Top Left
  2. Top Right
  3. Bottom Left
  4. Bottom Right
  5. Middle

“Pin it” Image Description Source

You select these options for the image descritions

  1. Page Title
  2. Page Description
  3. Site Title
  4. Image alt tag
  5. Image title tag and if not image alt tag

Minimum image size to show the pinit button

Please choose the minimum image dimension of the image to show the pinit button.

Pin it button margins settings

You can edits the button margins as per your need from here, but not all margins are used on all button positions. Here is an example: If you’re using the “Top left” position, the button’s position will be affected only by top and left margins. Bottom and right margins affect “Bottom right” position, etc. The “Middle” position does not use any margins at all.

Transparancy Value

You can set the image overlay hover transparency value from here(between 0.00 and 1.00).
0 for the no overlay effect.
1 for the complete overlay effect.

“Pin it” button display options

In this option you can choose the button display option.
1) Always show: When you select this option the pinit button will always appear.
2) On hover only: When you select this option the pinit button will appear on hover over images only.

Mobile devices compactibility.

Hover effect is not available for mobile devices, So please choose this option if you want to show the pinit button for mobile devices as well.

Optimize for high pixel density display

When this option is checked the loading of the pinterest pin it button will be halfed of it’s size, please make sure both width and height are of even numbers (i.e. divisible by two) when using this option.

Available Pinit buttons

We have selected 40 pinit buttons you can choose to make the pinit button looks attractive.

Enable/Disable custom pinit button

If you want to use your own custom pinit icons, You can upload your own buttons here and can configure the button as per your need.

Native pinterest pin it hover settings

Enable the Pin It hover button over images

If you want to use the pinterest pinit button given by pinterest then please select this option. But please disable the custom pin it button above to use this native pin it buttons.

Button apperance settings

size: You can select the button sizes. Available sizes are small and large.
shape: You can select the pin it button shapes. Available shapes are circular and rectangular.

Options for Rectangular shape buttons

For rectangualar shape buttons there are 2 more options for the pinit button. They are:
1) Color: You can choose the color of the pin it buttons. Available colors are: Red, Gray, White
2) Language: You can choose the languare of the pin it buttons. Available languages are: English and Japanese.

Widgets

When you install the plugin, you will find several widgets named “AccessPress Pro single pin image widget”, “AccessPress Pinterest Pro Profile Widget”, “AccessPress Pinterest Pro Latest Pins Widget”, “AccessPress Pinterest Pro follow Widget” and “AccessPress Pinterest Pro Board Widget” in the widget section, You can place these widgets in any widget area and can configure as per your needs. Since the widget has the multi instance, so you can add the same widget as much as you want.

widget

Shortcode Help

Follow Button

Use the shortcode [apspp-follow-button] to display the Pinterest Follow Button within your content.

Use the function <?php echo do_shortcode('[apspp-follow-button]'); ?>
to display within template or theme files.

Available Attributes

Attribute Description Default
name Pinterest username pinterest
button_label Button label Follow Pinterest

Examples

  • [apspp-follow-button name='pinterest' button_label='Follow Pinterest']

Pin Image Button

Use the shortcode [apspp-pin-image] to display the Pinterest pin image within your content.

Use the function <?php echo do_shortcode('[apspp-pin-image]'); ?>
to display within template or theme files.

Available Attributes

Attribute Description Default
image_url Please enter the pinterest image url here https://www.pinterest.com/pin/434034482809764694/

Examples

  • [apspp-pin-image image_url='https://www.pinterest.com/pin/434034482809764694/']

Profile Widget

Use the shortcode [apspp-profile-widget] to display the Pinterest pin image within your content.

Use the function <?php echo do_shortcode('[apspp-profile-widget]'); ?>
to display within template or theme files.

Available Attributes

Attribute Description Default
profile Please enter the pinterest profile name. pinterest
custom_size Please enter the widget sizes(square, sidebar, header, custom) square
The following options will take effect only when size is set to custom, otherwise they will be ignored.
image_width Please enter the image width here. Any number greater than 60. 92
board_height Please enter the widget height here. Any number greater than 60. 172
board_width Please enter the widget width here. Any number greater than 130. auto

Examples

  • [apspp-profile-widget profile="pinterest" custom_size='custom' image_width="100" board_height="540" board_width="800"]

Board Widget

Use the shortcode [apspp-board-widget] to display the Pinterest pin image within your content.

Use the function <?php echo do_shortcode('[apspp-board-widget]'); ?>
to display within template or theme files.

Available Attributes

Attribute Description Default
board_url Please enter the pinterest board url. pinterest
custom_size Please enter the widget sizes(square, sidebar, header, custom) square
The following options will take effect only when size is set to custom, otherwise they will be ignored.
image_width Please enter the image width here. Any number greater than 60. 92
board_height Please enter the widget height here. Any number greater than 60. 172
board_width Please enter the widget width here. Any number greater than 130. auto

Examples

  • [apspp-board-widget board_url="http://www.pinterest.com/pinterest/pin-pets/" custom_size='custom' image_width="100" board_height="540" board_width="800"]

Latest Pins Widget

Use the shortcode [apspp-latest-pins] to display the latest Pinterest pin images within your widget.

Use the function <?php echo do_shortcode('[apspp-latest-pins]'); ?>
to display within template or theme files.

Available Attributes

Attribute Description Default
feed_url Please enter the pinterest url. https://www.pinterest.com/pinterest
specific_board Please enter the specific board name here if you want to display for specific board. Default: none
feed_count You can specify the feed counts from here. 4
caption You can enable or disable the image caption from here. No

Examples

  • [apspp-latest-pins feed_url='https://www.pinterest.com/shovanjaya55' specific_board='tech' feed_count='5' caption='1']

shortcodes