BE Stats

This is a helper plugin to allow you to build WordPress queries using WordPress.com stats.

This plugin uses the WordPress.com stats (packaged in Jetpack) to find out your most popular posts. You must be running Jetpack for this plugin to work. I recommend running Jetpack for at least 30 days to get useful data.

It asks for the 100 most popular posts over the past 30 days. This includes both posts and pages, since their stats don’t let you filter based on post type. I filter this list down to just posts and then store its ranking as post meta (‘be_stats’).

You can write custom queries to list popular posts, or use the Display Posts Shortcode plugin to do it for you. Examples using the shortcode plugin:

[display-posts orderby=”popular”] – Lists the 10 most popular posts
[display-posts orderby=”popular” posts_per_page=”4″] – Lists the 4 most popular posts
[display-posts orderby=”popular” posts_per_page=”4″ tag=”basic”] – Lists the 4 most popular posts tagged “basic”

For Developers

There are a few filters available to you for customization. Refer to the plugin’s code for more information.

be_stats_args – arguments passed to WordPress.com Stats API.
Default: array( ‘days’ => 30, ‘limit’ => 100 )
Example: http://www.billerickson.net/code/customize-be-stats-arguments/

be_stats_update – Conditional for determining if stats data should be saved
Default: ‘post’ == get_post_type()
Example: http://www.billerickson.net/code/be-stats-change-ranking-conditions/