=== Fan Count ===
Contributors: valendesigns
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_xclick&business=accounts@valendesigns.com&item_name=Fan+Count
Tags: facebook, fan, count, api
Requires at least: 2.7
Tested up to: 3.0.2
Stable tag: 1.2

Returns your Facebook Fan Count (now likes). Reduces the Facebook Graph API calls by updating hourly and serving a database cached result in between.

== Description ==

Returns a database stored Facebook Fan Count in plain text or number format. Reduces the Facebook Graph API calls by only updating the fan count hourly and serving a database cached result in between. The account you're attempting to get a "Fan Count" from must be a page you can become a fan of. Regular account ID's for non-fan pages will return a zero result.

You can use the function `<?php fan_count( $id, $default, $echo, $format ); ?>` in your theme files. The following is an explanation of the parameters the function excepts.

* @param array $ids an array of Facebook IDs
* @param int $default your fallback fan count during a zero result: default 0
* @param bool $echo return or echo: default true (echo)
* @param bool $format return as plain integer or number formatted: default true (number format)

For example, if I was Psdtuts+ and wanted to echo out a fan count that had a fallback or default fan count in the unlikely event nothing is stored in the database or there is a weird zero result returned, I would do the follow.
`<?php fan_count( 'psdtuts', 15000 ); ?>`

If I wanted to save the count to a variable as a plain integer that I could add to another count or something similar I would do this.
`<?php $fan_count = fan_count( 'psdtuts', 15000, false, false ); ?>`

If I wanted to echo a formatted count form an array of $ids with a fallback, I would do this.
`<?php fan_count( array( 'psdtuts', 'nettuts' ), 15000 ); ?>`

== Installation ==

1. Upload `fan-count` folder to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress

== Frequently Asked Questions ==

= Does this plugin require any certain PHP functions? =
Yes! Your server must have `json_decode()` available or the plugin will fail to work properly. Basically, you server needs to be running PHP 5.

== Changelog ==

= 1.2 =
* A change to the Graph API required a slight variable modification

= 1.1 =
* Added the ability to pass in an array of feed IDs

= 1.0 =
* Initial Release

== Upgrade Notice ==

= 1.2 =
* A change to the Graph API broke v1.1