WordPress.com Popular Posts integrates with Wordpress.com Stats plugin, providing a widget to show the most viewed posts.
Installation
- From v2.0.0, WordPress 2.8 is required. If you are using an older version of WordPress, use v1.3.5 of this plugin.
- Install Wordpress.com Stats plugin (required at least v1.2!!!)
- Download Wordpress.com Popular Posts v2.2.0
- Extract the files in the .zip archive, and upload them (including subfolders) to your
/wp-content/plugins/directory - Activate the plugin through the ‘Plugins’ menu in WordPress
- Place the widget where you like in your sidebars
- Enjoy!
Themes Integration
If your theme supports widgets, you can place the widget named ‘Popular Posts’ where you want.
If it doesn’t, put this code inside the file sidebar.php, in your theme files:
<?php if (function_exists('WPPP_show_popular_posts')) WPPP_show_popular_posts(); ?>
Optionally you can add some parameters to the function, in this format:
name=value&name=value etc.
Possible names are:
- title (title of the widget, you can add tags (e.g. <h3>Popular Posts</h3>) default: Popular Posts)
- number (number of links shown, default: 5)
- days (length of the time frame of the stats, default 0, i.e. infinite)
- show (what you want to show; it can be: both, posts, pages; default is both)
- format (the format of the links shown, default:
<a href='%post_permalink%' title='%post_title%'>%post_title%</a>) - excerpt_length (the length of the excerpt, if %post_excerpt% is used in the format)
- title_length (the length of the title links, default 0, i.e. unlimited)
- exclude (the list of post/page IDs to exclude, separated by commas. Read the FAQ for instructions)
- cutoff (don’t show posts/pages with a view count under this number, default 0, i.e. unlimited)
- list_tag (can be: ul, ol, default ul)
- category (the ID of the category, see the FAQ for info. Default 0, i.e. all categories)
- cachename (it is used to enable the cache. Please read the FAQ).
You can use these special markers in the format value:
%post_permalink%the link to the post%post_title%the title the post%post_title_attribute%the title of the post; use this in attributes, e.g.<a title='%post_title_attribute%'...%post_views%number of views%post_excerpt%the first n characters of the content. Set n in the widget options.%post_category%the category of the post
Example
If you want to show the widget without any title, the 3 most viewed articles, in the last week, and in this format: My Article (123 views) you will use this:
<?php WPPP_show_popular_posts( "title=&number=3&days=7&format=<a href='%post_permalink%' title='%post_title_attribute%'>%post_title% (%post_views% views)</a>" );?>
FAQ
Please read other updated FAQ here.
Changelog
-
2.2.0
- New Feature: added the new %post_comments% tag in the format to show
how many comments a post has.
New Feature: now you can choose to show the cached version only to the anonymous (not logged in) users.
Some minor fixes. -
2.1.0
- New Feature: implemented a cache system. This will improve the speed
of the plugin. If you are using the function WPPP_show_popular_posts()
for non-widget-ready themes, please read the FAQ.
Fixed an issue with %post_category%. Thanks to Isaac | GoBlogger.
Better compatibility with plugins like qTranslate. Thanks to Blutarsky for this. -
2.0.2
- Regression: you couldn't set an empty title anymore
Regression: You couldn't add HTML tags to the widget title
Fix: more robust security checks -
2.0.1
- New feature: now you can use %post_category% in your format, to show the post's category.
New feature: now you can show posts from a specific category
-
2.0.0
- New complete rewrite, using WP 2.8 Widget API. Note: from now on, this plugin will require at least WP 2.8
New feature: now you can add multiple widgets with their own different settings!
New feature: now you can exclude specific posts/pages by IDs.
New feature: don't show posts with a view count under x
New feature: now you can choose between unordered (<ul>) or ordered (<ol>) list.
Fix: now private posts are excluded from the list.
Fix: now deleted posts shouldn't appear anymore.
Fix: W3C Validation fix, thanks to Jonathan M. Hollin
Fix: fixed an issue with titles containing special characters/quotes.
Fix: removed the shortcodes from the excerpt, thanks to Peter.
Download
Download Wordpress.com Popular Posts v2.2.0 for WordPress 2.8+
or v1.3.5 for Wordpress < 2.8
License
Wordpress.com Popular Posts is released under a GPL v3 license.
This plugin required many hours of developing. If you like this plugin, then buy me a coffee!
@Coco: about your issue with OL in IE7/8: I’ve just tested it with IE7, and it shows the list correctly: 1,2,3,4,5… I think there could be something wrong with your CSS…
@Blutarsky: I see what you mean. But it doesn’t make sense for me: the cache was introduced only to speed up the plugin, not to lock the list.
@KJ: can you please mail me a debug log (instructions in the FAQ)?
@mdstudio: 1) I’ll look into that.
2) please mail me a debug log, as stated above.
@Cody: I think it could be related to the subcategories issue. Is your category 59 a subcategory of something else?
However, it was already fixed in the development version, just wait for a new release
@godaddy coupon codes: It’s a CSS thing. Take a look here.
Frasten,
BTW, is there any easy way to eliminate “Home” from the list?
I think I solved the issue of popular post links not showing up. I believe it was a communication problem with Wordpress stats. I re-entered the API and account info and it seems to be working fine now.
Thanks in advance for looking into finding a way to make html tags work in the link titles!!!
@mdstudio: I’m glad you fixed it.
To eliminate “Home”, you can choose to show only posts, or exclude its ID (read the FAQ to discover that ID).
Well, popular posts stats don’t change so often to justify continuous querying to the Internet service.
There could be an option for example to force the plugin to serve always the cached version, regardless the timeouts, and at the same time allow the plugin running from command line allowing cache update from batch jobs using the cron/curl pair.
I don’t know but I like this plugin couse it help me to know my popular articles
My theme supports widgets, and as a widget Popular Posts works perfectly.
However, I would like to exclude a certain post from the results. Is this possible to do while using widgets? Putting “” in my sidebar.php only seems to allow me to put Popular Posts at the top or absolute bottom of my other widgets, which is not where I would like it to be…
Please excuse me – I discovered what was wrong. Everything works now!
I tried to follow the directions to discover the number that identifies a post. Hovering over the title in the Post list in admin only gets “edit title of post” There is no number.
The list of posts numbers the posts 1-XXX, with the latest addition being 1, so it changes each time you add a post, so that does not work.
Is it because I have changed the url format of my posts so they do not use the WP format–but instead just use the title I assign?
I really would like to eliminate some of my posts (like contests) from the count and would like to know how.
Otherwise this is a great tool.
Hope you can help with my problem. 
(I use widgets, by the way)
Grazie.
Hi mate,
Great plugin u made, very handy. Thank you
I have some problems tho using it without the widget. Sometimes it displays the content of category sometimes it just shows it empty, even if in blogs stats shows that the category has several items.
So basically some categories post are not displayed not even one, and some display only 3 or 4 from 5 posts requested. What can i do?
Thanks
Something changed with the latest version of stats… Now stats_get_csv throws an error…
Permanent cache option (no time limit) would be great also for bad stats.com behavior!!
Hi,
I love your plugin.
I recall though that there used to be an option so that the number of post views for the popular posts is only displayed to the administrator. But that option seems to have disappeared.
Did you remove that option or did I just imagine it?
Thanks,
Frank
Love your plugin.
[...] Version 2.2.0 | By Frasten | Visit plugin site [...]
[...] Navigasi antar halaman yang baik memudahkan pembaca untuk menelusuri setiap artikel dan meningkatkan page views blog kita. Sistem navigasi antar halaman biasanya dengan menampilkan daftar komentar terbaru, artikel terpopuler, dan artikel terkait. Kita bisa menggunakan plugin Get Recent Comments, WordPress Related Posts, dan WordPress.com Popular Posts. [...]
[...] WordPress.com Popular Posts [...]