cabrerahector/wordpress-popular-posts
Stars: 271
Forks: 81
Pull Requests: 61
Issues: 309
Watchers: 13
Last Updated: 2023-09-12 18:42:48
WordPress Popular Posts - A highly customizable WordPress widget that displays your most popular posts.
License: GNU General Public License v2.0
Languages: PHP, JavaScript, CSS
https://wordpress.org/plugins/wordpress-popular-posts/
A highly customizable widget that displays your most popular posts.
WordPress Popular Posts (from now on, just WPP) is a highly customizable widget to showcase the most commented / viewed entries on your WordPress powered site.
- Multi-widget capable - You can have several WordPress Popular Posts widgets 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 widgets? No problem! You can still embed your most popular entries on your theme using the
wpp_get_mostpopular()
template tag. Additionally, the wpp_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.3 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-posts
folder to the /wp-content/plugins/
directory.
- Activate the WordPress Popular Posts plugin through the "Plugins" menu in WordPress.
- Go to Appearance > Widgets, drag and drop the WordPress Popular Posts widget to your sidebar. Once you're done configuring it, hit the Save button.
- 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. Under "Templates", click on
header.php
and make sure that the <?php wp_head(); ?>
tag is present (should be right 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!
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 by using the WordPress Popular Posts block or 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:
- 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 widget or the shortcode/template tag?
- Describe what the issue is (include steps to reproduce it, if necessary).
GNU General Public License version 2 or later
Copyright (C) 2008-2023 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.