Title: The Hits List
Author: Adam Greenwell
Published: <strong>18 Mei 2026</strong>
Last modified: 22 Mei 2026

---

Search plugins

![](https://ps.w.org/the-hits-list/assets/icon-256x256.png?rev=3537364)

# The Hits List

 Oleh [Adam Greenwell](https://profiles.wordpress.org/adamgreenwell/)

[Download](https://downloads.wordpress.org/plugin/the-hits-list.1.3.02.zip)

 * [Details](https://ms.wordpress.org/plugins/the-hits-list/#description)
 * [Reviews](https://ms.wordpress.org/plugins/the-hits-list/#reviews)
 *  [Pemasangan](https://ms.wordpress.org/plugins/the-hits-list/#installation)
 * [Pembangunan](https://ms.wordpress.org/plugins/the-hits-list/#developers)

 [Support](https://wordpress.org/support/plugin/the-hits-list/)

## Description

The Hits List keeps post view tracking on your own WordPress site and gives you 
block, widget, and template-tag tools for displaying popular content.

Key features:

 * Local view tracking stored in WordPress database tables
 * Overall and daily popular-post counts
 * Popular Posts block and widget support with public post type selection
 * WordPress dashboard cards for daily top posts, all-time top posts, and views 
   over time
 * Top 10 migration compatibility with resumable rerun-safe imports, WP-CLI tools,
   legacy widget support, native widget conversion, cleanup for old Top 10 leftovers,
   and optional Top 10 plugin removal
 * REST-based tracking with AJAX fallback
 * Privacy-policy integration for site owners

### Privacy

The Hits List stores post view counts locally in the `hits_list` and `hits_list_daily`
database tables (table prefix may vary).

It does not send tracking data to a third-party analytics service.

Daily tracking buckets are retained for 180 days by default and older rows are removed
automatically.

You are responsible for describing your use of visitor analytics on your own site
as needed.

### Source Code and Build Tools

The compiled block assets in `blocks/popular-posts/build/` are generated from the
human-readable source files included in `blocks/popular-posts/src/`.

To rebuild the block assets:

 1. Go to `blocks/popular-posts/`.
 2. Run `npm install`.
 3. Run `npm run build`.

The block build uses `@wordpress/scripts`. Runtime PHP, vanilla JavaScript, and 
CSS assets outside the block build are maintained directly in the plugin source.

## Blocks

This plugin provides 1 block.

 *   The Hits List – Popular Posts Display the most popular posts as a list or grid
   based on view counts

## Installation

 1. Upload the `the-hits-list` folder to `/wp-content/plugins/`.
 2. Activate The Hits List through the Plugins screen in WordPress.
 3. Go to Settings > The Hits List to configure tracking and display options.
 4. If Top 10 data is detected, use the import button on the settings screen to migrate
    existing counts.
 5. After importing and converting widgets, use Clean Up Top 10 to remove old Top 10
    tables, options, transients, metadata, and cron hooks.
 6. Use Remove Top 10 Plugin to deactivate and delete the old plugin when you are ready.

## FAQ

### Does this send data to a third-party service?

No. The Hits List stores tracking data locally in your WordPress database and does
not call a third-party analytics endpoint.

### Can I migrate from Top 10?

Yes. The plugin can import compatible overall and daily counts from Top 10 tables.
Imports are SQL-backed, resumable, and rerun-safe, so repeating the import does 
not double-count unchanged source data. Very large imports can be monitored from
the settings screen or run through WP-CLI. If Top 10 is deactivated, existing Top
10 Popular Posts widgets can continue rendering through The Hits List using their
saved settings, and the settings screen can convert those placements into native
The Hits List widgets. After the import and widget conversion are complete, the 
settings screen also exposes Clean Up Top 10 and Remove Top 10 Plugin buttons to
remove leftover Top 10 database data and delete the old plugin.

### How long is daily data kept?

Daily buckets are retained for 180 days by default. Older daily rows are pruned 
automatically by a scheduled cleanup task.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“The Hits List” adalah perisian sumber terbuka. Orang-orang berikut telah menyumbang
kepada pemalam ini.

Penyumbang

 *   [ Adam Greenwell ](https://profiles.wordpress.org/adamgreenwell/)

[Translate “The Hits List” into your language.](https://translate.wordpress.org/projects/wp-plugins/the-hits-list)

### Berminat dalam pembangunan?

[Layari kod](https://plugins.trac.wordpress.org/browser/the-hits-list/), periksa
[repositori SVN](https://plugins.svn.wordpress.org/the-hits-list/), atau langgani
[log pembangunan](https://plugins.trac.wordpress.org/log/the-hits-list/) dengan 
[RSS](https://plugins.trac.wordpress.org/log/the-hits-list/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.3.02

 * Added an explicit Clean Up Top 10 section on the settings screen for removing
   leftover Top 10 tables, options, transients, metadata, and cron hooks after migration.
 * Added an explicit Remove Top 10 Plugin action that can deactivate/delete the 
   old plugin and run one final cleanup pass.
 * Added guardrails so cleanup is blocked until active Top 10 imports and placed
   legacy Top 10 widgets are handled.

#### 1.3.01

 * Added public post type selection to the Popular Posts block and widget.
 * Added a legacy Top 10 widget compatibility bridge so existing `widget_tptn_pop`
   placements keep rendering after Top 10 is deactivated.
 * Added a native Top 10 widget migrator that rewrites saved sidebar placements 
   while preserving third-party widget metadata.
 * Reworked Top 10 imports to run in resumable batches with status, progress, cancel/
   restart controls, diagnostics, and WP-CLI commands for large migrations.
 * Reworked Top 10 import tracking to store large rerun state in database tables
   instead of oversized options.
 * Improved Top 10 import error messages and asset cache busting in the admin UI.
 * Added the `get_thl_posts()` helper alias for older integration examples.
 * Avoided empty `.thl-meta` wrappers when all post meta display options are disabled.
 * Confirmed compatibility metadata for WordPress 7.0.

#### 1.3.0

 * Added WordPress dashboard cards for daily top posts, all-time top posts, and 
   views over time.
 * Added post list table columns for total, daily, and condensed view counts.
 * Hardened public REST tracking and counter endpoints.
 * Removed the legacy query-string tracking endpoint.

#### 1.2.0

 * Normalized tracking to use server-derived blog IDs and validated post targets.
 * Reworked daily tracking into true site-local day buckets with upgrade migration
   support.
 * Added rerun-safe Top 10 import state handling.

## Meta

 *  Version **1.3.02**
 *  Last updated **2 minggu lalu**
 *  Active installations **Kurang dari 10**
 *  WordPress version ** 6.2 or higher **
 *  Tested up to **7.0**
 *  PHP version ** 7.4 or higher **
 *  Language
 * [English (US)](https://wordpress.org/plugins/the-hits-list/)
 * Tags
 * [blocks](https://ms.wordpress.org/plugins/tags/blocks/)[migration](https://ms.wordpress.org/plugins/tags/migration/)
   [page views](https://ms.wordpress.org/plugins/tags/page-views/)[popular posts](https://ms.wordpress.org/plugins/tags/popular-posts/)
   [post views](https://ms.wordpress.org/plugins/tags/post-views/)
 *  [Paparan Lanjutan](https://ms.wordpress.org/plugins/the-hits-list/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/the-hits-list/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/the-hits-list/reviews/)

## Penyumbang

 *   [ Adam Greenwell ](https://profiles.wordpress.org/adamgreenwell/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/the-hits-list/)