Skip to content

The Hits List Documentation

The Hits List tracks post views locally in WordPress, displays popular posts, and can migrate compatible Top 10 data into a free replacement.

Version 1.6.0

Stable tag: 1.6.0

Requires WordPress 6.2 or newer and PHP 7.4 or newer. Tested up to WordPress 7.1.

Read the 1.6.0 release notes for the new ranking controls,
article reports, and count-maintenance improvements.

Documentation

Key Features

  • Local view tracking in WordPress database tables.
  • Overall, daily, and short-lived hourly view counts.
  • Trending, which ranks posts by how fast views are rising rather than by totals.
  • Refresh candidates, highlighting well-read posts that have gone quiet.
  • Popular Posts block, widget, shortcodes, and template tags, with current-post
    exclusion and publication-age limits.
  • A standalone Post Views block for displaying one article's count.
  • Ranking suppression for individual posts or selected categories and tags,
    while keeping tracking and view history.
  • Article-performance charts and daily tables on the edit screen.
  • Refresh-candidate snooze controls and seven-day before/after refresh reports.
  • Five WordPress dashboard cards covering daily and all-time top posts, views over time, trending, and refresh candidates.
  • Configurable dashboard access for additional roles.
  • Sortable total and today's view columns, plus a condensed Views column, on
    selected public content types.
  • Configurable daily retention and automatic hourly retention.
  • CSV and JSON import/export of overall and daily counts.
  • Automatic cleanup after permanent deletion, background repair of historical
    orphan counts, and WP-CLI count removal.
  • Rerun-safe Top 10 migration compatibility, with cleanup and old-plugin removal.
  • REST-based tracking with AJAX as a selectable alternative.
  • Privacy-policy integration for site owners.