Integration with vBulletin - Pinterest Sharing System by BOP5 for VB 3.8 & VB 4.x! (Pinterest Pin Button Mod)

Brought to you by BirdOPrey5
www.Qapla.com

A BIG Thank You to all for voting this May 2012 Mod of the Month!

Version 1.04 - Added showpost compatibility
Version 1.01 - Compatibility fix for dbtech Advanced Thanks/Like mod
Version 1.0 - Initial (Non-Beta) Release

This mod is compatible with all VB 3.8 and 4.x versions released to date. It has been tested on VB 3.8.7, VB 4.1.11, and VB 4.2.0 and should work on older and newer versions as well.

Live Demos:
VB4 Demo: Pinterest Share Demo at Qapla.com
VB3 Demo: Pinterest Share Demo Thread - JUOT - Joe's Ultimate Off Topic

Pinterest is the next big thing in Social Media. It offers a very intuitive and friendly interface for users to share the things they like, use, and appreciate.

Unlike with Facebook or Twitter Pinterest absolutely requires some sort of visual representation of what you are sharing- this takes the form of a thumbnail image of a larger image or a thumbnail of a video.

Previously even if you could incorporate the Pinterest Pin button code into vBulletin there was no way to associate a unique image with every post.

This mod will search east post for any of the following. Priority is given to higher ranked items. The first instance of the first item type found will become the thumbnail sent to Pinterest. Each item can be enabled or disabled from the mod settings.

1) First it will look for YouTube videos. (Either embedded with [VIDEO] BBCode OR regular YouTube links OR YouTube videos embedded with the AME mod.

2) If no YouTube video is found it will next look for links to any external images. These are images that use the [IMG] BBCode.

3) If no external images are found it will look for any inline attachments. In the settings you can specify whether it should share the full sized attached image or only the thumbnail. Guests must have permission to download attachments or to see thumbnails for this option to work.

4) If none of the above find anything the mod can use this option will use avatar of the poster as the thumbnail sent to Pinterest.

5) If the user has no avatar as a last resort you can specify a link to a default forum image (perhaps the forum logo?) that will be submitted as the thumbnail.

Pinterest will not accept any Pins that do not contain a valid, guest accessible, image thumbnail.

You can choose the default description text. You can take text from the post itself, the thread title, or the forum META description. In any case the user always has the option to edit the description before submitting it to Pinterest.

The mod also contains a number of settings that allow you to choose how you want the Pinterest button to look, where you want it, and other basics such as what forums, styles, or usergroups to disable but button for or in.

The mod uses auto template edits for basic use however power-users will want to opt for the manual template edits (explained below) for even better customization and positioning of the Pinterest Pin Button.

Known Issues:
Using the recommended locations and settings the mod is working well on VB 3.8 and VB 4.x as you can see in the demo links above. However adding the Pinterest button causes some visual changes in some browsers.

For example in VB 4 with Chrome browser if you quick-edit a post with the Pinterest button the editor toolbar is pushed down lower than normal. Everything works it's just different than you are used to. In Firefox however the editor toolbar looks fine.

In VB 3 in the post message area location the "numbers" from the pin button are outside the border of the main table. This is somewhat on purpose- I think having the count outside the box draws more attention to them. Unfortunately if you don't like that all I can suggest is to disable the count completely because I am not a style expert. You are free however to do the manual template edit including in the instructions (and below) to find the perfect spot for your Pin button on your style(s).

Please Mark as Installed if you use this.
Donations Always Appreciated. :up:

[BirdOPrey5]

Manual Template Edits

If you have a customized style and the auto edits don't work, or you simply want more control over where the button is and how it looks make one of the manual edits below.

If you are using VB 4.x:

Edit the template postbit or postbit_legacy depending on which one you use on your forum.

Find the code:

<div class="content<vb:if condition="$show['first_ad'] OR $show['last_ad']"> hasad</vb:if>">

Directly before (or above) that code paste in:

{vb:raw template_hook.postbit_bop_pinterest}

This will show the Pinterest button in the default VB4 location. Feel free to move the template_hook code anywhere in the postbit template for your own custom solutions.

Edit the template postbit_pinterest_vb4 to further customize the button.


If you are using VB 3.x:

Edit the template postbit or postbit_legacy depending on which one you use on your forum.

Find the code:

<div id="post_message_$post[postid]">

REPLACE that code with this code:

 <div id="post_message_$post[postid]" style="min-height:60px; position:relative; "> $template_hook[postbit_bop_pinterest]

This will show the Pinterest button in the default VB3 "message Area" location. Feel free to move the template_hook code anywhere in the postbit template for your own custom solutions.

Edit the template postbit_pinterest_vb3 to further customize the button.

[datoneer]

Doesn't work cannot see anything

[BirdOPrey5]

1) Did you enable the mod and choose the settings (button location and enabled searches(video/image/attachment/etc..)) ?

2) If you did and you have a heavily customized style (like the forum in your sig) you may need to do a manual template edit-
Search your postbit_legacy template and see if you have this line:

<div class="content<vb:if condition="$show['first_ad'] OR $show['last_ad']"> hasad</vb:if>">

If you don't or it's not exactly that you will need to do a manual edit.

3) I forgot to mention this mod likely will not find images or attachments if you use the DbTech Advanced Post Thanks/Like mod. Not sure if that applies.

Also please give me a link to a post that actually has an image or video in it- I browsed a few threads on your forum and couldn't find any such content.

[Hornstar]

Shame it does not work with the thanks mod from dbtech

[BirdOPrey5]

Originally Posted by Hornstar

Shame it does not work with the thanks mod from dbtech

It would still find videos and it would still allow avatar or forum logo sharing- just external images and attachments won't work.

I downloaded the dbtech mod to see if I could figure out a way to make them compatible but I can't make heads or tails of dbtech code.

If dbtech could fix their mod so they don't parse the $post['pagetext'] value- or even if they copied $post['pagetext'] to something like $post['noparse'] before parsing I could easily add code to detect if their mod is installed and if so use the alternate $post['noparse'] value when searching for images and attachments.

Those with a coding background may ask why don't I just search the parsed text for images <img> instead of [IMG]. The answer is because if I search parsed text for images and the first image is simply a smiley then the smiley would be the "thumbnail" which isn't going to work well for sharing on Pinterest.

Let me try and contact them and see if they have a solution.

[BirdOPrey5]

A big thanks to dbtech for getting back to me quickly with a fix for the conflict.

Version 1.01 released which should work fine the the Advanced Thanks/Like mod. :up:

[larrydude]

It Works!!!! You are awesome!!!!!!!!!!!!!!!!!!!!!!!!

[faisaly.com]

Where does this pin the info to, google? not sure I get this... nothing mentioned really what this does... only that it grabs pics and videos from post unlike twitter and facebook, but where do they get posted...

[BirdOPrey5]

They get posted to the social networking site "Pinterest" - http://pinterest.com

It's a relatively new fast growing social media site. I think it's currently ranked the 4th largest behind Facebook, Twitter, and YouTube.