A highly customizable plugin that displays your most popular posts.
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.
- Multiple Popular Posts Lists - You can have several Popular Posts lists 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)!
- Custom Post-type support - Want to show other stuff than just posts and pages, eg. Popular Products? You can!
- Thumbnails! - Display a thumbnail of your posts! (see the FAQ section for more details.)
- Statistics dashboard - See how your popular posts are doing directly from your admin area.
- Sorting options - Order your popular list by comments, views (default) or average views per day!
- Custom themes - Out of the box, WordPress Popular Posts includes some themes so you can style your popular posts list (see Widget Themes for more details).
- Use your own layout! - WPP is flexible enough to let you customize the look and feel of your popular posts! (see customizing WPP's HTML markup and How to style WordPress Popular Posts for more.)
- Advanced caching features! - WordPress Popular Posts includes a few options to make sure your site's performance stays as good as ever! (see Performance for more details.)
- REST API Support - Embed your popular posts in your (web) app! (see REST API Endpoints for more.)
- Disqus support - Sort your popular posts by Disqus comments count!
- Polylang & WPML 3.2+ support - Show the translated version of your popular posts!
- WordPress Multisite support - Each site on the network can have its own popular posts list!
- Shortcode support - Use the [wpp] shortcode to showcase your most popular posts on pages, too! For usage and instructions, please refer to the Usage section.
- Template tags - Don't feel like using blocks? No problem! You can still embed your most popular entries on your theme using the
wpp_get_mostpopular()template tag. Additionally, thewpp_get_views()template tag allows you to retrieve the views count for a particular post. For usage and instructions, please refer to the Usage section. - Localization - Translate WPP into your own language.
- WP-PostRatings support - Show your visitors how your readers are rating your posts!
Looking for a Recent Posts widget just as featured-packed as WordPress Popular Posts? Try Recently!
- WordPress 5.7 or newer.
- PHP 7.2 or newer.
- Mbstring PHP Extension.
- Since WordPress Popular Posts writes constantly to the database to keep track of page views, InnoDB support is required.
- Log in into your WordPress dashboard.
- Go to Plugins > Add New.
- In the "Search Plugins" field, type in WordPress Popular Posts and hit Enter.
- Find the plugin in the search results list and click on the "Install Now" button.
- Download the plugin and extract its contents.
- Upload the
wordpress-popular-postsfolder to the/wp-content/plugins/directory. - Activate the WordPress Popular Posts plugin through the "Plugins" menu in WordPress.
- Please see the Usage section below to learn how to add a popular post list to your site. Once you're done, keep reading.
- If you have a caching plugin installed on your site, flush its cache now so WPP can start tracking your site.
- If you have a plugin that minifies JavaScript (JS) installed on your site please read this FAQ: Is WordPress Popular Posts compatible with plugins that minify/bundle JavaScript code?
- If you have a security / firewall plugin installed on your site, make sure you allow WPP access to the REST API so it can start tracking your site.
- Go to Appearance > Editor > Theme File Editor. Under "Theme Files", click on "Theme Header" (
header.php) and make sure that the<?php wp_head(); ?>tag is present (it should be somewhere before the closing</head>tag). - (Optional but highly recommended) Are you running a medium/high traffic site? If so, it might be a good idea to check these suggestions to make sure your site's performance stays up to par.
That's it!
WordPress Popular Posts can be used in three different ways:
- If you're using the Block Editor you can insert a WordPress Popular Posts block on your sidebar (eg. via Appearance > Widgets) and even anywhere within your posts and pages.
- As a template tag: you can place it anywhere on your theme with
wpp_get_mostpopular(). - Via shortcode, so you can embed it inside a post or a page.
... and there's even more on the Wiki section, so make sure to stop by!
Before submitting an issue, please:
- Read the documentation, it's there for a reason. Links: Requirements | Installation | Wiki | Frequently asked questions.
- If it's a bug, please check the issue tracker first make sure no one has reported it already.
When submitting an issue, please make sure to include the following:
- WordPress version.
- WPP version.
- Are you using the block or the shortcode/template tag?
- Describe what the issue is (include steps to reproduce it, if necessary).
- 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! Buy me a coffee | PayPal
- If you have any ideas/suggestions/bug reports, and if there's not an issue filed for it already (see issue tracker), please create an issue so I can keep track of it.
- Developers can send pull requests to suggest fixes / improvements to the source. See Contributing for more details.
- Want to translate WPP into your language or update a current translation? Check if it's already supported or download this POT file to translate the strings (see I want to translate your plugin into my language / help you update a translation. What do I need to do? for more).
GNU General Public License version 2 or later
Copyright (C) 2008-2024 Héctor Cabrera - https://cabrerahector.com
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 http://www.gnu.org/licenses.
