0
Documentation / Stats Captain

Stats Captain (OG)

Tier 2 traffic and podcast analytics — dashboards in the admin, widgets on any page via shortcode.

What It Does

Stats Captain OG is the analytics module for server-tier (Tier 2) sites. It tracks visits, tourists, referrers, and podcast plays, then presents the data two ways: a full admin dashboard with drilldowns, and embeddable widgets for public pages via the shortcode. It replaces the retired original StatsCaptain — don’t install the old one.

Getting Started

  1. Open Stats Captain OG from the admin menu.
  2. Review the scoreboard for visits, unique tourists, top referrers, and podcast metrics.
  3. Drill into the log viewer for per-request detail when you need it.
  4. To publish a scoreboard on a public page, drop into the page content.
  5. Tune the widget with options (see below).

Admin Dashboard

The dashboard shows rolling totals, top pages, top referrers, and the podcast scoreboard (episode plays, unique listeners). A built-in log viewer exposes individual hits if you need to audit traffic or chase down a bot.

Public Widgets via Shortcode

Use to embed a stats widget on any page. Variants:

  • — dark theme
  • — light theme
  • — compact
  • or period="today" — time range
  • — include podcast scoreboard

Combine them: .

What Replaced What

The original StatsCaptain module is retired — never re-install it. StatsCaptainOG is the full, current stats stack for Tier 2 sites. Separately, affiliate sites use AmazonAffiliateDashboard with hub-side AmazonCollector (the AudienceBuilder pattern). Don’t mix stacks.

Gotchas / Tips

  • Never reference site-root/vstats/ — those folders are rogue legacy cruft. The real stats system lives in admin/modules/StatsCaptainOG/.
  • Tier 2 sites only. Pinnacle and base sites don’t need this — they use different tools.
  • If widget counts look wrong, check the dashboard first — widgets pull from the same underlying log.
  • Don’t hand-edit log files; use the log viewer to filter and the admin actions to manage them.