=== WP-PostViews ===




Contributors: GamerZ




Donate link: http://lesterchan.net/site/donation/




Tags: views, hits, counter, postviews




Requires at least: 2.8




Tested up to: 3.0.4




Stable tag: trunk









Enables you to display how many times a post/page had been viewed.









== Description ==









= Previous Versions =




* [WP-PostViews 1.40 For WordPress 2.7.x](http://downloads.wordpress.org/plugin/wp-postviews.1.40.zip "WP-PostViews 1.40 For WordPress 2.7.x")




* [WP-PostViews 1.31 For WordPress 2.3.x, 2.5.x And 2.6.x](http://downloads.wordpress.org/plugin/wp-postviews.1.31.zip "WP-PostViews 1.31 For WordPress 2.3.x, 2.5.x And 2.6.x")




* [WP-PostViews 1.11 For WordPress 2.1.x And 2.2.x](http://downloads.wordpress.org/plugin/wp-postviews.1.11.zip "WP-PostViews 1.11 For WordPress 2.1.x And 2.2.x")




* [WP-PostViews 1.02 For WordPress 2.0.x](http://downloads.wordpress.org/plugin/wp-postviews.1.02.zip "WP-PostViews 1.02 For WordPress 2.0.x")









= Development =




* [http://dev.wp-plugins.org/browser/wp-postviews/](http://dev.wp-plugins.org/browser/wp-postviews/ "http://dev.wp-plugins.org/browser/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/")









= Support Forums =




* [http://forums.lesterchan.net/index.php?board=16.0](http://forums.lesterchan.net/index.php?board=16.0 "http://forums.lesterchan.net/index.php?board=16.0")









= Credits =




* WP-Cache/WP-SuperCache Compatibility By [Thaya Kareeson](http://omninoggin.com/ "Thaya Kareeson")




* __ngetext() by [Anna Ozeritskaya](http://hweia.ru/ "Anna Ozeritskaya")




* Right To Left Language Support by [Kambiz R. Khojasteh](http://persian-programming.com/ "Kambiz R. Khojasteh")




* Options To Display Views On Certain Places by [David Potter](http://dpotter.net/Technical/ "David Potter")









= 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.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/<YOUR THEME NAME>/index.php`




2. You may place it in archive.php, single.php, post.php or page.php also.




3. Find: `<?php while (have_posts()) : the_post(); ?>`




4. Add Anywhere Below It (The Place You Want The Views To Show): `<?php if(function_exists('the_views')) { the_views(); } ?>`









== 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









== 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:




<code>




<?php if (function_exists('get_least_viewed')): ?>




	<ul>




		<?php get_least_viewed(); ?>




	</ul>




<?php endif; ?>




</code>




* The first value you pass in is what you want to get, 'post', 'page' or 'both'.




* 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:




<code>




<?php if (function_exists('get_most_viewed')): ?>




	<ul>




		<?php get_most_viewed(); ?>




	</ul>




<?php endif; ?>




</code>




* The first value you pass in is what you want to get, 'post', 'page' or 'both'.




* 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:




<code>




<?php if (function_exists('get_least_viewed_tag')): ?>




	<ul>




		<?php get_least_viewed_tag(); ?>




	</ul>




<?php endif; ?>




</code>




* The first value you pass in is the tag id.




* The second value you pass in is what you want to get, 'post', 'page' or 'both'.




* 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:




<code>




<?php if (function_exists('get_most_viewed_tag')): ?>




	<ul>




		<?php get_most_viewed_tag(); ?>




	</ul>




<?php endif; ?>




</code>




* The first value you pass in is the tag id.




* The second value you pass in is what you want to get, 'post', 'page' or 'both'.




* 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:




<code>




<?php if (function_exists('get_least_viewed_category')): ?>




	<ul>




		<?php get_least_viewed_category(); ?>




	</ul>




<?php endif; ?>




</code>					




* The first value you pass in is the category id.




* The second value you pass in is what you want to get, 'post', 'page' or 'both'.




* 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:




<code>




<?php if (function_exists('get_most_viewed_category')): ?>




	<ul>




		<?php get_most_viewed_category(); ?>




	</ul>




<?php endif; ?>




</code>			




* The first value you pass in is the category id.




* The second value you pass in is what you want to get, 'post', 'page' or 'both'.




* 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: `<?php query_posts('v_sortby=views&amp;v_orderby=desc') ?>`




* Or pass in the variables to the URL: `http://yoursite.com/?v_sortby=views&amp;v_orderby=desc`




* You can replace desc with asc if you want the least viewed posts.