| 1 |
=== WebberZone Top 10 — Popular Posts === |
| 2 |
Tags: popular posts, post views, page views, most viewed posts, popular posts widget, trending posts, post views counter, multisite, block, shortcode |
| 3 |
Contributors: webberzone, ajay |
| 4 |
Donate link: https://wzn.io/donate-wz |
| 5 |
Stable tag: 4.5.2 |
| 6 |
Requires at least: 6.8 |
| 7 |
Tested up to: 7.1 |
| 8 |
Requires PHP: 7.4 |
| 9 |
License: GPLv2 or later |
| 10 |
|
| 11 |
Track post views and page views, and display popular posts and trending content on your WordPress site. |
| 12 |
|
| 13 |
== Description == |
| 14 |
|
| 15 |
WordPress lacks built-in page view tracking or a popular posts feature. [Top 10](https://webberzone.com/plugins/top-10/) solves this by counting views across posts, pages, and custom post types, then letting you showcase your most popular content. |
| 16 |
|
| 17 |
Top 10 provides blocks, widgets, shortcodes, and template functions for displaying popular posts and view counts across your site. All tracking data is stored locally in your WordPress database, with no external services involved. |
| 18 |
|
| 19 |
Top 10 includes comprehensive features such as thumbnail support, flexible display options, custom post type support, and developer-friendly extensibility. A built-in caching layer reduces server load, while AJAX-based tracking avoids page cache interference and works with most popular caching plugins. |
| 20 |
|
| 21 |
Top 10 also exposes a powerful API with WordPress actions and filters, allowing developers to customise queries, tracking behaviour, and output rendering without modifying core plugin files. |
| 22 |
|
| 23 |
= Features = |
| 24 |
|
| 25 |
* **Page Counter**: Tracks hourly post views on posts, pages, and custom post types. Display counts automatically using blocks, shortcodes, or template functions |
| 26 |
* **Popular Posts**: Display most viewed posts by total counts or within custom time periods |
| 27 |
* **Gutenberg Support**: Dedicated “Popular Posts [Top 10]” block with configurable display options |
| 28 |
* **Multisite Dashboard**: Network-wide aggregated statistics across all sites in a multisite installation |
| 29 |
* **Widgets**: Sidebar widgets for daily and overall popular posts with extensive customisation |
| 30 |
* **Shortcodes**: Use `[tptn_list]` to display popular post lists and `[tptn_views]` to show view counts |
| 31 |
* **Thumbnails**: |
| 32 |
* WordPress post thumbnail support with custom `tptn_thumbnail` image size |
| 33 |
* Automatic extraction of the first image from post content |
| 34 |
* Manual thumbnail URLs via Edit Post screens |
| 35 |
* **Exclusions**: Exclude posts by category or post ID from popular post lists |
| 36 |
* **Styling**: Output wrapped in semantic CSS classes. Add custom CSS via settings or use included styles |
| 37 |
* **Admin Interface**: View daily and overall popular posts from the dashboard. Adds sortable view-count columns to post and page lists |
| 38 |
* **Export/Import**: Export count tables and settings, and restore them on the same site or other installs |
| 39 |
* **Caching Compatibility**: Works with WP Super Cache, W3 Total Cache, Quick Cache, and similar plugins |
| 40 |
* **Developer-Friendly**: Extensive filters and actions to customise queries, tracking behaviour, and output rendering |
| 41 |
|
| 42 |
= Features in Top 10 Pro = |
| 43 |
|
| 44 |
* __Enhanced Tracking and Performance__ |
| 45 |
* __Fast and High-Traffic Trackers__: Alternative tracking methods for improved performance on busy sites |
| 46 |
* __Site-wide Tracking__: Track views for the front page, posts page, archives, and searches in addition to individual content |
| 47 |
* __Query Optimisation__: MySQL `MAX_EXECUTION_TIME` directive to prevent long-running queries, configurable via settings and the `top_ten_query_max_execution_time` filter |
| 48 |
* __Data Retention Override__: Customizable data retention period (default 180 days via `TOP_TEN_STORE_DATA`) |
| 49 |
* __Lazy Loading__: Render popular posts lists via JavaScript only when they are about to scroll into view, so full-page caching plugins can serve a page without baking in a live popular-posts query. Works with content, shortcodes, widgets, and the Popular Posts block; disable per instance with the `lazy_load` shortcode/block attribute |
| 50 |
|
| 51 |
* __Advanced Blocks and Widgets__ |
| 52 |
* __Top 10 Query Block__: Query and display popular posts directly from the block or site editor |
| 53 |
* __Enhanced Top 10 Featured Image Block__: Support for multiple image sources with fallbacks |
| 54 |
* __Popular Posts Block Enhancements__: |
| 55 |
* Save and clear default block settings with a single click |
| 56 |
* Auto-insert default and global settings attributes with an option to disable |
| 57 |
|
| 58 |
* __Enhanced Admin Tools__ |
| 59 |
* __Admin Bar Integration__: Admin bar menu item to view daily, total, and overall post counts, access admin pages, and clear cache |
| 60 |
* __Disable Admin Bar menu__: Setting to disable the Admin Bar menu |
| 61 |
* __Dashboard Access Control__: Setting to control which user roles can view the Top 10 dashboard |
| 62 |
* __Display Settings__: Setting to choose which post type screens display admin columns |
| 63 |
* __Mini "Top 10 Views Overview" widget__: Compact views-over-time chart on the WordPress Dashboard |
| 64 |
* __Multisite Settings Copy__: Tool to copy settings between sites in a multisite network |
| 65 |
|
| 66 |
* __Custom Display Options__ |
| 67 |
* __Taxonomy-Specific Displays__: `display_only_on_tax_ids` parameter to restrict popular post displays to specific taxonomy terms |
| 68 |
* __Category Inclusion__: Edit Post meta box option to include popular posts from specific categories |
| 69 |
* __RSS Feed Filtering__: Filter RSS feeds by category or post type via settings or URL parameters |
| 70 |
|
| 71 |
* __WP-CLI Integration__ |
| 72 |
* __`wp top10 counts`__: View, get, set, reset, export, and import post view counts from the command line |
| 73 |
* __`wp top10 db`__: Manage database tables — check status, create, update, recreate, prune old rows, force aggregation, truncate, and clean up orphaned counts |
| 74 |
* __`wp top10 cache`__: Flush, enable, disable, and check the status of the output cache |
| 75 |
* __`wp top10 settings`__: Get, set, export, and import plugin settings as JSON |
| 76 |
* __`wp top10 cron`__: View, enable, disable, and manually trigger the maintenance and aggregation cron jobs |
| 77 |
* __`wp top10 popular`__: List popular posts with counts using the same query as the front end |
| 78 |
* __`wp top10 status`__: Print a full plugin status overview |
| 79 |
* All destructive commands support `--dry-run` and `--force`; multisite commands support `--network` and `--blog-id` |
| 80 |
|
| 81 |
* __Developer-Friendly Features__ |
| 82 |
* __Custom Post Type Sortable Columns__: Admin columns on supported custom post types with sortable functionality |
| 83 |
|
| 84 |
= GDPR = |
| 85 |
|
| 86 |
Top 10 does not collect personal visitor data out of the box. Tracking data is stored locally in the `wp_top_ten` and `wp_top_ten_daily` database tables (table prefix may vary). |
| 87 |
|
| 88 |
You are responsible for ensuring GDPR compliance on your website. |
| 89 |
|
| 90 |
= Multilingual sites = |
| 91 |
|
| 92 |
Top 10 works with WPML, Polylang and TranslatePress without additional plugin configuration. WPML and Polylang map popular posts to the language being viewed. TranslatePress translates popular post titles, excerpts and links with the rest of the page, including results delivered through the REST API and lazy-loaded lists in Top 10 Pro. |
| 93 |
|
| 94 |
Popular post caches are separated by language, preventing cached lists from serving another language's links. |
| 95 |
|
| 96 |
= Translations = |
| 97 |
|
| 98 |
Top 10 is available for translation on [WordPress.org](https://translate.wordpress.org/projects/wp-plugins/top-10). |
| 99 |
See the [Translator Handbook](https://make.wordpress.org/polyglots/handbook/rosetta/theme-plugin-directories/) to contribute. |
| 100 |
|
| 101 |
= Contribute = |
| 102 |
|
| 103 |
Top 10 is developed openly on [GitHub](https://github.com/webberzone/top-10). |
| 104 |
Fork the project and submit pull requests for bug fixes or improvements. Please do not use GitHub for support requests. |
| 105 |
|
| 106 |
== Other WebberZone Plugins == |
| 107 |
|
| 108 |
* [Contextual Related Posts](https://wordpress.org/plugins/contextual-related-posts/) – Display related posts on your WordPress site and feeds |
| 109 |
* [Better Search](https://wordpress.org/plugins/better-search/) – Enhance WordPress search with relevance-based results |
| 110 |
* [Knowledge Base](https://wordpress.org/plugins/knowledgebase/) – Create a knowledge base or FAQ section |
| 111 |
* [WebberZone Snippetz](https://wordpress.org/plugins/add-to-all/) – Manage custom HTML, CSS, and JavaScript snippets |
| 112 |
* [Auto-Close](https://wordpress.org/plugins/autoclose/) – Automatically close comments, pingbacks, and trackbacks |
| 113 |
* [Popular Authors](https://wordpress.org/plugins/popular-authors/) – Display popular authors widgets. Addon for Top 10. |
| 114 |
* [Followed Posts](https://wordpress.org/plugins/where-did-they-go-from-here/) – Show related posts based on reader journeys |
| 115 |
* [WebberZone Link Warnings](https://wordpress.org/plugins/webberzone-link-warnings/) – Add accessible warnings for external links and target="_blank" links |
| 116 |
|
| 117 |
== Screenshots == |
| 118 |
|
| 119 |
1. Top 10 – Popular posts overview in the WordPress admin |
| 120 |
2. Top 10 – Popular posts list with thumbnails |
| 121 |
|
| 122 |
== Installation == |
| 123 |
|
| 124 |
= WordPress install (easy way) = |
| 125 |
1. Go to Plugins → Add New in your WordPress Admin |
| 126 |
2. Search for “Top 10” |
| 127 |
3. Click Install Now and then Activate |
| 128 |
|
| 129 |
= Manual install = |
| 130 |
1. Download the `top-10.zip` file |
| 131 |
2. Go to Plugins → Add New → Upload Plugin |
| 132 |
3. Upload the ZIP file and click Install Now |
| 133 |
4. Activate the plugin |
| 134 |
5. Configure settings under Top 10 → Settings |
| 135 |
|
| 136 |
= Help and Support = |
| 137 |
* [Documentation](https://webberzone.com/support/product/top-10/) |
| 138 |
* [WordPress.org Support Forum](https://wordpress.org/support/plugin/top-10) |
| 139 |
|
| 140 |
== Frequently Asked Questions == |
| 141 |
|
| 142 |
= Where can I get help and support? = |
| 143 |
|
| 144 |
Before opening a support request, please check the following resources: |
| 145 |
|
| 146 |
* [FAQ on the WordPress.org plugin page](https://wordpress.org/plugins/top-10/faq/) |
| 147 |
* [FAQ on the WebberZone knowledge base](https://webberzone.com/support/product/top-10/) |
| 148 |
|
| 149 |
These cover the most common questions and are the fastest way to get answers, as they are actively maintained. |
| 150 |
|
| 151 |
If your question is not answered there, please create a new topic in the |
| 152 |
[WordPress.org support forum](https://wordpress.org/support/plugin/top-10/). |
| 153 |
This is the preferred support channel for the free plugin, and the forums are monitored regularly. |
| 154 |
|
| 155 |
Support for products sold and distributed by WebberZone is available **only** |
| 156 |
to users with an active, valid licence. Licensed users can request support [here](https://webberzone.com/request-support/). |
| 157 |
|
| 158 |
= Can this plugin replace Google Analytics? = |
| 159 |
|
| 160 |
No. Top 10 tracks page views and displays popular posts. It is not designed to replace analytics platforms. |
| 161 |
|
| 162 |
= How does tracking work? = |
| 163 |
|
| 164 |
Each visit is queued in a lightweight funnel table and aggregated into the count tables every five minutes by a cron job, so tracking never blocks page loads and works correctly behind page caches. |
| 165 |
|
| 166 |
For a full explanation of tracker types, the funnel flow, and how to adjust the aggregation interval, see [Trackers in Top 10](https://webberzone.com/support/knowledgebase/trackers-in-top-10/). |
| 167 |
|
| 168 |
= How does scheduled maintenance work? = |
| 169 |
|
| 170 |
When enabled, Top 10 runs a scheduled task that periodically removes old entries |
| 171 |
from the `wp_top_ten_daily` table. |
| 172 |
|
| 173 |
Note: WordPress executes scheduled tasks on the first eligible page load. |
| 174 |
|
| 175 |
= How can I report security bugs? = |
| 176 |
|
| 177 |
You can report security bugs through the Patchstack Vulnerability Disclosure Program. |
| 178 |
The Patchstack team help validate, triage and handle any security vulnerabilities. |
| 179 |
[Report a security vulnerability.](https://patchstack.com/database/vdp/top-10) |
| 180 |
|
| 181 |
== Changelog == |
| 182 |
|
| 183 |
= 4.5.2 = |
| 184 |
|
| 185 |
Release date: 7 October 2026 |
| 186 |
|
| 187 |
**Added** |
| 188 |
|
| 189 |
* TranslatePress translation for popular post titles, excerpts and links returned through the REST API. |
| 190 |
* REST API endpoints toggle in the Features tab for disabling unused Top 10 API integrations. |
| 191 |
* [Pro] TranslatePress support for lazy-loaded popular posts. |
| 192 |
* [Pro] Independent lazy-loading module toggle in the Features tab. Disabling REST API endpoints also disables lazy loading. |
| 193 |
|
| 194 |
**Changed** |
| 195 |
|
| 196 |
* Updated Freemius SDK to 2.13.5. |
| 197 |
|
| 198 |
**Fixed** |
| 199 |
|
| 200 |
* Cached popular posts were shared across languages on WPML, Polylang and TranslatePress sites. |
| 201 |
* Setup wizard labels were not associated with their input fields. |
| 202 |
* Updating settings before any options had been saved could trigger a PHP deprecation warning. |
| 203 |
|
| 204 |
= 4.5.1 = |
| 205 |
|
| 206 |
Release date: 19 September 2026 |
| 207 |
|
| 208 |
**Security** |
| 209 |
|
| 210 |
* Hardened thumbnail dimension handling to prevent stored cross-site scripting through block attributes. |
| 211 |
|
| 212 |
= 4.5.0 = |
| 213 |
|
| 214 |
Release date: 7 September 2026 |
| 215 |
Release post: https://webberzone.com/announcements/top-10-v4-5/ |
| 216 |
|
| 217 |
**Added** |
| 218 |
|
| 219 |
* [Pro] Popular Posts elements for Elementor, Bricks Builder and WPBakery Page Builder. |
| 220 |
* [Pro] Optional site-wide tracking for front pages, posts pages, archives and searches. |
| 221 |
* [Pro] Reduce Daily Table Size tool to combine older hourly records. |
| 222 |
* [Pro] `wp top10 db rollup` command for CLI and multisite use. |
| 223 |
|
| 224 |
**Changed** |
| 225 |
|
| 226 |
* Reduced admin overhead on large multisite networks by caching table metadata, probing WPP tables directly and using estimated row counts on the Tools page. |
| 227 |
* Sped up the dashboard with index-friendly `dp_date` ranges, optimized network popular-post queries and on-demand loading of historical tabs. |
| 228 |
* Setting defaults are now resolved from a lightweight list instead of building every settings field, so reading an option early in the page load no longer loads translations too early. |
| 229 |
|
| 230 |
**Security** |
| 231 |
|
| 232 |
* Hardened settings sanitization for users without the `unfiltered_html` capability. |
| 233 |
* Hardened referer and array handling in settings sanitization, and renamed the settings JS globals. |
| 234 |
|
| 235 |
**Fixed** |
| 236 |
|
| 237 |
* View tracking was lost during quick navigation or browser back-button restores. |
| 238 |
* View counts were recorded for prerendered or initially hidden pages. |
| 239 |
* Bot views were recorded from cached pages, and views were recorded for browser prefetches, prerenders and direct navigations to tracker URLs. |
| 240 |
* Tracker scripts did not run when loaded asynchronously after `DOMContentLoaded` had fired. |
| 241 |
* Generated output cache keys were not discoverable by the Clear Cache tools or the WP-CLI cache flush command. |
| 242 |
* Settings on a multisite network read another site's values in the same request after a `switch_to_blog()` call, when read via `tptn_get_option()` or the global `$tptn_settings`. |
| 243 |
* `tptn_get_settings()` returned `false` instead of an empty array when no settings had been saved yet. |
| 244 |
* Visit data was silently lost in funnel aggregation, and the Fast Tracker raised an undefined array key warning. |
| 245 |
* Plugin data was deleted when uninstalling one version while its paired free or Pro counterpart was active. |
| 246 |
* Improved compatibility with PHP 8.6. |
| 247 |
* [Pro] Daily counts in the `wp top10 popular` command did not respect the selected custom date range. |
| 248 |
|
| 249 |
= Earlier versions = |
| 250 |
|
| 251 |
For the changelog of earlier versions, please refer to the [releases page on GitHub](https://github.com/WebberZone/top-10/releases). |
| 252 |
|
| 253 |
== Upgrade Notice == |
| 254 |
|
| 255 |
= 4.5.2 = |
| 256 |
Keeps popular posts in the correct language on multilingual sites, adds controls for REST API endpoints and Pro lazy loading, and fixes setup wizard accessibility. |
| 257 |
|
