Description
NOTICE: I am no longer maintaining this plugin. Jetpack does not provide the necessary functionality to reliably and easily update post views for more than 500 posts. I am tired of trying to hack a solution that ultimately doesn’t work. If anyone wants to continue to maintain the plugin feel free to download the code.
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.
a
Screenshots
Installation
- Upload
jetpack-post-views.php
to the/wp-content/plugins/
directory - Activate the plugin through the ‘Plugins’ menu in WordPress
- Upon activation, stats will be downloaded automatically and entered into the post meta for each post. This process takes time! Depending on how many posts you have, this can take up to 5 minutes, so be patient!
NOTE: If the plugin does not work, go to the settings page and try entering in your WordPress API Key.
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 Settings page and click “Save Changes.”
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 ); ?>
To display views for a day, week, month, or year, add the appropriate code:
<?php echo get_post_meta( $post->ID, 'jetpack-post-views-Day', true ); ?>
<?php echo get_post_meta( $post->ID, 'jetpack-post-views-Week', true ); ?>
<?php echo get_post_meta( $post->ID, 'jetpack-post-views-Month', true ); ?>
<?php echo get_post_meta( $post->ID, 'jetpack-post-views-Year', true ); ?>
Stats are updated hourly only if the plugin is active.
FAQ
- Help! My posts aren’t updating!
-
There are many factors that could go wrong that would prevent a post from updating. Before you submit a support ticket, please ensure that:
- the plugin can access Jetpack – go to the Jetpack Post Views Settings page and make sure that at least one of the connections is green
- the post is getting views – go to your Jetpack Stats page and make sure that the post is actually getting views
- an entire day has gone by with no updates – Jetpack Post Views only updates once every hour, so letting a day go by will make sure that the plugin truly isn’t working
If the post still isn’t updating, please open a support ticket and include the following information along with a description of what the problem is. This will help me try to identify where the problem could be:
- Is the post a custom post type?
- Does the post belong to a custom category/tag?
- Does your site have over 500 posts?
- In the Jetpack Post Views Settings page, which of the 3 connections are green?
- How can I display the top posts in my template?
-
Use the function ‘JPV_display_top_posts()’
Usage
Default Usage
‘-1’,
‘limit’ => ‘5’,
‘exclude’ => ”,
‘excludeCustomPostTypes’ => false,
‘displayViews’ => false ); ?>
Parametersdays – (string) The number of days of the desired time frame. ‘-1’ means unlimited.
limit – (string) The number of posts to display. ‘-1’ means unlimited. If days is -1, then limit is capped at 500.
exclude – (string) A comma-separated list of Post IDs to be excluded from displaying.
excludeCustomPostTypes – (boolean) Excludes custom post types from displaying.
displayViews – (boolean) Displays the post views.
NOTE This function only works if the function
stats_get_csv()
exists. If this function is not working probably, it is probably due to thestats_get_csv()
function not returning the needed results. - How can I display the top posts in my posts?
-
Use the shortcode ‘[jpv]’
The shotcode uses the same parameters as the ‘JPV_display_top_posts()’ function
Reviews
Contributors & Developers
“Jetpack Post Views” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Jetpack Post Views” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.1.0 (2013-12-10)
- Fixed the upgrade script so that it actually runs
- Fixed a bug in the uninstall script
1.0.9 (2013-12-8)
- Filters for post type and category now work for all Time Intervals
- Fixed the Total View column error in the “All Posts” page for posts that were not published
- Added an option in the Settings page to display Total Views in the “All Posts” page (defaults to off)
- Added post meta for each time interval (Day, Week, Month, Year)
- Widgets set to display Popular Posts with Time Interval: Day should no longer disappear when stats reset (although post output will likely be random)
- Can now disable the use of the Jetpack get_stats_csv function to get popular posts using either Blog URI or Blog ID id desired
1.0.8 (2013-10-4)
- Removed cached widget output as it was causing too many problems
1.0.7 (2013-09-28)
- Added a “Total Views” column to the Posts admin page
- Added different display types to the widget
- Cached the widget output
- Allowed custom post types to update and display
- Added filters for post type and category to widget output (feature only works for Time Interval of Unlimited)
1.0.6 (2013-05-29)
- New post now update properly
1.0.5 (2013-05-21)
- Fixed posts not properly displaying post views
- Fixed database access to tables using ‘wp_’ table prefix to use prefix defined in wp-config.php
- Added shortcode
1.0.4 (2013-03-14)
- Added the
JPV_display_top_posts()
function to display top posts in a template - Added widget options to exclude posts by ID and to display a different time frame
1.0.3 (2013-02-10)
- Plugin can now access Jetpack stats without needing a WordPress API Key first. (Special thanks to topher1kenobe for helping me with this)
- Added a settings page to help those unable to access stats normally enter in the needed information to access the stats via the Jetpack API
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