Hector Cabrera

WP Popular Posts is a highly customizable plugin that displays your most popular posts.
<h4>PSA: Plugin has been renamed as WP Popular Posts!</h4>
See the <a href="https://cabrerahector.com/wordpress/wordpress-popular-posts-renamed-to-wp-popular-posts/" rel="nofollow ugc">announcement</a> for more details.
<h4>Main Features</h4>
<ul>
<li>Multiple Popular Posts Lists – You can have several Popular Posts lists on your blog, each with its own settings!</li>
<li>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)!</li>
<li>Custom Post-type support – Want to show other stuff than just posts and pages, eg. Popular Products? <a href="https://github.com/cabrerahector/wordpress-popular-posts/wiki/5.-FAQ#i-want-to-have-a-popular-list-of-my-custom-post-type-how-can-i-do-that" rel="nofollow ugc">You can</a>!</li>
<li>Thumbnails! – Display a thumbnail of your posts! (see the <a href="https://github.com/cabrerahector/wordpress-popular-posts/wiki/5.-FAQ#how-does-wordpress-popular-posts-pick-my-posts-thumbnails" rel="nofollow ugc">FAQ section</a> for more details.)</li>
<li>Statistics dashboard – See how your popular posts are doing directly from your admin area.</li>
<li>Sorting options – Order your popular list by comments, views (default) or average views per day!</li>
<li>Custom themes – Out of the box, WP Popular Posts includes some themes so you can style your popular posts list (see <a href="https://github.com/cabrerahector/wordpress-popular-posts/wiki/6.-Styling-the-list#themes" rel="nofollow ugc">Widget Themes</a> for more details).</li>
<li>Use your own layout! – WPP is flexible enough to let you customize the look and feel of your popular posts! (see <a href="https://github.com/cabrerahector/wordpress-popular-posts/wiki/5.-FAQ#how-can-i-use-my-own-html-markup-with-your-plugin" rel="nofollow ugc">customizing WPP’s HTML markup</a> and <a href="https://github.com/cabrerahector/wordpress-popular-posts/wiki/6.-Styling-the-list" rel="nofollow ugc">How to style WP Popular Posts</a> for more.)</li>
<li>Performance Tools! – WP Popular Posts includes a few options to make sure your site’s performance stays as good as ever! (see <a href="https://github.com/cabrerahector/wordpress-popular-posts/wiki/7.-Performance" rel="nofollow ugc">Performance</a> for more details.)</li>
<li>REST API support – Embed your popular posts in your (web) app! (see <a href="https://github.com/cabrerahector/wordpress-popular-posts/wiki/8.-REST-API-Endpoints" rel="nofollow ugc">REST API Endpoints</a> for more.)</li>
<li>Elementor support – Are you building sites with Elementor? There’s a popular posts widget for it too!</li>
<li>Disqus support – Sort your popular posts by Disqus comments count!</li>
<li>Polylang & WPML 3.2+ support – Show the translated version of your popular posts!</li>
<li>WordPress Multisite support – Each site on the network can have its own popular posts list!</li>
</ul>
<h4>Other Features</h4>
<ul>
<li>Shortcode support – Use the [wpp] shortcode to showcase your most popular posts on pages, too! For usage and instructions, please refer to the <a href="https://wordpress.org/plugins/wordpress-popular-posts/#installation" rel="ugc">Installation section</a>.</li>
<li>Template tags – Don’t feel like using blocks? No problem! You can still embed your most popular entries on your theme using the <code>wpp_get_mostpopular()</code> template tag. Additionally, the <code>wpp_get_views()</code> template tag allows you to retrieve the views count for a particular post. For usage and instructions, please refer to the <a href="https://wordpress.org/plugins/wordpress-popular-posts/#installation" rel="ugc">Installation section</a>.</li>
<li>Localization – <a href="https://github.com/cabrerahector/wordpress-popular-posts/wiki/5.-FAQ#i-want-to-translate-your-plugin-into-my-language--help-you-update-a-translation-what-do-i-need-to-do" rel="nofollow ugc">Translate WPP into your own language</a>.</li>
<li><a href="https://wordpress.org/plugins/wp-postratings/" rel="ugc">WP-PostRatings</a> support – Show your visitors how your readers are rating your posts!</li>
</ul>
<h4>PSA: The classic WP Popular Posts widget has reached End-of-Life</h4>
The classic WP Popular Posts widget doesn’t work very well / at all with the <a href="https://wordpress.org/documentation/article/block-based-widgets-editor/" rel="ugc">block-based Widgets editor</a> introduced with WordPress 5.8.
This new Widgets editor expects <a href="https://wordpress.org/documentation/article/blocks-list/" rel="ugc">WordPress blocks</a> instead of regular WordPress widgets. If you’re using the classic WP Popular Posts widget please replace it with the <a href="https://cabrerahector.com/wordpress/wordpress-popular-posts-5-3-improved-php-8-support-retina-display-support-and-more/#block-editor-support" rel="nofollow ugc">WP Popular Posts block</a> instead – it has the same features and functionality as the “classic” widget so you won’t be missing anything at all. See the <a href="https://cabrerahector.com/wordpress/migrating-from-the-classic-popular-posts-widget/" rel="nofollow ugc">Migration Guide</a> for more details.
Bjorn from wplearninglab.com was kind enough to create a video explaining how to use the new block for all of you visual learners:
<iframe loading="lazy" class="youtube-player" width="750" height="422" src="https://www.youtube.com/embed/mtzk6yNEaFs?version=3&rel=1&showsearch=0&showinfo=1&iv_load_policy=1&fs=1&hl=en-US&autohide=2&wmode=transparent" allowfullscreen="true" style="border:0;" sandbox="allow-scripts allow-same-origin allow-popups allow-presentation allow-popups-to-escape-sandbox"></iframe>
If you cannot (or do not want to) use WordPress blocks on your website then please replace your classic widget with the <a href="https://github.com/cabrerahector/wordpress-popular-posts/wiki/1.-Using-WPP-on-posts-&-pages#the-wpp-shortcode" rel="nofollow ugc">[wpp] shortcode</a>.
<h4>Support the Project!</h4>
If you’d like to support my work and efforts to creating and maintaining more open source projects your donations and messages of support mean a lot!
<a href="https://ko-fi.com/cabrerahector" rel="nofollow ugc">Buy me a coffee</a> | <a href="https://www.paypal.com/paypalme/cabrerahector" rel="nofollow ugc">PayPal</a>
WP Popular Posts is now also on <a href="https://github.com/cabrerahector/wordpress-popular-posts" rel="nofollow ugc">GitHub</a>!
Looking for a Recent Posts widget just as featured-packed as WP Popular Posts? Try <a href="https://wordpress.org/plugins/recently/" rel="ugc">Recently</a>!
<h3>Credits</h3>
<ul>
<li>Flame graphic by freevector/Vecteezy.com.</li>
</ul>

