=== Pinterest "Pin It" Button ===
Contributors: pderksen, nickyoung87
Tags: pinterest, pin it button, social, social media, image, images, photo, photos, pinterest pin it button, pin it, social button
Requires at least: 3.9
Tested up to: 4.2
Stable tag: 2.1.0.1
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Add a Pinterest "Pin It" Button to your site and get your visitors to start pinning your awesome content!
== Description ==
Add a simple Pinterest "Pin It" Button to your posts in 2 minutes!
No need to copy and paste code throughout your WordPress site.
###"Pin It" Button Lite Features###
* Let the reader select an image when pinning.
* Pre-select an image for the reader to pin.
* Default to the first image in the post.
* Specify a specific image to pin per post.
* Pick from official "Pin It" button colors and sizes.
* Hide the "Pin It" button on specific posts and pages.
* Add a "Pin It" button to your sidebar or footer as a widget.
* Place "Pin It" buttons anywhere using shortcodes.
###Pro Version Features###
* Add "Pin It" buttons on image hover (in any corner).
* Add a "Pin It" button under each image.
* Pick from 30 custom "Pin It" button designs.
* Upload your own custom "Pin It" buttons.
* Twitter, Facebook, Google+ & LinkedIn sharing buttons included.
* Option to pin featured images.
* Show or hide on custom post types.
* WooCommerce compatibility.
* Customer support and automatic updates.
[Start Getting Pinned Like Crazy with "Pin It" Button Pro!](http://pinplugins.com/pin-it-button-pro/?utm_source=wordpress_org&utm_medium=link&utm_campaign=pin_it_button_lite)
###A Few Stats on Pinterest###
* Pinterest has [70 million users](http://thenextweb.com/socialmedia/2013/07/10/semiocast-pinterest-now-has-70-million-users-and-is-steadily-gaining-momentum-outside-the-us/)
* There are over [½ million verified business accounts on Pinterest](http://searchenginewatch.com/article/2282835/Pinterest-Tops-70-Million-Users-30-Pinned-Repinned-or-Liked-in-June-Study)
* Pinterest has over [2.5 billion average monthly pageviews](http://readwrite.com/2013/05/09/why-pinterest-could-be-worth-far-more-than-25-billion)
* Pinterest users spend an average of [98 minutes per month on Pinterest](http://rismedia.com/2013-05-23/pinterest-should-it-be-a-part-of-your-marketing-plan/)
* The average amount per order that derives from Pinterest traffic is between [$140 and $180](http://www.richrelevance.com/blog/2013/04/direct-marketing-news-infographic-the-rising-king-of-social-sales/)
* Pinterest Drives More Traffic to Publishers Than [Twitter, LinkedIn, Reddit Combined](http://mashable.com/2013/10/15/pinterest-referral-traffic/)
###Raves on the Interwebs###
* "If you want complete (and easy) control over your Pin It button, you should definitely take a look..." -- [The Next Web](http://thenextweb.com/socialmedia/2012/03/04/20-awesome-tools-which-will-have-you-pinteresting-like-a-pro/)
* "The Pinterest 'Pin It' Button is a painless solution for bloggers just getting started with this social network." -- [WP Jedi](http://www.wpjedi.com/pinterest-pin-it-button-for-wordpress/)
* "This is the plugin that I found works best on my marketing blog for photographers." -- [ProBlogger](http://www.problogger.net/archives/2013/03/05/heavyweight-help-the-complete-guide-to-getting-started-on-pinterest/)
* "If you want to make it easy for Pinterest users to pin your articles, consider using this 'Pin It' button plugin." -- [WP Tavern](http://www.wptavern.com/pin-it-is-the-new-bookmark)
* "Discovery of the Week" -- [Social Media Examiner](http://www.socialmediaexaminer.com/pinterest-marketing-what-marketers-need-to-know-to-succeed/)
* "If you're looking for something simple and obtrusive, the Pinterest 'Pin It' Button will suit you." -- [WPMU.org](http://wpmu.org/pinterest-plugins-wordpress/)
[See a "Pin It" Button Pro Demo](http://bruisesandbandaids.com/2011/newborn-photography-props/) (shows off the share bar and image hover features)
[Setup an Eye-Catching Button in Minutes with "Pin It" Button Pro!](http://pinplugins.com/pin-it-button-pro/?utm_source=wordpress_org&utm_medium=link&utm_campaign=pin_it_button_lite)
This plugin (as well as the Pro version) is in full compliance with the [official "Pin It" button developer guidelines](http://developers.pinterest.com/pin_it/).
This plugin utilizes the code output from the [official "Pin It" button widget builder](http://business.pinterest.com/widget-builder/#do_pin_it_button).
[Follow this project on Github](https://github.com/pderksen/WP-Pinterest-Pin-It-Button)
== Installation ==
You can install this plugin one of three ways:
= 1. Admin Search =
1. In your Admin, go to menu Plugins > Add.
1. Search for `Pin It Button`.
1. Find the plugin that's labeled `Pinterest "Pin It" Button` with "Pin It" in quotes.
1. Look for the author name `Phil Derksen` on the plugin.
1. Click to install.
1. Activate the plugin.
1. A new menu item `Pin It Button` will appear in the main menu.
= 2. Download & Upload =
1. Download the plugin (a zip file) on the right column of this page.
1. In your Admin, go to menu Plugins > Add.
1. Select the tab "Upload".
1. Upload the .zip file you just downloaded.
1. Activate the plugin.
1. A new menu item `Pin It Button` will appear in the main menu.
= 3. FTP Upload =
1. Download the plugin (.zip file) on the right column of this page.
1. Unzip the zip file contents.
1. Upload the `pinterest-pin-it-button` folder to the `/wp-content/plugins/` directory of your site.
1. Activate the plugin through the 'Plugins' menu in WordPress.
1. A new menu item `Pin It Button` will appear in the main menu.
== Frequently Asked Questions ==
= General Troubleshooting =
If the "Pin It" button doesn't get triggered on click (and your browser is redirected to a pinterest.com URL), please make sure that there is not extra code that is hijacking the click event (for example, a Google Analytics onclick event).
A popular known plugin that does this is **Google Analytics for WordPress**. Try unchecking one or both of these options: 1) Track outbound clicks & downloads, 2) Check Advanced Settings, then make sure "Track outbound clicks as pageviews" is un-checked.
Your theme must implement **wp_footer()** in the footer.php file, otherwise JavaScript will not load correctly. You can test if this is the issue by switching to a WordPress stock theme such as twenty-twelve temporarily.
[Visit the complete knowledgebase](http://pinplugins.com/pin-it-button-faq?utm_source=wordpress_org&utm_medium=link&utm_campaign=pin_it_button_lite) for additional help and troubleshooting tips.
CSS styling and shortcode help available within the plugin admin.
== Screenshots ==
1. Button display with count bubble beside
2. Button display with count bubble above
3. General button settings
4. Post visibility and placement settings
5. Style/CSS settings
6. Widget settings
7. Individual post (post meta) settings
== Changelog ==
= 2.1.0.1 - May 8, 2015 =
* Fixed bug with some options getting reset to defaults after an upgrade.
= 2.1.0 - May 4, 2015 =
* Fixed plugin CSS not getting enqueued in some cases.
= 2.0.9 - April 22, 2015 =
* Updated calls to add_query_arg to prevent any possible XSS attacks.
* Fixed bug with button showing up on WooCommerce Products.
* Added option to always enqueue scripts & styles (enabled by default).
* Tested up to WordPress 4.2.
= 2.0.8 =
* Tested up to WordPress 4.1.
* Improved translation (i18n) readiness.
= 2.0.7 =
* Tested up to WordPress 4.0.
* Button will now pin full size image instead of thumbnail.
= 2.0.6 =
* More fixes to special characters rendering HTML codes incorrectly in pin descriptions.
= 2.0.5 =
* Fixed a bug with shortcode buttons not enqueueing CSS & JS correctly.
* Fixed a bug with some characters (such as single quotes) rendering HTML codes in the pin description.
= 2.0.4 =
* Various performance enhancements.
= 2.0.3 =
* Added action and filter hooks for extensibility.
* Fixed a bug with upgrade code being called multiple times.
* Removed PressTrends integration.
* Tested up to WordPress 3.9.
= 2.0.2 =
* Added options for colors, sizes and shapes based on Pinterest's official widget builder.
* Added an option to show count bubble even for zero count pins.
* Minor bug fixes.
* Tested up to WordPress 3.8.
= 2.0.1 =
* Added an option to disable Pinterest's pinit.js JavaScript to avoid conflicts with other Pinterest plugins, themes and custom code (on new "Advanced" tab).
* Tested up to WordPress 3.7.
= 2.0.0 =
* Tested up to WordPress 3.6.1.
* Now in full compliance with current "Pin It" button developer guidelines at .
* More extensive Help section, which was moved to a separate submenu item.
* Updated CSS & JS output so they're much more "light weight" which should improve performance.
* Removed all references to "!important" in the public CSS to allow for more control of styles.
* Implemented more standards from the WordPress Settings API. Settings pages should be more maintainable going forward.
* Settings pages now using tabs to break up functionality.
* Can now specify button type for shortcode and widget. No longer inherits from main settings.
* Fixed so button now shows up on category pages.
* Added is_main_query() check for "the_content" filter.
* Removed show/hide button options on category edit screen (conflicted with post/page visibility changes).
* Optional Presstrends anonymous usage tracking.
= 1.4.3 =
* Fixed bug where Create Pin popup wasn't working in some cases.
= 1.4.2 =
* Tested with WordPress 3.5.
* Added: Option to save settings upon plugin uninstall.
* Changed: Removed "Always show pin count" option as it's no longer supported by Pinterest.
* Changed: Iframe option removed as it's no longer supported by Pinterest.
* Changed: Moved some JavaScript files to load in the footer rather than the header to improve page speed load and compatibility with Pinterest code. Theme must implement wp_footer() to function properly.
* Fixed: Count="vertical" shortcode fixed.
* Fixed: Updated button CSS/styles to improve compatibility with more themes.
* Fixed: Checks theme support for post thumbnails and adds if needed.
* Fixed: Various minor bug fixes.
= 1.4.1 =
* Fixed: Various shortcode fixes.
* Fixed: Moved some JavaScript files that were loaded in the footer to now load in the header to improve compatibility with themes not implementing wp_footer().
* Fixed: Updated button CSS/styles to improve compatibility with more themes.
= 1.4.0 =
* Changed/Fixed: Iframe removed when button set to "User selects image". Fixes security issues and display errors on some web hosts.
* Added: Displays new features available if upgrading "Pin It" Button Pro
= 1.3.1 =
* Changed: Modified button JavaScript to be in line with Pinterest's current button embed JavaScript
* Changed: Split up internal code files for easier maintenance and updates
* Fixed: Shortcode -- If the attributes "url", "image_url" and/or "description" aren't specified, it will try and use the post's custom page url, image url and/or description if found. If not found it will default to the post's url, first image in post and post title.
* Fixed: Changed the way defaults are set upon install so it shouldn't override previous settings
* Fixed: Uninstall now removes custom post meta fields
= 1.3.0 =
* Added: Added a Pin Count option (horizontal or vertical)
* Added: Added new button style where image is pre-selected (like official Pinterest button)
* Added: Added fields for specifying URL, image URL and description for new button style **image pre-selected**
* Added: Added float option for alignment (none, left or right) to widget and shortcode
* Added: Shortcode -- Can now remove div tag wrapper
* Added: Widget -- Can now remove div tag wrapper
* Changed: Moved "Follow" button widget to separate plugin: [Pinterest "Follow" Button](http://wordpress.org/extend/plugins/pinterest-follow-button/)
* Changed: Both button styles now embed iframe (like official Pinterest button)
* Changed: External JavaScript now loads in footer for better performance
* Fixed: Fixed bug where front page was still showing button even when Front Page was unchecked
* Fixed: Fixed bug where some settings weren't saved when upgrading the plugin
* Fixed: Fixed bug where tag, author, date and search archive pages were not displaying the button
= 1.2.1 =
* Fixed: Fixed bug with hiding posts/pages/categories when upgrading from a previous version
= 1.2.0 =
* Added: Added option to hide button per page/post
* Added: Added option to hide button per category
* Added: Added widget to display "Pin It" button
* Added: Added widget to display "Follow" on Pinterest button
* Fixed: Fixed CSS where some blogs weren't displaying the button properly
= 1.1.3 =
* Added: Added option to hide button on individual posts and pages (on post/page editing screen)
= 1.1.2 =
* Fixed: Removed use of session state storing for now as it caused errors for some
= 1.1.1 =
* Fixed: Updated jQuery coding method to avoid JavaScript conflicts with other plugins and themes some were getting
= 1.1.0 =
* Added: Added custom CSS area for advanced layout and styling
* Added: Added checkbox option to remove the button's surrounding `` tag
* Added: Button image and style updated to match Pinterest's current embed code
* Fixed: Changed the way the button click is called to solve pinning issues in Internet Explorer
= 1.0.2 =
* Added: Added checkbox option to display/hide button on post excerpts
* Fixed: "Pin It" links generated by the shortcode should not show up when viewing the post in RSS readers
= 1.0.1 =
* Added: Added checkbox option to display/hide button on "front page" (sometimes different than home page)
= 1.0.0 =
* Added: Added checkbox options to select what types of pages the button should appear on
* Added: Display options above and below content are now checkboxes (one or both can be selected)
* Added: Added shortcode [pinit] to display button within content
= 0.1.2 =
* Changed: Moved javascript that fires on button click to a separate file
= 0.1.1 =
* Fixed style sheet reference
= 0.1.0 =
* Initial release