Skip to main content
  1. All Posts/

facebook-tools

Tools Open Source PHP WordPress
=== Plugin Name ===
Contributors: theuprising
Donate link: http://theuprisingcreative.com/
Tags: Facebook, connect, comments, fb, tools, social, network, media, like, api
Requires at least: 3.0.2
Tested up to: 3.2.1
Stable tag: 1.2.1

Easily integrate Facebook social plugins to your WordPress blog/site with simple template functions.

== Description ==

Easily integrate Facebook social plugins to your WordPress blog/site with simple template functions.
See below for full list of features, and how to use the plugin.

= Features =
* Auto Insertion of OpenGraph tags
* Like Button
* Send Button
* Comments Box
* Retrieve Facebook Comments

= More Information =

For more information, please read the Facebook documentations at http://developers.facebook.com/docs/plugins/

= Like Button =

Display the Facebook Like button on any page.

*Note: The Open Graph description tag will default to the site's Tagline if their is no excerpt.*

To use, add `<?php fb_likebutton(); ?>` within the Loop.

*Parameters*

* $href			(string)	Defaults to the current post/page's permalink if not set
* $layout		(string)	Choices: 'standard', 'button_count', 'box_count'
* $width		(integer)	Width of the like button (in pixels)
* $colorscheme	(string)	Choices: 'light', 'dark'
* $action		(string)	Choices: 'like', 'recommend'
* $send			(boolean)	Include the send button?

= Send Button =

Display the Facebook Send button on any page.

*Note: The Open Graph description tag will default to the site's Tagline if their is no excerpt.*

To use, add `<?php fb_sendbutton(); ?>` within the Loop.

*Parameters*

* $href			(string)	Defaults to the current post/page's permalink if not set
* $font			(string)	Choices: 'arial', 'lucida grande', 'segoe ui', 'tahoma', 'trebuchet ms', 'verdana' 
* $colorscheme	(string)	Choices: 'light', 'dark'
* $ref			(string)	A label for tracking referrals; must be less than 50 characters and can contain alphanumeric characters and some punctuation (currently +/=-.:_).

= Comments =

Display the Facebook comment box for the current page/post. To retrieve the comment count, please see Comment Count.

To use, add `<?php fb_comments(); ?>` within the Loop.

*Parameters*

* $xid			(string)	A unique identifier for the current object
* $width		(integer)	Width of the comment box (in pixels)
* $numposts		(integer)	Number of posts to display
* $migrated		(boolean)	True to display the new comment box, false to display the old comment box
* $reverse		(boolean)	Reverse the comments order (legacy only)
* $css			(string)	Location of the custom CSS for the comment box (legacy only)

= Comment Count =

Display the comment count for the current page/post.

To use, add `<?php fb_commentcount(); ?>` within the Loop.

*Parameters*

* $xid			(string)	A unique identifier for the current object
* $return		(boolean)	Return the raw count number (Default: false)

= Get Comments =

Retrieve all comments in a standard PHP object

To use, add `<?php fb_get_comments(); ?>` within the Loop.

*Parameters*

* $xid			(string)	A unique identifier for the current object
* $migrated		(boolean)	True to fetch results from the new comment box object, false to fetch from the legacy comment box

== Installation ==

This plugin requires a Facebook API key. You can get one here: http://developers.facebook.com/

1. Upload the plugin folder to the */wp-content/plugins/* directory
1. Activate the plugin through the *Plugins* menu in WordPress
1. Go to *Facebook Tools* menu and fill out your Facebook application information with obtained from Facebook.
1. Make sure your template is calling *wp_head()* and *wp_footer()* to allow loading of the Facebook API library.

== Changelog ==

= 1.2.1 =
* Fixed fb_commentcount() bug returning the incorrect href attribute
* Added a new parameter to fb_commentcount() to allow for returning the count instead of directly echoing it out.
* Fixed fb_likebutton() "send" bug
* Updated/fixed the fb_likebutton() and fb_sendbutton() to fall back on the current item in The Loop if no pass "href" attribute is passed in the parameters.
* Fixed the XML warning for fb_commentcount()

= 1.2.0 =
* Added the new Facebook Send button. (See instructions for usage example)
* Updated the Like button to include the new "send" parameter

= 1.1.1 =
* Added the ability to disable the automatic insertion of the Open Graph tags (in Facebook Tools > Facebook Tools panel).

= 1.1 =
* Organized plugin folder
* Fixed some PHP/WP error and warning messages
* Template functions now accept parameters to override the default settings
* New template function called fb_get_comments() which return an object containing all comments (used within the Loop)
* Added a new parameter/setting for the new dark color scheme in the new Comments box that was announced on April 13, 2011.

= 1.0.5 =
* Fixed fb_commentcount() bug on category pages.

= 1.0.4 =
* Updated the *Facebook Tools* to allow switching between the legacy and new comment box. This update fixes the *fb_commentcount()* template function.
* Added the ability to load stylesheet for legacy comment box.

= 1.0.3 =
* Updated readme.txt (fixed PHP sample code)

= 1.0.2 =
* Fixed Plugin update and readme.txt file.

= 1.0.1 =
* Open Graph tags are now automatically added to the header.

= 1.0 =
* Plugin is now public!