wordpress-popular-posts
Last commit date
assets
5 days ago
i18n
5 days ago
src
5 days ago
vendor
3 years ago
LICENSE
5 years ago
index.php
5 years ago
readme.txt
5 days ago
uninstall.php
10 months ago
wordpress-popular-posts.php
5 days ago
readme.txt
144 lines
| 1 | === WP Popular Posts === |
| 2 | Contributors: hcabrera |
| 3 | Donate link: https://ko-fi.com/cabrerahector |
| 4 | Tags: popular, posts, popularity, top, trending |
| 5 | Requires at least: 6.2 |
| 6 | Tested up to: 7.1 |
| 7 | Requires PHP: 7.4 |
| 8 | Stable tag: 7.4.1 |
| 9 | License: GPLv2 or later |
| 10 | License URI: http://www.gnu.org/licenses/gpl-2.0.html |
| 11 | |
| 12 | A highly customizable, easy-to-use popular posts plugin! |
| 13 | |
| 14 | == Description == |
| 15 | |
| 16 | WP Popular Posts is a highly customizable plugin that displays your most popular posts. |
| 17 | |
| 18 | = PSA: Plugin has been renamed as WP Popular Posts! = |
| 19 | |
| 20 | See the [announcement](https://cabrerahector.com/wordpress/wordpress-popular-posts-renamed-to-wp-popular-posts/) for more details. |
| 21 | |
| 22 | = Main Features = |
| 23 | * **Multiple Popular Posts Lists** - You can have several Popular Posts lists on your blog, each with its own settings! |
| 24 | * **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)! |
| 25 | * **Custom Post-type support** - Want to show other stuff than just posts and pages, eg. Popular *Products*? [You can](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)! |
| 26 | * **Thumbnails!** - Display a thumbnail of your posts! (*see the [FAQ section](https://github.com/cabrerahector/wordpress-popular-posts/wiki/5.-FAQ#how-does-wordpress-popular-posts-pick-my-posts-thumbnails) for more details*.) |
| 27 | * **Statistics dashboard** - See how your popular posts are doing directly from your admin area. |
| 28 | * **Sorting options** - Order your popular list by comments, views (default) or average views per day! |
| 29 | * **Custom themes** - Out of the box, WP Popular Posts includes some themes so you can style your popular posts list (see [Widget Themes](https://github.com/cabrerahector/wordpress-popular-posts/wiki/6.-Styling-the-list#themes) for more details). |
| 30 | * **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](https://github.com/cabrerahector/wordpress-popular-posts/wiki/5.-FAQ#how-can-i-use-my-own-html-markup-with-your-plugin) and [How to style WP Popular Posts](https://github.com/cabrerahector/wordpress-popular-posts/wiki/6.-Styling-the-list) for more.) |
| 31 | * **Performance Tools!** - WP Popular Posts includes a few options to make sure your site's performance stays as good as ever! (see [Performance](https://github.com/cabrerahector/wordpress-popular-posts/wiki/7.-Performance) for more details.) |
| 32 | * **REST API support** - Embed your popular posts in your (web) app! (see [REST API Endpoints](https://github.com/cabrerahector/wordpress-popular-posts/wiki/8.-REST-API-Endpoints) for more.) |
| 33 | * **Elementor support** - Are you building sites with Elementor? There's a popular posts widget for it too! |
| 34 | * **Disqus support** - Sort your popular posts by Disqus comments count! |
| 35 | * **Polylang & WPML 3.2+ support** - Show the translated version of your popular posts! |
| 36 | * **WordPress Multisite support** - Each site on the network can have its own popular posts list! |
| 37 | |
| 38 | = Other Features = |
| 39 | * **Shortcode support** - Use the [wpp] shortcode to showcase your most popular posts on pages, too! For usage and instructions, please refer to the [Installation section](https://wordpress.org/plugins/wordpress-popular-posts/#installation). |
| 40 | * **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, 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 [Installation section](https://wordpress.org/plugins/wordpress-popular-posts/#installation). |
| 41 | * **Localization** - [Translate WPP into your own language](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). |
| 42 | * **[WP-PostRatings](https://wordpress.org/plugins/wp-postratings/) support** - Show your visitors how your readers are rating your posts! |
| 43 | |
| 44 | = PSA: The classic WP Popular Posts widget has reached End-of-Life = |
| 45 | |
| 46 | The classic WP Popular Posts widget doesn't work very well with the [block-based Widgets editor](https://wordpress.org/documentation/article/block-based-widgets-editor/) introduced with WordPress 5.8. |
| 47 | |
| 48 | This new Widgets editor expects [WordPress blocks](https://wordpress.org/documentation/article/blocks-list/) instead of regular WordPress widgets. If you're using the classic WP Popular Posts widget please follow the [Migration Guide](https://cabrerahector.com/wordpress/migrating-from-the-classic-popular-posts-widget/) to replace it with the WP Popular Posts block, the [wpp] shortcode, or the WP Popular Posts widget for Elementor. |
| 49 | |
| 50 | Bjorn from wplearninglab.com was kind enough to create a video explaining how to use the new block for all of you visual learners: |
| 51 | |
| 52 | [youtube https://www.youtube.com/watch?v=mtzk6yNEaFs] |
| 53 | |
| 54 | = Support the Project! = |
| 55 | |
| 56 | 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! |
| 57 | |
| 58 | [Buy me a coffee](https://ko-fi.com/cabrerahector) | [PayPal](https://www.paypal.com/paypalme/cabrerahector) |
| 59 | |
| 60 | **WP Popular Posts** is now also on [GitHub](https://github.com/cabrerahector/wordpress-popular-posts)! |
| 61 | |
| 62 | Looking for a **Recent Posts** widget just as featured-packed as WP Popular Posts? **Try [Recently](https://wordpress.org/plugins/recently/)**! |
| 63 | |
| 64 | == Installation == |
| 65 | |
| 66 | Please make sure your site meets the [minimum requirements](https://github.com/cabrerahector/wordpress-popular-posts#requirements) before proceeding. |
| 67 | |
| 68 | = Automatic installation = |
| 69 | |
| 70 | 1. Log in into your WordPress dashboard. |
| 71 | 2. Go to Plugins > Add New. |
| 72 | 3. In the "Search Plugins" field, type in **WP Popular Posts** and hit Enter. |
| 73 | 4. Find the plugin in the search results list and click on the "Install Now" button. |
| 74 | |
| 75 | = Manual installation = |
| 76 | |
| 77 | 1. Download the plugin and extract its contents. |
| 78 | 2. Upload the `wordpress-popular-posts` folder to the `/wp-content/plugins/` directory. |
| 79 | 3. Activate the **WP Popular Posts** plugin through the "Plugins" menu in WordPress. |
| 80 | |
| 81 | = Done! What's next? = |
| 82 | |
| 83 | 1. Please see the Usage section below to learn how to add a popular post list to your site. Once you're done, keep reading. |
| 84 | 2. If you have a caching plugin installed on your site, flush its cache now so WPP can start tracking your site. |
| 85 | 3. If you have a plugin that minifies JavaScript (JS) installed on your site please read this FAQ: [Is WP Popular Posts compatible with plugins that minify/bundle JavaScript code?](https://github.com/cabrerahector/wordpress-popular-posts/wiki/5.-FAQ#is-wordpress-popular-posts-compatible-with-plugins-that-minifybundle-javascript-code) |
| 86 | 4. If you have a security / firewall plugin installed on your site, make sure you [allow WPP access to the REST API](https://wordpress.org/support/topic/wpp-does-not-count-properly/#post-10411163) so it can start tracking your site. |
| 87 | 5. 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). |
| 88 | 6. (Optional but highly recommended) Are you running a medium/high traffic site? If so, it might be a good idea to check [these suggestions](https://github.com/cabrerahector/wordpress-popular-posts/wiki/7.-Performance) to make sure your site's performance stays up to par. |
| 89 | |
| 90 | That's it! |
| 91 | |
| 92 | = USAGE = |
| 93 | |
| 94 | WP Popular Posts can be used in four different ways: |
| 95 | |
| 96 | 1. If you're using the [Block Editor](https://wordpress.org/support/article/wordpress-editor/) you can insert a WP Popular Posts block on your sidebar and even anywhere within your posts and pages. |
| 97 | 2. As a template tag: you can place it anywhere on your theme with [`wpp_get_mostpopular()`](https://github.com/cabrerahector/wordpress-popular-posts/wiki/2.-Template-tags#wpp_get_mostpopular). |
| 98 | 3. Via [shortcode](https://github.com/cabrerahector/wordpress-popular-posts/wiki/1.-Using-WPP-on-posts-&-pages), so you can embed it inside a post or a page. |
| 99 | 4. If you're using [Elementor](https://wordpress.org/plugins/elementor/) on your site you can use the [WP Popular Posts widget for Elementor](https://cabrerahector.com/wordpress/wordpress-popular-posts-7-3-experimental-elementor-support/). |
| 100 | |
| 101 | Make sure to stop by the **[Wiki](https://github.com/cabrerahector/wordpress-popular-posts/wiki)** as well, you'll find even more info there! |
| 102 | |
| 103 | == Frequently Asked Questions == |
| 104 | |
| 105 | The FAQ section has been moved [here](https://github.com/cabrerahector/wordpress-popular-posts/wiki/5.-FAQ). |
| 106 | |
| 107 | == Screenshots == |
| 108 | |
| 109 | 1. The WP Popular Posts block. |
| 110 | 2. The WP Popular Posts block on theme's sidebar. |
| 111 | 3. The WP Popular Posts widget for Elementor. |
| 112 | 4. Dashboard widget. |
| 113 | 5. Statistics panel. |
| 114 | |
| 115 | == Changelog == |
| 116 | |
| 117 | = 7.4.1 = |
| 118 | |
| 119 | - Only administrators can have access to plugin's management screens now (props to @gamefa!) |
| 120 | - Improved compatibility with Site Optimizer. |
| 121 | - Various minor fixes and improvements. |
| 122 | |
| 123 | [Release notes](https://cabrerahector.com/wordpress/wp-popular-posts-7-4-performance-impromevents-new-admin-views-column/#7.4.1) |
| 124 | |
| 125 | = 7.4.0 = |
| 126 | |
| 127 | - The Log Limit functionality is now enabled by default for new installs (see [Log Limit](https://cabrerahector.com/wordpress/wp-popular-posts-7-4-performance-impromevents-new-admin-views-column/#log-limit) for more details) |
| 128 | - New "Views" column in posts lists (see [Views column](https://cabrerahector.com/wordpress/wp-popular-posts-7-4-performance-impromevents-new-admin-views-column/#views-column) for more) |
| 129 | - Fixed a bug affecting the Custom time range functionality (props to dxylott54 for reporting the issue!) |
| 130 | - Improved accessibility in the Stats screen. |
| 131 | - Plugin has finally dropped all jQuery dependencies! |
| 132 | - Other minor improvements. |
| 133 | |
| 134 | [Release notes](https://cabrerahector.com/wordpress/wp-popular-posts-7-4-performance-impromevents-new-admin-views-column/) |
| 135 | |
| 136 | [Full Changelog](https://github.com/cabrerahector/wordpress-popular-posts/blob/master/changelog.md) |
| 137 | |
| 138 | == Credits == |
| 139 | |
| 140 | * Flame graphic by freevector/Vecteezy.com. |
| 141 | |
| 142 | == Upgrade Notice == |
| 143 | = 7.2.0 = |
| 144 | If you're using a caching plugin on your website it's highly recommended to clear its cache after installing / updating to this version. |