The Arcive of Official vBulletin Modifications Site.

About Developer · **Released**: 05-14-2010

This modification will add OpenGraph tags to all pages, adding your Content pages to the Open Graph, along with the Facebook 'Like Button' under the navbar for all 'Content' pages.

What does this mean? If you have a Facebook Profile you may have noticed the new layout, where things that you 'like' are arranged by 'type'. Adding OpenGraph tags ensures you will have your pages properly classified and included.

From The Open Graph Protocol :

Quote:

The Open Graph protocol enables any web page to become a rich object in a social graph. For instance, this is used on Facebook to enable any web page to have the same functionality as a Facebook Page.
Basic metadata
To turn your web pages into graph objects, you need to add basic metadata to your page. We've based the initial version of the protocol on RDFa which means that you'll place additional <meta> tags in the <head> of your web page. The four required properties for every page are:

og:title - The title of your object as it should appear within the graph, e.g., "The Rock".
og:type - The type of your object, e.g., "movie". Depending on the type you specify, other properties may also be required.
og:image - An image URL which should represent your object within the graph.
og:url - The canonical URL of your object that will be used as its permanent ID in the graph, e.g., "http://www.imdb.com/title/tt0117500/".

Install Instructions:
AdminCP - Plugins & Products - Manage Products - [Add/Import Product] , browse to the location of the .xml file you downloaded from this thread, Import it.
Template Modifications
In whichever Templates you wish to have all Features (OpenGraph), you need to add the xmlns to the head.

ie:, find:

PHP Code:


			
<html xmlns="http://www.w3.org/1999/xhtml"<vb:if condition="$vboptions['enablefacebookconnect']"> xmlns:fb="http://www.facebook.com/2008/fbml"</vb:if> dir="{vb:stylevar textdirection}"

Replace with:

PHP Code:


			
<html xmlns="http://www.w3.org/1999/xhtml"<vb:if condition="$vboptions['enablefacebookconnect'] || $vboptions['ogfb_onoff']"> xmlns:fb="http://www.facebook.com/2008/fbml"</vb:if><vb:if condition="$vboptions['ogfb_onoff']"> xmlns:og="http://opengraphprotocol.org/schema/"</vb:if> dir="{vb:stylevar textdirection}"

(If there is a way to do this with plugins that wont cause major issues, someone tell me so I can make it happen that way.

)

Titles
These should be part of the meta tag template that gets plugged in, but figuring out how to pass these variables is lower priority to getting this modification stable, so you need to add them in the templates.

ie: in SHOWTHREAD, find:

PHP Code:


			
{vb:raw headinclude}

Add under:

PHP Code:


			
<meta property="og:title" content="{vb:raw thread.title}" />

in FORUMDISPLAY, find:

PHP Code:


			
{vb:raw headinclude}

Add under:

PHP Code:


			
<meta property="og:title" content="{vb:raw foruminfo.title}" />

in MEMBERINFO, find:

PHP Code:


			
{vb:raw headinclude}

Add under:

PHP Code:


			
{vb:raw headinclude}

<meta property="og:title" content="{vb:raw prepared.username}'s Profile"/>

<meta property="og:description" content="{vb:raw prepared.username}'s Profile "/>

<meta property="og:image" content="<vb:if condition="$vboptions['profilepicenabled']"><vb:if condition="$prepared['profilepicurl']">http://www.nzboards.com/{vb:raw prepared.profilepicurl}<vb:else />http://www.nzboards.com/{vb:stylevar imgdir_misc}/unknown.gif</vb:if></vb:if>"/>

To add the Like Button, in navbar, find:

PHP Code:


			
{vb:raw ad_location.global_below_navbar}

add under:

PHP Code:


			
<vb:if condition="THIS_SCRIPT != 'login' AND THIS_SCRIPT != 'private' AND THIS_SCRIPT != 'register' AND THIS_SCRIPT != 'usercp' AND THIS_SCRIPT != 'faq' AND THIS_SCRIPT != 'search' AND THIS_SCRIPT != 'newreply' AND THIS_SCRIPT != 'newthread' AND THIS_SCRIPT != 'sendmessage' AND THIS_SCRIPT != 'payments'">{vb:raw fbog_likebutton}</vb:if>

For sites running any form of Facebook Connect - You must use iFrame

Due to the new SDK not yet having Connect, and the 2 flavours of FB not mixing with each other, if you want to use Connect, you have to forgo the extra features of the SDK version that this modification ships with. 0.7 now has logic to show either or, depending on whether you have vB's native FB Connect turned on.

If you don't want to upload to v0.7+ (or are using YAFB or another Connect), replace the content of fbog_like_showthread with:

