Description
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
- In your Cloudflare dashboard go to My Profile API Tokens and create a token with Account Analytics: Read permission scoped to your account.
- Note your Account ID (visible in the Cloudflare dashboard right-hand sidebar).
- Go to Analytics & Logs Web Analytics, select your site, and copy the Site Tag from the site settings (optional).
- 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.
Installation
- Upload the
flarestatsdirectory to/wp-content/plugins/. - Activate the plugin through the Plugins screen in WordPress.
- Navigate to FlareStats Settings and enter your Cloudflare credentials.
FAQ
-
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_optionstable, the same location used by all plugins that store credentials. Access is restricted to users with themanage_optionscapability (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.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“FlareStats” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “FlareStats” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.0
- Initial release.
