=== WP-PostViews === Contributors: GamerZ Donate link: http://lesterchan.net/site/donation/ Tags: views, hits, counter, postviews Requires at least: 3.0 Tested up to: 4.1 Stable tag: 1.69 Enables you to display how many times a post/page had been viewed. == Description == = Build Status = [![Build Status](https://travis-ci.org/lesterchan/wp-postviews.svg?branch=master)](https://travis-ci.org/lesterchan/wp-postviews) = Development = [https://github.com/lesterchan/wp-postviews/](https://github.com/lesterchan/wp-postviews/ "https://github.com/lesterchan/wp-postviews/") = Translations = [http://dev.wp-plugins.org/browser/wp-postviews/i18n/](http://dev.wp-plugins.org/browser/wp-postviews/i18n/ "http://dev.wp-plugins.org/browser/wp-postviews/i18n/") = Credits = * Plugin icon by [Iconmoon](http://www.icomoon.io) from [Flaticon](http://www.flaticon.com) = Donations = I spent most of my free time creating, updating, maintaining and supporting these plugins, if you really love my plugins and could spare me a couple of bucks, I will really appericiate it. If not feel free to use it without any obligations. == Changelog == = Version 1.69 = * NEW: Shortcode `[views]` or [views id="POST_ID"]` to embed view count into post * NEW: Added template variable `%VIEW_COUNT_ROUNDED%` to support rounded view count like 10.1k or 11.2M = Version 1.68 = * NEW: Added action hook 'postviews_increment_views' and 'postviews_increment_views_ajax' * NEW: Allow custom post type to be chosen under the widget = Version 1.67 = * NEW: Allow user to not use AJAX to update the views even though WP_CACHE is true = Version 1.66 = * NEW: Supports MultiSite Network Activation * NEW: Add %POST_DATE% and %POST_TIME% to template variables * NEW: Add China isearch engines bots * NEW: Ability to pass in an array of post types for get_most/least_*() functions. Props Leo Plaw. * FIXED: Moved uninstall to uninstall.php and hence fix missing nonce. Props Julio Potier. * FIXED: Notices and better way to get views from meta. Props daankortenbach. * FIXED: No longer needing add_post_meta() if update_post_meta() fails. = Version 1.65 (02-06-2013) = * FIXED: Views not showing in WP-Admin if "Display Options" is not set to "Display to everyone" = Version 1.64 (31-05-2013) = * NEW: Using Enqueue Script For WP_CACHE Enabled Sites. Props Crowd Favourite * FIXED: Viewcounter always display eventhough "display to registered users only" is set = Version 1.63 (07-05-2013) = * NEW: Added nonce To PostViews Options Admin Page = Version 1.62 (29-11-2012) = * NEW: Add "Views" Column To Manage Pages In WP-Admin * NEW: Add Sortable "Views" Column To Manage Posts/Pages In WP-Admin = Version 1.61 (21-05-2012) = * FIXED: Move AJAX Request to wp-admin/admin-ajax.php = Version 1.60 (18-02-2011) = * NEW: Added Views Count To Edit Posts Screen * FIXED: Removed Global $post = Version 1.50 (15-06-2009) = * NEW: Works For WordPress 2.8 Only * NEW: Uses jQuery Framework * NEW: Added In Most Viewed Pages To WP-Stats * NEW: Use _n() Instead Of __ngettext() And _n_noop() Instead Of __ngettext_noop() * FIXED: Uses $_SERVER['PHP_SELF'] With plugin_basename(__FILE__) Instead Of Just $_SERVER['REQUEST_URI'] * NEW: Uses New Widget Class From WordPress * NEW: Merge Widget Code To wp-postviews.php And Remove wp-postviews-widget.php * NEW: Added get_most_viewed_tag() And get_least_viewed_tag() * FIXED: Ensure That Post Is Not A Revision * FIXED: Multiple Loops Filtered Not Cleared = Version 1.40 (12-12-2008) = * NEW: Works For WordPress 2.7 Only * NEW: Options To Display Views On Certain Places by David Potter * NEW: Right To Left Language Support by Kambiz R. Khojasteh * NEW: Output Of the_views() Applied To "the_views" Filter by Kambiz R. Khojasteh * NEW: Called postviews_textdomain() In views_init() by Kambiz R. Khojasteh * NEW: Uses plugins_url() And site_url() * NEW: Added get_least_viewed() And get_least_viewed_category() By JBrinx * FIXED: "views" Custom Field Gets Created Now When Post Is Published = Version 1.31 (16-07-2008) = * NEW: Works For WordPress 2.6 * NEW: Renamed GET Variables sortby To v_sortby And orderby To v_orderby * NEW: Better Translation Using __ngetext() by Anna Ozeritskaya * FIXED: Able To Use v_sortby And v_orderby in query_posts() = Version 1.30 (01-06-2008) = * NEW: Uses /wp-postviews/ Folder Instead Of /postviews/ * NEW: Uses wp-postviews.php Instead Of postviews.php * NEW: Uses wp-postviews-widget.php Instead Of postviews-widget.php * NEW: Uses number_format_i18n() Instead Of number_format() * NEW: Option To Exclude Bots Views In 'WP-Admin -> Settings -> Post Views' * NEW: Added Most Viewed Template * NEW: Change The Way WP-PostViews Count Views * NEW: Should Work With WP-Cache Or WP-SuperCache = Version 1.20 (01-10-2007) = * NEW: Works For WordPress 2.3 Only * NEW: Most Viewed Widget Added * NEW: Ability To Uninstall WP-PostViews * NEW: Uses WP-Stats Filter To Add Stats Into WP-Stats Page = Version 1.11 (01-06-2007) = * FIXED: Wrong URL For Page Under Most Viewed Posts Listing = Version 1.10 (01-02-2007) = * NEW: Works For WordPress 2.1 Only * NEW: Localization WP-PostViews * NEW: Added Function To Get Most Viewed Post By Category ID * FIXED: Views Not Counting In Some Cases = Version 1.02 (01-10-2006) = * NEW: Change In get_most_viewed() To Accommodate Latest Version Of WP-Stats = Version 1.01 (01-07-2006) = * NEW: Added Get Total Views Function * FIXED: Modified Get Most Viewed Post Function = Version 1.00 (01-03-2006) = * NEW: Initial Release == Installation == 1. Open `wp-content/plugins` Folder 2. Put: `Folder: wp-postviews` 3. Activate `WP-PostViews` Plugin 4. Go to `WP-Admin -> Settings -> PostViews` to configure the plugin. = Usage = 1. Open `wp-content/themes//index.php` 2. You may place it in archive.php, single.php, post.php or page.php also. 3. Find: `` 4. Add Anywhere Below It (The Place You Want The Views To Show): `` 5. Or you can use the shortcode `[views]` or `[views id="1"]` (where 1 is the post ID) in a post == Upgrading == 1. Deactivate `wp-postviews` Plugin 2. Open `wp-content/plugins` Folder 3. Put/Overwrite: `Folder: wp-postviews` 4. Activate `WP-PostViews` Plugin == Upgrade Notice == N/A == Screenshots == 1. PostViews 2. Admin - PostViews Options == Frequently Asked Questions == = How To View Stats With Widgets? = * Go to `WP-Admin -> Appearance -> Widgets` * The widget name is Views. = How To View Stats (Outside WP Loop) = = To Display Least Viewed Posts = * Use: * The first value you pass in is the post type that you want. If you want to get every post types, just use 'both'. It also supports PHP array: example `array('post', 'page')`. * The second value you pass in is the maximum number of post you want to get. * Default: get_least_viewed('both', 10); = To Display Most Viewed Posts = * Use: * The first value you pass in is the post type that you want. If you want to get every post types, just use 'both'. It also supports PHP array: example `array('post', 'page')`. * The second value you pass in is the maximum number of post you want to get. * Default: get_most_viewed('both', 10); = To Display Least Viewed Posts By Tag = * Use: * The first value you pass in is the tag id. * The second value you pass in is the post type that you want. If you want to get every post types, just use 'both'. It also supports PHP array: example `array('post', 'page')`. * The third value you pass in is the maximum number of post you want to get. * Default: get_least_viewed_tag(1, 'both', 10); = To Display Most Viewed Posts By Tag = * Use: * The first value you pass in is the tag id. * The second value you pass in is the post type that you want. If you want to get every post types, just use 'both'. It also supports PHP array: example `array('post', 'page')`. * The third value you pass in is the maximum number of post you want to get. * Default: get_most_viewed_tag(1, 'both', 10); = To Display Least Viewed Posts For A Category = * Use: * The first value you pass in is the category id. * The second value you pass in is the post type that you want. If you want to get every post types, just use 'both'. It also supports PHP array: example `array('post', 'page')`. * The third value you pass in is the maximum number of post you want to get. * Default: get_least_viewed_category(1, 'both', 10); = To Display Most Viewed Posts For A Category = * Use: * The first value you pass in is the category id. * The second value you pass in is the post type that you want. If you want to get every post types, just use 'both'. It also supports PHP array: example `array('post', 'page')`. * The third value you pass in is the maximum number of post you want to get. * Default: get_most_viewed_category(1, 'both', 10); = To Sort Most/Least Viewed Posts = * You can use: ` 'views', 'orderby' => 'meta_value_num', 'order' => 'DESC' ) ); ?>` * Or pass in the variables to the URL: `http://yoursite.com/?v_sortby=views&v_orderby=desc` * You can replace DESC with ASC if you want the least viewed posts.