Code:

<div style="padding: 5px; border: 1px solid #3F6F81; background: #ffffff; font-size: 10px; width: 300px;">
<iframe src="http://www.facebook.com/plugins/like.php?href={vb:raw vboptions.bburl}{vb:raw relpath}&amp;layout=standard&amp;show_faces=true&amp;width=450&amp;action=like&amp;font&amp;colorscheme=light&amp;height=80" scrolling="no" frameborder="0" style="border:none; overflow:hidden; width:450px; height:80px;" allowTransparency="true"></iframe>
</div>

Configuration Instructions
AdminCP - Settings - Options - Opengraph/Facebook Integration
Global On/Off - Set to Yes to turn the system on.
FB - Page Admins - A comma-separated list of the Facebook IDs of the Admins of your pages on Facebook.
FB - API Key - The API Key of your Facebook Application.
OG - Site Name - A short, human-readable name for your site that will appear in the Like on the User's Facebook Activity Stream.

It is important to fill in these, as they are used by FB to fill in some of the information, and allows your pages to be referenced in the Open Graph.

New in Latest Version
Activity Stream -

Quote:

The Activity Feed plugin displays the most interesting recent activity taking place on your site. Since the content is hosted by Facebook, the plugin can display personalized content whether or not the user has logged into your site. The activity feed displays stories both when users like content on your site and when users share content from your site back to Facebook. If a user is logged into Facebook, the plugin will be personalized to highlight content from their friends. If the user is logged out, the activity feed will show recommendations from your site, and give the user the option to log in to Facebook.

The plugin is filled with activity from the user's friends. If there isn't enough friend activity to fill the plugin, it is backfilled with recommendations. If you set the recommendations param to true, the plugin is split in half, showing friends activity in the top half, and recommendations in the bottom half. If there is not enough friends activity to fill half of the plugin, it will include more recommendations.

Recommendations Box -

Quote:

The Recommendations plugin shows personalized recommendations to your users. Since the content is hosted by Facebook, the plugin can display personalized recommendations whether or not the user has logged into your site. To generate the recommendations, the plugin considers all the social interactions with URLs from your site. For a logged in Facebook user, the plugin will give preference to and highlight objects her friends have interacted with.

You specify a site for which to show recommendations for. The domain is matched exactly, so a plugin with site=facebook.com would not include URLs from developers.facebook.com. You cannot currently aggregate across multiple domains.

Both of these options have an on/off toggle in the main FB/OG Options, and are currently manual template placements in postbit or postbit legacy.

Find:

PHP Code:


			
                        <vb:if condition="$post['isfirstshown']">

                            {vb:raw ad_location.ad_showthread_firstpost_start}

                            {vb:raw ad_location.thread_first_post_content}

                        </vb:if>

                        <vb:if condition="$post['islastshown']">

                            {vb:raw ad_location.thread_last_post_content}

                        </vb:if>

Replace with:

PHP Code:


			
                        <vb:if condition="$post['isfirstshown']">

                            {vb:raw ad_location.ad_showthread_firstpost_start}

                            {vb:raw ad_location.thread_first_post_content}{vb:raw ogfb_activity}

                        </vb:if>

                        <vb:if condition="$post['islastshown']">

                            {vb:raw ad_location.thread_last_post_content}

{vb:raw ogfb_recommendations}

                        </vb:if>

Demo of how they will look: http://www.nzboards.com/the-lounge/r...on-sale-90544/

Changelog.
0.7 - 19.05.2010
"Recommendations actually works, and iFrame version for Connect Users" Version.

0.6 - 18.05.2010
"Removing extra, unnecessary code" Version.

0.5 - 16.05.2010
"Activity and Recommendations" Version.

0.4 - 16.05.2010
"Content Pages" Version.
Both plugins moved to parse_templates so as to work on CMS (and to futureproof?)

0.3 - Unreleased
"Content Pages.. but not CMS? It's CALLED content for God's sake! Ahh. global_start isn't called on the CMS." Version.

0.2 - Unreleased
"Why won't it work on the bloody.. oh, I was changing plugins on the vbseo site version. Lets just throw everything into all the plugins and cross our fingers" Version.

0.1 - 15.05.2010
Initial Release.
Works on Showthread only

What's Next?
This is an early beta release to gauge the interest in Open Graph/Facebook type stuff.
[s]I intend to add the tags to other pages,[/s] and implement some of the other Facebook Social Plugins. These will all be On/Off configurable. Some can be seen in action at:

View Profile: kall - New Zealand Boards - Like for Member Profiles
http://www.nzboards.com/the-lounge/r...on-sale-90544/ - Activity and Recommendation Streams in first and last post.