WP Popular Posts

Great Plugin!

This plugin delivers as it says. It's both easy to use, and easy to extend on the backend if that suits you as well.

Works Perfectly


Great plugin that does what I need and have a great support from Hector even it's a free plugin.



Keep it up and make a PRO version :)


Great plugin, great support

A highly customizable, easy-to-use popular posts plugin!

Bill Erickson

This is a helper plugin to allow you to build WordPress queries using WordPress.com stats.
This plugin uses the WordPress.com stats (packaged in Jetpack) to find out your most popular posts. You must be running Jetpack for this plugin to work. I recommend running Jetpack for at least 30 days to get useful data.
It asks for the 100 most popular posts over the past 30 days. This includes both posts and pages, since their stats don’t let you filter based on post type. I filter this list down to just posts and then store its ranking as post meta (‘be_stats’).
You can <a href="https://gist.github.com/billerickson/4997202" rel="nofollow ugc">write custom queries</a> to list popular posts, or use the <a href="https://wordpress.org/extend/plugins/display-posts-shortcode/" rel="ugc">Display Posts Shortcode plugin</a> to do it for you. Examples using the shortcode plugin:
[display-posts orderby=”popular”] – Lists the 10 most popular posts 
[display-posts orderby=”popular” posts_per_page=”4″] – Lists the 4 most popular posts 
[display-posts orderby=”popular” posts_per_page=”4″ tag=”basic”] – Lists the 4 most popular posts tagged “basic”
<h3>For Developers</h3>
There are a few filters available to you for customization. Refer to the plugin’s code for more information.
be_stats_args – arguments passed to WordPress.com Stats API. 
Default: array( ‘days’ => 30, ‘limit’ => 100 ) 
Example: http://www.billerickson.net/code/customize-be-stats-arguments/
be_stats_update – Conditional for determining if stats data should be saved 
Default: ‘post’ == get_post_type() 
Example: http://www.billerickson.net/code/be-stats-change-ranking-conditions/

BE Stats

Keeps track of your most popular posts for display in site

WP Popular Posts vs BE Stats