This plugin has been abandoned!
If you are a developer and would like to fork, feel free to do so (under the GPLv3 license). No need to contact me.
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
- 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, none, 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>" );?>
Shortcodes
If you want to include the list in a particular page or post, you can use shortcodes. Please read the FAQ for further info.
FAQ
Please read other updated FAQ here.
Changelog
You can read the whole changelog on the project page.
Download
Download latest version of WordPress.com Popular Posts 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 development. If you like this plugin, then buy me a coffee!
541 risposte su “WordPress.com Popular Posts”
@everybody: new version 2.1.0 is out! It provides a caching system, it should really speed up the loading process of the plugin. It is enabled by default, but you can disable in the preferences if you experience some issues.
A note for WPPP_show_popular_posts() users: if you want to enable the cache, please read the FAQ.
Another important thing: if you want to help this plugin, and speak a foreign language, you could translate it. Please read the FAQ.
Frasten, will the update will be included in good’old 1.35?
Just wanted to say thank you for the plug-in. Simply elegant. :o)
@Blutarsky: I’ve just ported the cache system to the new tag 1.3.6. Please test it (I didn’t), and if it is ok it will become the official stable release for WP < 2.8.
@Graham Chastney: thank you! 🙂
Tested, seems to work. There is the same delay on first load, after that it’s very fast.
How are performed the updates? I mean if data is cached locally, how often do you update the data in the cache?
@Blutarsky: Data is stored in the database, and is renewed every 10 minutes (600 seconds). It seems a quite reasonable amount of time to me.
Yes, of course.
Could it be possible to allow updates to the cache only from the dashboard? (admin panel) When the admin wants, it will issue the update…………
Hi,
I have WP Stats, 1.5
and I’m using WordPress version 2.8.4.
I have the Widget appearing on my blog site, but the posts are not populating.
Any thoughts?
Thank you,
I am having same issue as Mark. I have wordpress.com stats installed and have been running for a few days. I install wordpress.com popular posts and add the widget, but it doesnt add any posts. It just has 5 bullets points with nothing else. Suggestions?
Hello,
Thank you for a great plug-in. I have one question. I would like to show the top 10 popular posts, however I am only able to get up to 9 posts to display, even when I add higher numbers into the code. Is 9 the limit, or how do I add 10?
Thanks for your help. :o)
I’ve been away from blogging for a while and I game back to an excellent surprise. I love that you added the exclusion of deleted and private posts. Thank you! I’m looking forward to getting back to posting and give your plugin another run!
THANKS!
Hi there mate. I have tweaked to code in 1.3.6.
Line 59:
if ( isset( $widget_cache[‘time’] ) && is_user_logged_in() &&
$widget_cache[‘time’] > ( time() – $wppp_cache_expire ) ) {
Basically updates to the cache are done only when admin or registered blog users are logged in.
Search engine speed-friendly!!
@Blutarsky: Thank you, I’ll add your code to the plugin, and allow to enable/disable this behavior through an option.
@Mark, Riley, MDE Art Blog: please follow the FAQ to get a debug log and send it to me.
@Scott: thank you for your suggestions: the plugin is still growing thanks to the community’s contribute! 🙂
@Blutarsky: actually your code does a different thing:
if an user is logged, it try to serve a cached version of the list.
But if it is only a visitor (or bot), it disables the cache, and re-computes everything.
Is this the behavior you want? I don’t think so!
You are right, mate! (Y)
I was digging now into the code, scratching my head! Something wasn’t working as expected. :-/
What I wanted to achieve is to serve always the cached version, unless you are logged in (helps the blog being speedy for spiders).
…. where should I place the test?