PHP JavaScript CSS

WordPress Popular Posts

A highly customizable WordPress widget to display the most popular posts on your blog.

Table of contents


WordPress Popular Posts (from now on, just WPP) is a highly customizable plugin to showcase the most commented / viewed entries on your WordPress powered site.


  • Multi-widget capable. That is, you can have several widgets of WordPress Popular Posts on your blog - each with its own settings!
  • Time Range - list those posts of your blog that have been the most popular ones within a specific time range (eg. last 24 hours, last 7 days, last 30 days, etc.)!
  • WPML support.
  • WordPress Multiuser support.
  • Custom Post-type support. Wanna show other stuff than just posts and pages?
  • Display a thumbnail of your popular posts! (see technical requirements).
  • Use your own layout! Control how your most popular posts are shown on your theme.
  • Check the statistics on your most popular posts from wp-admin.
  • Order your popular list by comments, views (default) or average views per day!
  • Shortcode support - use the [wpp] shortcode to showcase your most popular posts on pages, too! (see "Using WPP on posts & pages").
  • Template tags - Don't feel like using widgets? No problem! You can still embed your most popular entries on your theme using the wpp_get_mostpopular() template tag. Additionally, the wpp_gets_views() template tag allows you to retrieve the views count for a particular post. For usage and instructions, please refer to the Template tags page.
  • Localizable to your own language (See here for more info).
  • WP-PostRatings support. Show your visitors how your readers are rating your posts!


  • WordPress 3.8 or above.
  • PHP 5.2+ or above.
  • Since WordPress Popular Posts writes constantly to the database to keep track of page views, InnoDB support is required.
  • Either the ImageMagik or GD library installed and enabled on your server (not really required, but needed to create thumbnails).


  1. Download the plugin and extract its contents.
  2. Upload the wordpress-popular-posts folder to the /wp-content/plugins/ directory.
  3. Activate WordPress Popular Posts plugin through the 'Plugins' menu in WordPress.
  4. In your admin console, go to Appeareance > Widgets, drag the WordPress Popular Posts widget to wherever you want it to be and click on Save.
  5. If you have a caching plugin installed on your site, flush its cache now so WPP can start tracking your site.
  6. (optional) Go to Appeareance > Editor. On "Theme Files", click on header.php and make sure that the <?php wp_head(); ?> tag is present (should be right before the closing </head> tag).
  7. (optional, but recommended for large / high traffic sites) Enabling Data Sampling and/or Caching is recommended. Check here for more.


WPP can be used as a WordPress Widget, which means you can place it on any of your theme's sidebars (and it even supports multiple instances!). However, you can also embed it directly in posts / pages via shortcode; or anywhere on your theme using the wpp_get_mostpopular() template tag.

... and there's even more on the Wiki section, so make sure to stop by!


Before submitting an issue, please:

  1. Read the documentation, it's there for a reason. Links: Requirements | Installation | Wiki | Frequently asked questions.
  2. If it's a bug, please check the issue tracker first make sure no one has reported it already.

When submitting an issue, please answer the following questions:

  1. WordPress version?
  2. WPP version?
  3. Are you using the widget or the shortcode/template tag?
  4. Describe what the issue is (include steps to reproduce it, if necessary).



GNU General Public License version 2 or later

Copyright (C) 2008-2015 Héctor Cabrera -

The WordPress Popular Posts plugin is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

The WordPress Popular Posts plugin is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with the WordPress Popular Posts plugin; if not, see