Xencored · #32 05-16-2010, 07:17 PM

Quote:

Originally Posted by kall

That was the plan.. how 'doesnt it work'?

*edit* You do have to put the code in the navbar template at the moment...

Dam i dont want it in the navbar :/

thats why its not working than

kall · #33 05-16-2010, 07:33 PM

It doesn't really *look* like it's in the navbar, not in the traditional sense like a button..

http://www.nzboards.com/the-lounge/r...on-sale-90544/ - see it there? That's not cool?

Where did you want it exactly? I'm in the beginnings of a nasty head cold, so I'll try to see how to explain it. (Basically, you should be able to get it to display in any template by adding that template to the PreRegister stuff in the plugins.)

Xencored · #34 05-16-2010, 07:44 PM

Quote:

Originally Posted by kall

It doesn't really *look* like it's in the navbar, not in the traditional sense like a button..

http://www.nzboards.com/the-lounge/r...on-sale-90544/ - see it there? That's not cool?

Where did you want it exactly? I'm in the beginnings of a nasty head cold, so I'll try to see how to explain it. (Basically, you should be able to get it to display in any template by adding that template to the PreRegister stuff in the plugins.)

Ah i see
well am trying to add it in
Template: blog_show_entry (id: 1924)
Template: album_pictureview (id: 1926
Template: postbit_legacy (id: 1809)
Template: vbcms_content_article_page (id: 1925)
Template: 8WR_media_details (id: 2407)
Sorry about your head
Tho my head has been killing me all this week trying to get this to work also
So i feel your pain lol

Thanks again
Kall

If you could give me a example of one of those am sure will pick it up ok / or maybe not

kall · #35 05-16-2010, 07:51 PM

postbit_legacy? *sigh* That other mod has totally corrupted everyone. It's not supposed to be for the post.. unless it's showpost.php, it's supposed to be for the page. (If you wanted it on every post, it can't.. because it would show the same 'page' for every post and the click would give the Like to that page, not the individual post.)

Having said that..

Under this line in the Navbar and Metatag plugins:

PHP Code:


			
vB_Template::preRegister('blog_entry',array('facebook_liked_url' => $facebook_liked_url));

Try adding:

PHP Code:


			
vB_Template::preRegister('blog_show_entry',array('facebook_liked_url' => $facebook_liked_url));

(adding whatever template you want it to show in.)

Xencored · #36 05-16-2010, 08:03 PM

Quote:

Originally Posted by kall

postbit_legacy? *sigh* That other mod has totally corrupted everyone. It's not supposed to be for the post.. unless it's showpost.php, it's supposed to be for the page. (If you wanted it on every post, it can't.. because it would show the same 'page' for every post and the click would give the Like to that page, not the individual post.)

Having said that..

Under this line in the Navbar and Metatag plugins:

PHP Code:


			
vB_Template::preRegister('blog_entry',array('facebook_liked_url' => $facebook_liked_url));

Try adding:

PHP Code:


			
vB_Template::preRegister('blog_show_entry',array('facebook_liked_url' => $facebook_liked_url));

(adding whatever template you want it to show in.)

Awesome and sorry about the postbit_legacy it worked so didnt think anything was wrong

Thanks for the code above, Now i just want to see if i got this right

Lets say am doing this one "8WR_media_details"

PHP Code:


			
vB_Template::preRegister('8WR_media_details',array('facebook_liked_url' => $facebook_liked_url));

Just add that same as you just said?
Thanks again Kall <3

kall · #37 05-16-2010, 08:05 PM

Quote:

Originally Posted by Animemike

Awesome and sorry about the postbit_legacy it worked so didnt think anything was wrong

Thanks for the code above, Now i just want to see if i got this right

Lets say am doing this one "8WR_media_details"

PHP Code:


			
vB_Template::preRegister('8WR_media_details',array('facebook_liked_url' => $facebook_liked_url));

Just add that same as you just said?
Thanks again Kall <3

That should do it.. I'm not entirely happy with the way I have coded it, it's all probably doubled-up and not needed in both, but hey.. it's Beta, and as long as it works, right?

kall · #38 05-16-2010, 08:21 PM

Quote:

Originally Posted by hornstar1337

It this not going to be default in vb4.0.4?
thanks for taking the time, but I just feel it will be here in less then a month.

Here's the source - Adrian's blog:

Quote:

