Plugin Directory

WordPress Popular Posts

WordPress Popular Posts is a highly customizable widget that displays the most popular posts on your blog.

I need help with your plugin! What should I do?

First thing to do is read all the online documentation available (Installation, Usage, Wiki, and of course this section) as they should address most of the questions you might have about this plugin (and even more info can be found via wp-admin > Settings > WordPress Popular Posts > FAQ).

If you're having problems with WPP, my first suggestion would be try disabling all other plugins and then re-enable each one to make sure there are no conflicts. Also, try switching to a different theme and see if the issue persists. Checking the Support Forum and the issue tracker is also a good idea as chances are that someone else has already posted something about it. Remember: read first. It'll save you (and me) time.


Why WordPress Popular Posts?

The idea of creating this plugin came from the need to know how many people were actually reading each post. Unfortunately, WordPress doesn't keep views count of your posts anywhere. Because of that, and since I didn't find anything that would suit my needs, I ended up creating WordPress Popular Posts: a highly customizable, easy-to-use WordPress plugin with the ability to keep track of what's popular to showcase it to the visitors!

How does the plugin count views / calculate the popularity of posts?

Since WordPress doesn't store views count (only comments count), this plugin stores that info for you. When you sort your popular posts by views, WordPress Popular Posts will retrieve the views count it started caching from the time you first installed this plugin, and then rank the top posts according to the settings you have configured in the plugin. WordPress Popular Posts can also rank the popularity of your posts based on comments count as well.

I'm getting "Sorry. No data so far". What's up with that?

There are a number of reasons that might explain why you are seeing this message: no one has seen or commented on your posts/pages since WordPress Popular Posts activation, you should give it some time; your current theme does not have the wp_head() tag in its <head> section, required by my plugin to keep track of what your visitors are viewing on your site; WordPress Popular Posts was unable to create the necessary DB tables to work, make sure your hosting has granted you permission to create / update / modify tables in the database; if you're using a caching plugin -such as W3 Total Cache- you need to clear its cache once right after installing/upgrading this plugin.

My current theme does not support widgets (booooo!). Can I show my most popular posts in any other way?

Yes, there are other choices: you can use the wpp shortcode, which allows you to embed your popular listing directly in the content of your posts and/or pages; or you can use the wpp_get_mostpopular() template tag. Both options are highly customizable via parameters, check them out via wp-admin > Settings > WordPress Popular Posts > Parameters.

WordPress Popular Posts is not counting my own visits, why?

By default, WordPress Popular Posts won't count views generated by logged in users. If your blog requires readers to be logged in to access its contents (or just want WPP to count your own views) please go to wp-admin > Settings > WordPress Popular Posts > Tools and set Log views from to Everyone.

How can I use my own HTML markup with your plugin?

If you're using the widget, simply activate the Use custom HTML markup option and set your desired configuration and Content Tags (see wp-admin > Settings > WordPress Popular Posts > Parameters for more); or if you're using the template tag / shortcode, use the wpp_start, wpp_end and post_html parameters (see wp-admin > Settings > WordPress Popular Posts > Parameters for more).

A more advanced way to customize the HTML markup is via WordPress filters by hooking into wpp_custom_html or wpp_post. For details, please check the Filters page on the Wiki.

Where can I find the list of parameters accepted by the wpp_get_mostpopular() template tag / [wpp] shortcode?

You can find it via wp-admin > Settings > WordPress Popular Posts > Parameters.

I'm unable to activate the "Display post thumbnail" option. Why?

Please check that either the ImageMagick or GD extension is installed and enabled by your host.

How does WordPress Popular Posts pick my posts' thumbnails?

WordPress Popular Posts has three different thumbnail options to choose from available at wp-admin > Settings > WordPress Popular Posts > Tools: Featured Image (default), First image on post, or custom field. If no images are found, a default thumbnail will be displayed instead.

I'm seeing a "No thumbnail" image, where's my post thumbnail?

Make sure you have assigned one to your posts (see previous question).

Is there any way I can change that ugly "No thumbnail" image for one of my own?

Fortunately, yes. Go to wp-admin > Settings > WordPress Popular Posts > Tools and check under Thumbnail source. Ideally, the thumbnail you're going to use should be set already with your desired width and height - however, the uploader will give you other size options as configured by your current theme.

I want to have a popular list of my custom post type. How can I do that?

