WordPress doesn't have an in-built system to track page views or displaying popular posts.
Top 10 is an easy to use, yet, powerful WordPress plugin that will count the number of page views of your posts, pages and any custom post types. You can then display the page view counts as well as display your most popular posts.
Top 10 adds two widgets that you can use to display a list of popular posts and the counta cross all your blog posts.
Although several similar plugins exist today, Top 10 is one of the most feature-rich popular post plugins with support for thumbnails, shortcodes, widgets, custom post types and CSS styles. The inbuilt caching system also helps reduce server load by caching your popular posts output. The tracking uses ajax and is thus compatible with most popular caching plugins.
Top 10 also has powerful API and is fully extendable with WordPress actions and filters to allow you easily extend the code base to add new features or tweak existing ones.
Features
- Page counter: Counts page views on single posts, pages and custom post types on an hourly basis which can then be easily displayed automatically, using shortcodes or functions
- Popular posts: Display a list of popular posts either for total counts or for a custom period. You can choose how many posts are to be displayed along with loads of other customisation options
- Gutenberg / Block Editor support: You can find a block called "Popular Posts [Top 10]" with its own configurable set of options
- Widget ready: Sidebar widgets available for daily popular and overall popular posts. Highly customizable widgets to control what you want to display in the list of posts
- Shortcodes: The plugin includes two shortcodes
[tptn_list]
and [tptn_views]
to display the posts list and the number of views respectively
- Thumbnail support
- Support for WordPress post thumbnails. Top 10 will create a custom image size (
tptn_thumbnail
) with the dimensions specified in the Settings page
- Auto-extract the first image in your post to be displayed as a thumbnail
- Manually enter the URL of the thumbnail via WordPress meta fields. Specify this using the meta box in your Edit screens.
- Exclusions: Exclude posts from select categories from appearing in the top posts list. Also exclude posts by ID from appearing in the list
- Styles: The output is wrapped in CSS classes which allows you to easily style the list. You can enter your custom CSS styles from within WordPress Admin area or use the style included.
- Admin interface: View list of daily and/or overall popular posts from within the dashboard. Top 10 also adds two sortable columns to your All Posts and All Pages pages in your WordPress Admin area
- Export/Import interface: Export the count tables and settings to restore in the same site or on other installs
- Works with caching plugins like WP-Super-Cache, W3 Total Cache or Quick Cache
- Extendable code: Top 10 has tonnes of filters and actions that allow any developer to easily add features, edit outputs, etc.
Features in Top 10 Pro
- Advanced Blocks and Widgets
- Top 10 Query Block: Query and display popular posts directly from the block or site editor.
- Enhanced Top 10 Featured Image Block: Supports multiple image sources for more flexibility.
- Popular Posts Block Enhancements:
- Save and clear default block settings with a single click.
- Auto-insert default and global settings attributes with an option to disable.
- Improved Admin Tools
- Admin Bar Integration: New admin bar menu item to view daily, total, and overall post counts, access admin pages, and clear the cache quickly.
- Dashboard Access Control: Control which user roles can view the Top 10 dashboard.
- Display Settings: Choose which post type screens display admin columns.
- Custom Display Options
- Taxonomy-Specific Displays: Use the
display_only_on_tax_ids
parameter to restrict popular post displays to specific taxonomy terms.
- Category Inclusion: Include popular posts from specific categories using a new option in the Edit Post meta box.
- Enhanced Tracking and Performance
- Fast Tracker: A new, faster tracking method to improve post view speed.
- Query Filters: Enable parent term inclusion in post queries for more accurate filtering.
- Developer-Friendly Features
- Filters and Hooks: New filters like
top_ten_query_exclude_terms_include_parents
, top_ten_query_include_terms_include_parents
, and get_tptn_short_circuit
for greater customisation.
- Custom Post Type Sortable Columns: Display columns on post types and make them sortable.
GDPR
Top 10 is GDPR compliant as it doesn't collect any personal data about your visitors when installed out of the box. You can see the data the plugin stores in the
wp_top_ten
and
wp_top_ten_daily
tables in the database. Note: the prefix
wp
might be different if you have changed it from the default.
YOU ARE RESPONSIBLE FOR ENSURING THAT ALL GDPR REQUIREMENTS ARE MET ON YOUR WEBSITE.
Translations
Top 10 is available for
translation directly on WordPress.org. Check out the official
Translator Handbook to contribute.
Contribute
Top 10 is also available on
Github
So, if you've got some cool feature that you'd like to implement into the plugin or a bug you've been able to fix, consider forking the project and sending me a pull request. Please don't use that for support requests.
WordPress install (the easy way)
- Navigate to Plugins within your WordPress Admin Area
- Click "Add new" and in the search box enter "Top 10"
- Find the plugin in the list (usually the first result) and click "Install Now"
Manual install
- Download the top-10.zip file from this release post
- Visit Plugins in your Admin Area
- Hit the Add New button next to the Plugins heading
- Hit the Upload button next to the Add Plugins heading
- Select the top-10.zip file that you downloaded and hit Install Now
- Activate the Plugin in WP-Admin.
- Go to Top 10 » Settings to configure
- Go to Appearance » Widgets and add Top 10 Popular Posts to your sidebar to display the popular posts in the sidebar
For help and support
- Visit Top 10 documentation for extensive information and examples of how to use the plugin
- Visit the Support forum on WordPress.org
4.0.2
- Updated Freemius SDK to 2.9.0.
- Fixed: Set
widget_id
if it is not set in the widget instance.
4.0.1
- Modifications:
- Renamed filter to:
top_ten_posts_post_types
.
- Updated filter
tptn_query_args_before
to be the queried object instead of just the post.
- Bug fix:
- Fixed issue where admin columns setting didn't work.
- Fixed: meta_query was not set.
4.0.0
Release post:
https://webberzone.com/announcements/top-10-v4-0-0/
- Features:
- Added a new REST API route (
counter
) to fetch the post count for individual posts.
- Introduced the Top 10 Post Count Block for displaying post counts.
- Added filters
top_ten_query_exclude_terms_include_parents
and top_ten_query_include_terms_include_parents
to include parent terms in post queries. Pro users can enable this in settings.
- New
get_tptn_short_circuit
filter to bypass the plugin’s output.
- New filter
tptn_dashboard_setup
to disable Top 10 widgets being displayed on the admin dashboard.
- [Pro] New Top 10 Query Block for querying popular posts directly from the block or site editor.
- [Pro] Enhanced Top 10 Featured Image Block now supports multiple image sources.
- [Pro] Popular Posts block now includes:
- Buttons to save and clear default block settings.
- Auto-insertion of default and global settings attributes, with an option to disable this in the Posts List settings.
- [Pro] Added a new admin bar menu item to view daily, total, and overall post counts, access Top 10 admin pages, and clear the Top 10 cache.
- [Pro] Added
display_only_on_tax_ids
parameter to restrict popular posts display to specific taxonomy terms.
- [Pro] New Fast Tracker improves post view tracking speed. Select it from your settings page.
- [Pro] "Display columns on post types" setting to choose which post type screens display admin columns.
- [Pro] "Also show dashboard to" setting to select user roles that can view the dashboard screen.
- [Pro] New option added to the Edit Post meta box mapped to
include_cat_ids
to include popular posts from specific categories only.
- Enhancements:
- Direct support for
WP_Query
if top_ten_query
is used in query arguments.
- Optimised media handler to reduce queries.
- New filter:
tptn_shortcode_defaults
for default shortcode arguments.
- Media Handler improvements:
- Added
use_site_icon
and style
parameters.
get_image_html()
now uses wp_get_attachment_image()
with a valid attachment ID.
- Support for
decoding
, loading
, and fetchpriority
attributes.
get_attachment_id_from_url()
now strips size suffixes before locating the attachment ID.
- Updated top-10/popular-posts block to API version 3.
- Added
$more_link_text
parameter for get_the_excerpt()
.
For previous changelog entries, please refer to the separate changelog.txt file or
Github Releases page