Categorie Popular Posts

IMPORTANT: due to my job, I’m now too busy to maintain my plugins.

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. Popular Posts integrates with Stats plugin, providing a widget to show the most viewed posts.


  • 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 Stats plugin (required at least v1.2!!!)
  • Download 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

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

If you want to include the list in a particular page or post, you can use shortcodes. Please read the FAQ for further info.


Please read other updated FAQ here.


You can read the whole changelog on the project page.


Download latest version of Popular Posts
for WordPress 2.8+

or v1.3.5 for WordPress < 2.8

License 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 “ Popular Posts”

I have changed the magic number to 2, 3, and then numbers in the thousands and 100,000’s… I still get only 3 popular posts listed. Can you help?

I love this plugin but the title looks awful in my theme. The developers at Spyr Media wrote this to me:

Unfortunately this is a result of those particular plugin authors not applying the widget_title filter to their widgets. This causes those widget titles to be missing an additional wrap that we add to allow for further styling of those headings. That’s the reason why all of the built-in WordPress widgets work…they obviously properly apply the widget_title filter 🙂

Can you do something about it?

Hello guys, can some help me i wana show image from the post custom field and i just can get i to work 🙁
The funtion i need to display i think is this
ID, “Thumbnail”, true);?>

Good morning Frasten.

First, let me thank you for making this awesome plugin. It’s been a pleasure and a joy to discover it’s many features and play with new ones you add.

I have a question regarding the available custom values. At the moment you can ‘exclude’ a post/page based on their ID. Do you think that the inverse is also possible? I would like to show the total views for a single post.

To my best knowledge that would look something like WPPP_show_popular_posts(‘include=get_the_ID’ )

As you can see I am not an expert in this area. Would it be possible for you to get back to me on this? Many thanks.

This plugin doesn’t appear to be working for me and I’m wondering if it’s because the Stats plugin has been replaced by the Jetpack stats?

very very great plugin ! most popular posts! it is accordingly with my taste…very customizable, i like that i can change the size of icons ! Great job man..i came here only to thank you !