Simply add your custom post type to the Post Type field in the widget (or if you're using the template tag / shortcode, use the post_type parameter).

I would like to clear all data gathered by WordPress Popular Posts and start over. How can I do that?

If you go to wp-admin > Settings > WordPress Popular Posts > Tools, you'll find two buttons that should do what you need: Clear cache and Clear all data. The first one just wipes out what's in cache (Last 24 hours, Last 7 Days, Last 30 Days, etc.), keeping the historical data (All-time) intact. The latter wipes out everything from WordPress Popular Posts data tables - even the historical data. Note that this cannot be undone so proceed with caution.

Can WordPress Popular Posts run on WordPress Multisite?

Starting from version 3.0.0, WPP checks for WordPress Multisite. While I have not tested it, WPP should work just fine under WPMU (but if it doesn't, please let me know).


Does your plugin include any CSS stylesheets?

Yes, but there are no predefined styles (well, almost). WordPress Popular Posts will first look into your current theme's folder for the wpp.css file and use it if found so that any custom CSS styles made by you are not overwritten, otherwise will use the one bundled with the plugin.

Each time WordPress Popular Posts is updated the wpp.css stylesheet gets reset and I lose all changes I made to it. How can I keep my custom CSS?

Copy your modified wpp.css file to your theme's folder, otherwise my plugin will use the one bundled with it by default.

How can I style my list to look like [insert your desired look here]?

Since this plugin does not include any predefined designs, it's up to you to style your most popular posts list as you like (you might need to hire someone for this if you don't know HTML/CSS, though). However, I've gathered a few examples that should get you started.

I want to remove WPP's stylesheet. How can I do that?

You can disable the stylesheet via wp-admin > Settings > WordPress Popular Posts > Tools.


Does WordPress Popular Posts support other languages than english?

Yes, check the Other Notes section for more information.

I want to translate your plugin into my language / help you update a translation. What do I need to do?

First thing you need to do is get a gettext editor like Poedit to translate all texts into your language. You'll find several .PO files bundled with the plugin under the lang folder. If you're planning to add a new language, grab wordpress-popular-posts.po and rename it to add the proper suffix for your language (eg. wordpress-popular-posts-es_ES.po, for Spanish). In any case, open the PO file using Poedit (or your preferred gettext editor) and update the strings there. It sounds complicated, I know, but it's not.

Check this handy guide, in case you get lost at some point. If you're interested in sharing your translation with others (or just helped update a current translation), please let me know.

I want your plugin to have X or Y functionality. Can it be done?

If it fits the nature of my plugin and it sounds like something others would like to have, there's a pretty good chance that I will implement it (and if you can provide some sample code with useful comments, much better).

Your plugin seems to conflict with my current Theme / this other Plugin. Can you please help me?

If the theme/plugin you're talking about is a free one that can be downloaded from somewhere, sure I can try and take a look into it. Premium themes/plugins are out of discussion though, unless you're willing to grant me access to your site (or get me a copy of this theme/plugin) so I can check it out.

ETA for your next release?

Updates will come depending on my work projects (I'm a full-time web developer) and the amount of time I have on my hands. Quick releases will happen only when/if critical bugs are spotted.

I posted a question at the Support Forum and got no answer from the developer. Why is that?

Chances are that your question has been already answered either at the Support Forum, the Installation section, the Wiki or even here in the FAQ section, so I've decided not to answer. It could also happen that I'm just busy at the moment and haven't been able to read your post yet, so please be patient.

Is there any other way to contact you?

For the time being, the Support Forum is the only way to contact me. Please do not use my email to get in touch with me unless I authorize you to do so.

Requires: 3.8 or higher
Compatible up to: 4.2.2
Last Updated: 2015-4-27
Active Installs: 200,000+


4.5 out of 5 stars


33 of 43 support threads in the last two months have been resolved.

Got something to say? Need help?


Not enough data

2 people say it works.
0 people say it's broken.

89,9,8 33,3,1
100,4,4 0,2,0
0,1,0 42,12,5 100,3,3 60,5,3 0,2,0
80,10,8 93,14,13 100,1,1 0,3,0
100,5,5 44,9,4 40,5,2 100,2,2 85,13,11
67,6,4 0,1,0
50,4,2 0,1,0
100,1,1 100,1,1
87,15,13 60,5,3 34,29,10 25,4,1 75,4,3 100,1,1
0,3,0 100,5,5
100,1,1 71,17,12 50,2,1 100,1,1
50,2,1 100,1,1
100,1,1 86,7,6 14,37,5 43,7,3 100,1,1
100,1,1 50,2,1 61,33,20 100,1,1
33,6,2 100,1,1
100,1,1 64,11,7 100,1,1 100,1,1 43,7,3 100,1,1
20,5,1 33,3,1 50,2,1
50,2,1 67,6,4
67,3,2 100,1,1
43,7,3 100,1,1
100,1,1 100,1,1
80,5,4 100,1,1 100,1,1
100,2,2 100,4,4 100,3,3 100,3,3 100,5,5 100,2,2 100,1,1
67,3,2 100,1,1 100,1,1
100,1,1 100,1,1
75,4,3 25,4,1 100,4,4 100,2,2 100,1,1
100,2,2 100,1,1 100,3,3 100,1,1
100,4,4 100,2,2
100,6,6 100,1,1
100,1,1 100,1,1