=== FlareStats === Contributors: jinaldesai Donate Link: https://arisewp.com/ Tags: cloudflare, analytics, dashboard, pageviews, statistics Requires at least: 5.9 Tested up to: 6.9 Requires PHP: 7.4 Stable tag: 1.0.0 License: GPL-2.0-or-later License URI: https://www.gnu.org/licenses/gpl-2.0.html Display CloudFlare Web Analytics data — pageviews, visitors, top pages and top countries — right in your WordPress admin. == 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](https://cloudflare.com) 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. == Installation == 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. == Frequently Asked Questions == = 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**. == Screenshots == 1. Dashboard widget showing a 7-day summary of pageviews and unique visitors. 2. Full analytics page with daily chart, top 5 pages, and top 3 countries. 3. Settings page showing the API token and account ID fields. == Changelog == = 1.0.0 = * Initial release. == Upgrade Notice == = 1.0.0 = Initial release.