Open Graph and Social Plug-ins
Facebook has come up with a protocol that allows external webpages to fit into their social graph model using meta tags. The basic idea behind Open Graph is that web publishers can add certain meta tags to their webpages that will classify the page according to FB's graph schema. Then, the publisher can add a social plug-in, like the "Like Button" to this web page. The web page then becomes a part of Facebook's social graph, and user's can "Like" your webpage, and it will show up in the user's "About Me" section classified by the meta tags from the page. There are many ways we can leverage this functionality with vBulletin, but off the top of my head I believe we can classify threads, blog posts, and articles with dynamic meta data about the content, add a plug-in (configurable from admincp of course), and allow users to share and discuss vB content from within Facebook. While this may seem like we lose traffic to Facebook, it will actually make vBulletin activity more visible, and should increase participation on the vBulletin boards.
http://developers.facebook.com/docs/opengraph
http://developers.facebook.com/docs/...e/plugins/like

Xencored · #39 05-16-2010, 08:38 PM

Quote:

Originally Posted by kall

That should do it.. I'm not entirely happy with the way I have coded it, it's all probably doubled-up and not needed in both, but hey.. it's Beta, and as long as it works, right?

Dont work mate :/ tryed all the templates i listed using
Just dont show the button

Code:

<vb:if condition="THIS_SCRIPT != 'login' AND THIS_SCRIPT != 'private' AND THIS_SCRIPT != 'register' AND THIS_SCRIPT != 'usercp' AND THIS_SCRIPT != 'faq' AND THIS_SCRIPT != 'search' AND THIS_SCRIPT != 'newreply' AND THIS_SCRIPT != 'newthread' AND THIS_SCRIPT != 'sendmessage' AND THIS_SCRIPT != 'payments'">{vb:raw fbog_likebutton}</vb:if>

Too add the button

kall · #40 05-16-2010, 08:47 PM

Try just {vb:raw fbog_likebutton} (the conditional is because it's in navbar).

Did you add the new line for the template to both plugins?

Xencored · #41 05-16-2010, 08:53 PM

Quote:

Originally Posted by kall

Try just {vb:raw fbog_likebutton} (the conditional is because it's in navbar).

Did you add the new line for the template to both plugins?

Yea i added them to both mate and that didnt work also

X vBulletin 3.8.12 by vBS Debug Information
Page Generation 0.04784 seconds Memory Usage 2,422KB Queries Executed 26 (?)
More Information
Template Usage: (1)SHOWTHREAD (1)ad_footer_end (1)ad_footer_start (1)ad_header_end (1)ad_header_logo (1)ad_navbar_below (1)ad_showthread_beforeqr (2)bbcode_code (18)bbcode_php (11)bbcode_quote (1)footer (1)forumjump (1)forumrules (1)gobutton (1)header (1)headinclude (1)modsystem_post (1)navbar (4)navbar_link (120)option (1)pagenav (1)pagenav_curpage (4)pagenav_pagelink (11)post_thanks_box (11)post_thanks_button (1)post_thanks_javascript (1)post_thanks_navbar_search (11)post_thanks_postbit_info (10)postbit (7)postbit_attachment (11)postbit_onlinestatus (11)postbit_wrapper (1)spacer_close (1)spacer_open (1)tagbit_wrapper Phrase Groups Available: global inlinemod postbit posting reputationlevel showthread	Included Files: ./showthread.php ./global.php ./includes/init.php ./includes/class_core.php ./includes/config.php ./includes/functions.php ./includes/class_hook.php ./includes/modsystem_functions.php ./includes/functions_bigthree.php ./includes/class_postbit.php ./includes/class_bbcode.php ./includes/functions_reputation.php ./includes/functions_post_thanks.php Hooks Called: init_startup init_startup_session_setup_start init_startup_session_setup_complete cache_permissions fetch_threadinfo_query fetch_threadinfo fetch_foruminfo style_fetch cache_templates global_start parse_templates global_setup_complete showthread_start showthread_getinfo forumjump showthread_post_start showthread_query_postids showthread_query bbcode_fetch_tags bbcode_create showthread_postbit_create postbit_factory postbit_display_start post_thanks_function_post_thanks_off_start post_thanks_function_post_thanks_off_end post_thanks_function_fetch_thanks_start post_thanks_function_fetch_thanks_end post_thanks_function_thanked_already_start post_thanks_function_thanked_already_end fetch_musername postbit_imicons bbcode_parse_start bbcode_parse_complete_precache bbcode_parse_complete postbit_attachment postbit_display_complete post_thanks_function_can_thank_this_post_start pagenav_page pagenav_complete tag_fetchbit_complete forumrules navbits navbits_complete showthread_complete
Messages:

The Arcive of Official vBulletin Modifications Site.

It is not a VB3 engine, just a parsed copy!