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:

[brandon515]

Awesome, thx. Installed.

Also installed Facebook mod.

[jdougher]

Nice mod. But why doesn't the Pin image show up when images are attached to a thread rather than posted via the IMG tag? I've enabled viewing and downloading of attached images for guests, as explained in the installation file, but still there's no Pin image.

[BirdOPrey5]

Are they inline attachments?

This version only looks for inline attachments. I am working on an update to take a any image attachment.

[doctorsexy]

Works great..thanks

[Dwarden]

would be possible to monitor custom BB codes with the PinInterest plugin ?
e.g. add text field for variable into Admin CP options of the plugin where these can be set

let say i have SoundCloud BB codes [sc] , so i would define it to be pin-able

[Dwarden]

another suggestion , would be possible to offer ability to enable / disable for user in his user profile settings ? and if enabled then he could set if allow / not allow javascript variant?

[yesfans]

I am confused on one point. If a post has an Avatar, a pic posted, a pic in the sig line, and maybe a video, how do you choose which one to PIN.

[yesfans]

None the less, MOTM. I think it is a good one and is a little ahead of the curve with the growing interest in that pinterest stuff. My wife plays with that site all the time.
So when it is pinned the pinned item is linked back to my site? If so that is great. MORE EXPOSURE!

[BirdOPrey5]

Originally Posted by Dwarden

would be possible to monitor custom BB codes with the PinInterest plugin ?
e.g. add text field for variable into Admin CP options of the plugin where these can be set

let say i have SoundCloud BB codes [sc] , so i would define it to be pin-able

Monitoring custom bbcodes may be possible but the thing is they need an IMAGE to be pinned. YouTube is very popular so I manually programmed in a way to pull the thumbnail provided by youtube from the video URL. I could make an option to add [sc] to the list of bbcodes but if it doesn't link to an image the pin will fail. So really the only custom bbcodes would be useful is if they were variants of [img]. So if people had custom IMG bbcodes for aligned images or such they could add their bbcodes to a list.

It is a good idea I will try to implement but I'm afraid it may not work on soundcloud.

Originally Posted by Dwarden

another suggestion , would be possible to offer ability to enable / disable for user in his user profile settings ? and if enabled then he could set if allow / not allow javascript variant?

What I could do is add an option for it to work with a Custom User Profile Field you define. It will work basically the same way but the admin will need to setup the profile field. It would be too much work to make a separate profile field generated by this mod- it means database changes and template edits that were otherwise unnecessary.

Originally Posted by yesfans

I am confused on one point. If a post has an Avatar, a pic posted, a pic in the sig line, and maybe a video, how do you choose which one to PIN.

The mod gives priority to any youtube video it finds in the post.
If no video is found it looks for the first external image in the post.
If no external image is found it looks for an inline image attachment in the post...
If none of the above it looks for an avatar
If no avatar it looks to see if you defined a fallback image in settings (like a logo.)

It doesn't look in signatures at all.

Originally Posted by yesfans

None the less, MOTM. I think it is a good one and is a little ahead of the curve with the growing interest in that pinterest stuff. My wife plays with that site all the time.
So when it is pinned the pinned item is linked back to my site? If so that is great. MORE EXPOSURE!

THANKS! Yes it links back to your site.

[yesfans]

So one can not choose which thing to PIN if there are multi things in a post?