WordPress.org

Ready to get started?Download WordPress

Plugin Directory

Pinterest RSS Widget

A widget to display thumbnails and titles of the latest Pinterest Pins from a specific user via their Pinterest RSS feed

How do I use the shortcode in the post or page editor?

While editing the post or page that you want to add your Pins to, enter the shortcode [prw username="Your Pinterest Username"]. At the very minimum you have to include the username parameter, substituting "Your Pinterest Username" with your actual Pinterest username. The rest of the parameters are the same as listed below in the template tags explanation, and the defaults are also the same. Here's an example:

[prw username="bkmacdaddy" boardname="design-inspiration" maxfeeds="10" divname="myList" printtext="0" target="newwindow" useenclosures="yes" thumbwidth="100" thumbheight="100" showfollow="medium"]

The above example will show the 10 latest Pins from bkmacdaddy's Design Inspiration board, in a div class titled "pins-feed-myList". Each thumbnail will be 100 x 100 pixels with no description below them. When clicked on, the Pin will open in a new tab/window, and the Follow Me On Pinterest button at the bottom will be the medium sized one.

If you leave out any of the parameters they will revert to the defaults listed below.

How do I use the plugin in my theme?

Anywhere in your theme templates, you can display the list of latest Pins thumbnails by placing the following code where you want them to appear:

<?php get_pins_feed_list($username, $boardname, $maxfeeds, $divname, $printtext, $target, $useenclosures, $thumbwidth, $thumbheight, $showfollow); ?>

Where:

  • username is the Pinterest username you wish to display Pins from (mandatory)
  • boardname is the slug (URL) of a specific board. This must be the actual part of the URL that designates the board (i.e. http://pinterest.com/bkmacdaddy/design-inspiration/ - the portion in bold) (optional)
  • maxfeeds is the maximum number of Pins to display (optional, default = 25)
  • divname is a name suffix for the list class. "myList" will become "pins-feed-myList" (optional)
  • printtext must be 1 if you want the first few words of the Pin description to be printed below the thumbnail (optional)
  • target is "samewindow" or "newwindow", depending on where you want links to open (optional, default = samewindow)
  • useenclosures is "yes" or "no" (optional, default = yes). Use this if you don't want to use the tag in the feed and force the script to find an image link in the feed item description.
  • thumbwidth is a number that will set the width in pixels of the Pin's thumbnail (optional, default = 150)
  • thumbheight is a number that will set the height in pixels of the Pin's thumbnail (optional, default = 150)
  • showfollow is "large", "medium", "small", "tiny" or "none" (optional, default = none). Use this if you want to show the "Follow Me On Pinterest" button below the thumbnails. Select the size that best fits the space allowed ("large" is 156x26, "medium" is 78x26, "small" is the square 61x61 logo, and "tiny" is the 16x16 logo.)

Example:

<?php get_pins_feed_list('bkmacdaddy', 'design-inspiration', 10, 'myList', 1, 'newwindow', 'yes', 125, 125, 'large'); ?>

Requires: 2.8.4 or higher
Compatible up to: 3.5.2
Last Updated: 2013-11-11
Downloads: 56,682

Ratings

4 stars
4.2 out of 5 stars

Support

Got something to say? Need help?

Compatibility

+
=
Not enough data

0 people say it works.
0 people say it's broken.

0,1,0
100,2,2 100,1,1 100,3,3 100,1,1 100,1,1 100,2,2 100,1,1 50,6,3 40,5,2 100,1,1 100,4,4 0,1,0
100,1,1
100,1,1
100,1,1 100,3,3
0,2,0
0,3,0 100,1,1 100,1,1
67,3,2
100,1,1
100,1,1
100,1,1