WordPress.com Popular Posts integrates with Wordpress.com Stats plugin, providing a widget to show the most viewed posts.

Installation

• Install Wordpress.com Stats plugin (required at least v1.2!!!)
• Download Wordpress.com Popular Posts v1.3.4
• 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)

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.

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>" );?>

Changelog

• 1.3.4 - Hopefully fixed a problem on some blogs, when displaying only posts or only pages.
• 1.3.3 - Updated compatibility with WP 2.6
• 1.3.2 - New option: now you can limit the length of the links.
• 1.3.1 - Fixed an incompatibily with PHP < 5.0.
• 1.3 - Now the titles & permalinks are taken from the database, so they should updated.
  Arabic/Greek etc. language issues should be fixed now.

License

Wordpress.com Popular Posts is released under a GPL v3 license.

If you like this plugin, then buy me a coffee!