=== Top Shared Posts on Facebook ===
Contributors: elhardoum
Tags: Facebook, count, social, popular, widget, posts, share, social share, top, top-posts, popular-posts, facebook-shares, count-shares, count-shares, social-widgets, social-plugins
Requires at least: 3.0.1
Tested up to: 4.2.1
Stable tag: 0.1
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Fetches total share counts for your blog posts on Facebook and sorts the most shared ones and their total share counts.

== Description ==

Top shared posts on Facebook fetches total share counts for your blog posts on Facebook using Facebook Graph API and sorts the most shared ones in an ascending order together with their total share counts.

<h4>Features:</h4>

* Allows you to list your most shared content on Facebook in a widget,
* Display total Facebook share counts for your blog posts,
* If your blog posts don't have accurate data ( share counts ) or yet you have no posts, then nothing will show.

<h4>How does it work:</h4>

First of all, after install this plugin fetches your blog content to retrieve all your blog posts URLs, then uses <a href="//developers.facebook.com/docs/graph-api">Facebook Graph API</a> to retrieve total Facebook share counts for each posts.

After having the numeric values ( share counts ), it is much easy to sort data in a descending order based on the most shared content.

<h4>How to use:</h4>

It will take you couple seconds to set up this plugin - simply install and activate the plugin, then visit your widgets area within the dashboard ( <code>widgets.php</code> ) to add the plugin widget. 

If you don't have share counts and you are seeing the "nothing found" error, you may want to remove the widget or be patient and wait until you have some accurate data.

<h4>Support:</h4>

Anytime, if you need further assistance and support, don't hesitate to drop us couple lines in the plugin <a href="http://wordpress.org/support/plugin/top-shared-posts-on-facebook/">support forum</a>, or by forwarding your questions & ideas to this email address: sam at elegance-style.com

<h4>Review</h4>

Wether you found a terrible bug, or you liked this plugin and you wanted to say thanks, or you have a suggestion you want us to release in future updates, please consider leaving your feedbacks and reviews in the plugin a href="http://wordpress.org/support/view/plugin-reviews/top-shared-posts-on-facebook">reviews page</a>.

Thanks a lot!

== Installation ==

* Install, activate, add widget:

1. Upload the plugin to your plugins directory, or use the WordPress installer.
2. Activate the plugin through the \'Plugins\' menu in WordPress.
3. Add the plugin widget, update settings and, Enjoy!


== Frequently Asked Questions ==

= I am seeing "Nothing Found" notice - what is wrong ? =

You are seeing this message because:

* Yet you have no blog posts, Or
* Your blog posts still have the "n/a" value as share counts - content never shared.

== Screenshots ==

1. Plugin banner.
2. TSPF preview in the twenty twelve WordPress theme.
3. Nothing found notice, you have no accurate data.
4. TSPF settings page.
5. TSPF widget.

== Changelog ==

= 0.1 =
* Initial release.