FlareStats

描述

FlareStats brings your CloudFlare web analytics data directly into the WordPress admin. No third-party tracking services, no cookies — just privacy-preserving analytics from Cloudflare.

Features

  • Dashboard Widget — A compact summary widget on the WordPress Dashboard.
  • Full Analytics Screen — Dedicated admin page with a 7-day daily chart, top 5 pages, and top 3 countries.
  • Last 7 Days — Data always covers the rolling last 7 days.
  • Cloudflare GraphQL API — Connects to the Cloudflare GraphQL Analytics API using your API Token.
  • Lightweight & Dependency-Free — No external JavaScript frameworks; charts are CSS-based.
  • Caching — API responses cached via WordPress transients to minimise API calls.

Requirements

  • A Cloudflare account with Web Analytics enabled for your site.
  • A Cloudflare API Token with Account Analytics: Read permission.
  • Your Cloudflare Account ID.
  • Your FlareStats Site Tag (optional but recommended for multi-site accounts).

Configuration

  1. In your Cloudflare dashboard go to My Profile API Tokens and create a token with Account Analytics: Read permission scoped to your account.
  2. Note your Account ID (visible in the Cloudflare dashboard right-hand sidebar).
  3. Go to Analytics & Logs Web Analytics, select your site, and copy the Site Tag from the site settings (optional).
  4. In WordPress go to FlareStats Settings and enter your credentials.

Privacy / Tracking Disclosure

FlareStats displays analytics data inside WordPress by requesting reports from Cloudflare Web Analytics.

What this plugin sends to external services

  • This plugin sends authenticated requests from your WordPress site to the Cloudflare GraphQL API (api.cloudflare.com) using your configured API token, account ID, and site tag (if provided).
  • Request parameters include reporting date ranges and query fields needed to fetch analytics metrics.

What this plugin receives

  • Aggregated analytics data such as pageviews, visits, top pages, top countries, browser/device, and referrer/source metrics.
  • This plugin displays those metrics in the WordPress admin dashboard and analytics screens.

What this plugin stores in WordPress

  • Plugin settings in wp_options (for example API token, account ID, site tag, cache duration).
  • Cached analytics responses in WordPress transients to reduce API calls.

Personal data handling

  • This plugin does not create its own visitor tracking cookies.
  • Visitor analytics collection is performed by Cloudflare Web Analytics on your site.
  • This plugin does not add separate per-visitor profile records in WordPress for analytics.

Data retention / access

  • Cached analytics data is temporary and expires according to the configured cache duration.
  • Plugin settings and analytics screens are only accessible to users with appropriate admin capabilities (for example manage_options).

Third-party policies

  • Cloudflare Privacy Policy: https://www.cloudflare.com/privacypolicy/
  • Cloudflare Terms: https://www.cloudflare.com/website-terms/

Site owners are responsible for ensuring their site’s public privacy policy accurately describes how Cloudflare Web Analytics is used.

安裝

  1. Upload the flarestats directory to /wp-content/plugins/.
  2. Activate the plugin through the Plugins screen in WordPress.
  3. Navigate to FlareStats Settings and enter your Cloudflare credentials.

常見問題

Does this work with free Cloudflare plans?

Yes. FlareStats will work with all plans, since Cloudflare Web Analytics is available on all plans, including the free tier.

Is my API token stored securely?

Your API token is stored in the WordPress wp_options table, the same location used by all plugins that store credentials. Access is restricted to users with the manage_options capability (Administrators only).

How often is data refreshed?

By default, analytics data is cached for 15 minutes. You can adjust this in the Settings page or click Refresh Data on the analytics screen to fetch fresh data immediately.

Do I need to have Web Analytics enabled in Cloudflare?

Yes. This plugin reads Cloudflare Web Analytics (RUM beacon) data. You must have Web Analytics enabled in your Cloudflare dashboard and the JavaScript beacon loading on your site.

What is the Site Tag?

The Site Tag is a unique identifier for your Web Analytics site in Cloudflare. It is optional if your account only has one site, but required (to scope data correctly) if you have multiple sites. You can find it in Analytics & Logs Web Analytics [your site] Manage site Site tag.

評價

There are no reviews for this plugin.

貢獻者及開發者

“FlareStats” 是一個開源的軟體。以下的人對這個外掛作出了貢獻。

貢獻者

將 FlareStats 外掛本地化為台灣繁體中文版。

對開發相關資訊感興趣?

任何人均可瀏覽程式碼、查看 SVN 存放庫,或透過 RSS 訂閱開發記錄

修改日誌

1.0.0

  • Initial release.