=== Jetpack Post Views ===
Contributors: straker503
Tags: jetpack, post views
Requires at least: 3.5
Tested up to: 3.5
Stable tag: 1.0.1
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

A plugin that displays your most popular posts using Jetpack stats.

== Description ==

A plugin that displays your most popular posts using Jetpack stats.

Jetpack Post Views is a plugin that lets you integrate Jetpack stats into your site. Jetpack is a great plugin that lets you track information about your blog, but it doesn’t give you access to this information so you can display it to your visitors. The most common information users wish to have access to are the number of views for a post.

Jetpack Post Views gives you access to this information. This plugin adds a widget that lets you display your top posts by views according to Jetpack stats. As an added bonus, this plugin adds this information to the post meta of each post, allowing you to display those stats anywhere on your site.

This plugin accesses the Jetpack information using http://stats.wordpress.com/csv.php API.

== Installation ==

1. Upload `jetpack-post-views.php` to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Add your unique WordPress API Key (https://apikey.wordpress.com/) to the Jetpack Post Views Widget and click "Save."

**IMPORTANT:** The plugin will only work if you *first* give it a valid WordPress API Key. Jetpack stats are saved uniquely to your WordPress account, so it needs the API key to access the information.

To find your API key, log into https://apikey.wordpress.com/. Enter this key into the “WordPress API key” field in the Jetpack Post Views Widget and click “Save.” The first time a valid API key is entered, the plugin will access the total views for *every* post and add it to the post meta. **This process takes time!** Depending on how many posts you have, this can take up to 5 minutes, so be patient!

Once a valid API key has been entered and the plugin has downloaded all the information, the widget will now display your top posts by views. To display the total views for a post anywhere on your site, just add the following code to your files (such as single.php):

`<?php echo get_post_meta( $post->ID, 'jetpack-post-views', true ); ?>`

The post meta will still work even if the widget is inactive. Stats are updated hourly only if the plugin is active.

== Frequently asked questions ==

= Why are there no FAQs besides this one? =

Because you haven't asked one yet.

== Screenshots ==

1. Jetpack Post Views Widget options.
2. Jetpack Post Views Sidebar that displays top posts for the site.
3. Jetpack Post Views Sidebar with number of views displayed.

== Changelog ==

= 1.0.1 (2013-01-21) =
* Reduced number of API calls made
* Considerably sped up process of adding/updating post meta data to each post
* Added security to widget
* Added uninstall.php file

= 1.0.0 (2013-01-19) =
* Public beta released