Title: CloudScale Site Analytics Author: andrewjbaker Published: June 11, 2026 Last modified: June 11, 2026 --- Search plugins ![](https://ps.w.org/cloudscale-site-analytics/assets/banner-772x250.png?rev=3569115) ![](https://ps.w.org/cloudscale-site-analytics/assets/icon-256x256.png?rev=3569084) # CloudScale Site Analytics By [andrewjbaker](https://profiles.wordpress.org/andrewjbaker/) [Download](https://downloads.wordpress.org/plugin/cloudscale-site-analytics.2.9.373.zip) * [Details](https://wordpress.org/plugins/cloudscale-site-analytics/#description) * [Reviews](https://wordpress.org/plugins/cloudscale-site-analytics/#reviews) * [Installation](https://wordpress.org/plugins/cloudscale-site-analytics/#installation) * [Development](https://wordpress.org/plugins/cloudscale-site-analytics/#developers) [Support](https://wordpress.org/support/plugin/cloudscale-site-analytics/) ## Description CloudScale Site Analytics solves the fundamental problem with page view tracking on cached WordPress sites. When Cloudflare, Fastly, or any CDN serves a cached HTML page, WordPress never executes. Server side counters like Jetpack Stats miss the view entirely, resulting in severe undercounting — typically 5 to 10 times lower than actual traffic. CloudScale uses a lightweight JavaScript beacon that fires after the cached page loads, recording every view through a REST API endpoint that bypasses the CDN cache. The result is accurate view counts regardless of cache status. #### Key Features * Accurate counting behind Cloudflare and other CDNs * Session based deduplication (no double counting on refresh) * IP throttle protection against view inflation attacks * Jetpack Stats one click migration tool * Dashboard widget with hourly, daily, monthly, and 6 month charts * Top Posts and Recent Posts sidebar widgets with pagination * Configurable view counter badge on posts (badge, pill, or minimal style) * Five colour options for the view counter (blue, pink, red, purple, grey) * Admin column showing views on the Posts list * Full statistics page with period comparison and top posts * REST API endpoints for custom integrations * Privacy focused: IP addresses are hashed with wp_salt, never stored raw #### How It Works 1. Cloudflare serves the cached HTML page at full speed 2. The browser loads the page and executes the beacon script 3. The beacon fires a lightweight POST to a WordPress REST endpoint 4. That endpoint bypasses CDN caching via headers and Cloudflare Cache Rules 5. WordPress records the view in the database and increments the counter 6. The page counter updates live without a reload #### Requirements * WordPress 6.0 or higher * PHP 7.4 or higher * A Cloudflare account with Cache Rules (free tier is sufficient) ### External services This plugin optionally connects to the following external services: #### Telegram Bot API (optional, alert notifications only) When you configure Telegram alerts in the plugin settings, the plugin communicates with the Telegram Bot API: * Service URL: https://api.telegram.org/ * What is sent and when: (1) When an admin clicks “Fetch Chat ID”, the plugin calls the getUpdates endpoint with your bot token to discover your chat ID. (2) When an admin clicks “ Send Test” or when a plugin event triggers a notification, the plugin calls sendMessage to deliver the alert text to your configured chat ID. No visitor data, page view analytics, or site content is transmitted — only the admin-authored alert text and your Telegram bot credentials. * This service is only used when an admin has entered a bot token and chat ID in the plugin settings. * Telegram Privacy Policy: https:// telegram.org/privacy * Telegram Terms of Service: https://telegram.org/tos #### DB-IP Lite (optional, geolocation only) IP geolocation is optional. To enable it you click “Download DB-IP Lite” on the plugin’s statistics page, which fetches the free DB-IP City Lite database directly from DB-IP’s servers: * Service URL: https://download.db-ip.com/ * The first download happens only when you explicitly trigger it from the admin panel. After that, while the auto-update option is enabled (it can be turned off on the statistics page), the plugin checks once per month via WP-Cron and downloads a fresh monthly database to keep geolocation accurate. No automatic download ever occurs until you have performed the first download yourself. * What is sent: only the standard HTTP GET request required to fetch the database file. No site, post, or visitor data is transmitted to DB-IP. * DB-IP Privacy Policy: https://db-ip.com/privacy.php * DB-IP Terms of Use: https://db-ip.com/tos.php * The database file is stored locally in your site’s uploads directory after download. #### CartoCDN (optional, geography map tiles only) When the optional DB-IP geolocation feature is enabled and you view the Statistics page, the geography heat-map (powered by Leaflet.js) loads map tile images from CartoCDN: * Service URL: https://basemaps.cartocdn.com/ * When it fires: only when an admin user views the Geography section of the Statistics page and a DB-IP database has been downloaded. Never fires on the public-facing site. * What is sent: standard tile requests (HTTP GET for map image tiles). The request URL includes zoom level and tile coordinates; no site data, post data, or visitor data is transmitted. * CartoCDN Privacy Policy: https://carto.com/privacy/ * CartoCDN Terms of Service: https://carto.com/legal/ No visitor or site data is transmitted to any external service during page view tracking. The JavaScript beacon communicates only with your own site’s REST API endpoint, and view counts never leave your server. ### Third-party libraries The following open-source libraries are bundled with this plugin. The minified production builds are shipped; the full, unminified source for each is available at the linked upstream project, and each is under a GPL-compatible licence: * Chart.js 4.4.1 — MIT License — https://github.com/chartjs/Chart.js/releases/tag/ v4.4.1 * Leaflet 1.9.4 — BSD-2-Clause License — https://github.com/Leaflet/Leaflet/releases/ tag/v1.9.4 * MaxMind DB Reader (PHP) — Apache License 2.0 — https://github.com/maxmind/MaxMind- DB-Reader-php ### License This plugin is free software released under the GPLv2 or later license. Copyright (C) 2026 CloudScale (https://cloudscale.consulting) You may copy, distribute and modify the software as long as you track changes/dates in source files. Any modifications to or software including (via compiler) GPL licensed code must also be made available under the GPL along with build and install instructions. Full license text is included in LICENSE.txt and available at https://www.gnu.org/ licenses/gpl-2.0.html ## Installation 1. Upload the `cloudscale-site-analytics` folder to `/wp-content/plugins/` 2. Activate the plugin in Plugins > Installed Plugins 3. The database table is created automatically on activation 4. Add the Cloudflare Cache Rule (see FAQ) 5. Configure display settings in Tools > CloudScale Site Analytics > Display tab ## FAQ ### What Cloudflare Cache Rule do I need? In the Cloudflare dashboard go to Caching > Cache Rules > Create Rule: * Field: URI Path * Operator: contains * Value: /wp-json/cloudscale-site-analytics/ * Action: Cache Status: Bypass The plugin also sends no cache headers on every REST response, but the Cache Rule is the primary protection. ### How do I migrate from Jetpack Stats? Go to Tools > CloudScale Site Analytics > Migrate Jetpack tab. Click the migration button to import all Jetpack lifetime view counts into CloudScale. The migration preserves your historical totals as a starting point and the plugin blends them with new beacon data during a 28 day transition period. ### Does it work without Cloudflare? Yes. The beacon approach works on any WordPress site. The Cloudflare Cache Rule is only needed if you use Cloudflare caching. Without Cloudflare, the REST endpoint is already accessible and the plugin works out of the box. ### Does refreshing the page count as another view? No. The beacon uses sessionStorage to deduplicate views. Each browser session records only one view per post. A new tab or new session counts as a new view. ### How is visitor privacy protected? IP addresses are hashed using SHA256 combined with your site wp_salt before storage. Raw IP addresses are never written to the database. The IP hash is used only for throttle protection. ## Reviews There are no reviews for this plugin. ## Contributors & Developers “CloudScale Site Analytics” is open source software. The following people have contributed to this plugin. Contributors * [ andrewjbaker ](https://profiles.wordpress.org/andrewjbaker/) [Translate “CloudScale Site Analytics” into your language.](https://translate.wordpress.org/projects/wp-plugins/cloudscale-site-analytics) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/cloudscale-site-analytics/), check out the [SVN repository](https://plugins.svn.wordpress.org/cloudscale-site-analytics/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/cloudscale-site-analytics/) by [RSS](https://plugins.trac.wordpress.org/log/cloudscale-site-analytics/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 2.9.373 * WordPress.org approved release * Admin menu inline style consolidated onto existing enqueue handle * Help documentation screenshots regenerated * All WP.org review findings resolved (Plugin Check, ABSPATH guards, enqueue violations) #### 2.9.218 * Remove Jetpack migration tab and all transition blending logic * All Time Views now sources from beacon log (cspv_views_v2) only, not post meta * Stat cards always show actual tracked views; post_meta fallback removed #### 2.9.94 * Unique visitors tracking with SHA-256 hashed IPs (never stored raw) * Date range swap fix on Statistics page * Geography map robustness improvements * WordPress.org submission hardening: all assets bundled locally, inline style/ script tags replaced with wp_enqueue APIs, uninstall.php added #### 2.9.12 * Site Health v2: complete rewrite — four time windows (1 Day, 7 Days, 28 Days, 90 Days) each with RAG indicator and prior-period comparison * Insufficient Data gating: buckets without enough history show waiting state instead of misleading percentages * Site Health results cached in wp_options for 1 hour #### 2.9.11 * Site Health panel on dashboard widget and Statistics page with red/amber/green indicators * Traffic Growth and Hot Pages metrics across 7d, 30d, 90d windows #### 2.9.10 * Post History tab on Statistics page: search any post and see full diagnostics including log count, Jetpack imported count, and 90-day chart #### 2.9.9 * View Diagnostics debug panel on singular posts (admin only) with resync button #### 2.9.0 * Flattened plugin structure — all files in plugin root for reliable FTP/cPanel upgrades * Deactivation hook cleans stale subdirectories from pre-2.9.0 installs #### 2.8.7 * Dedup toggle persistence fix: switched to yes/no string storage #### 2.8.5 * View Deduplication settings UI with configurable window (1h–48h) #### 2.8.4 * Dashboard widget referrers now has Sites/Pages toggle #### 2.8.3 * Statistics page referrers Sites/Pages toggle with clickable full URLs #### 2.8.2 * Dashboard widget shows top 3 pages and top 3 referrers in side-by-side columns #### 2.8.1 * Referrer tracking fixed: REST API now captures document.referrer from beacon body #### 2.8.0 * Client-side dedup switched to localStorage with 24h TTL * Server-side dedup: IP hash + post ID within configurable window #### 2.7.0 * Fixed trending count exceeding lifetime total display bug #### 2.6.9 * Both widgets now have configurable date/view count colours with colour picker #### 2.6.2 * Fail2Ban second-tier protection: permanently blocks IPs exceeding configurable page limit #### 2.4.0 * All Time banner on Statistics page with lifetime totals * All Time Top Posts panel #### 2.3.0 * Tracking filter: configurable post type filter for beacon recording * Recent Posts widget (CloudScale: Recent Posts) #### 2.2.0 * Auto-display of view counter on single posts with no theme editing required * Display settings: position, post type, icon, suffix, style #### 2.1.0 * Top Posts sidebar widget (CloudScale: Top Posts) with pagination and thumbnail support #### 1.1.0 * Live Statistics dashboard under Tools > Page Views * SHA-256 + wp_salt IP hashing for privacy * Cache-bypass headers on REST endpoint #### 1.0.0 * Initial release: JavaScript beacon, post meta view counter, REST endpoint, admin column #### 2.5.4 * Stats page shows all recorded data regardless of tracking filter * REST endpoint enforces post type tracking filter * Badge colour options: blue, pink, red, purple, grey * Two layer view deduplication: client side (localStorage, 24h TTL) and server side (IP + post, 24h window) * View counter positioned above post title * Display settings moved into main Tools page as Display tab * Database auto upgrade for missing columns * Admin bypass for IP throttle during testing * Two column grid layout for Top Posts widget on desktop * Dashboard widget colours changed from pink to green * Transition period logic for Jetpack migration blending * Jetpack Stats one click migration tool ## Meta * Version **2.9.373** * Last updated **16 hours ago** * Active installations **Fewer than 10** * WordPress version ** 6.0 or higher ** * Tested up to **7.0** * PHP version ** 7.4 or higher ** * Tags * [analytics](https://wordpress.org/plugins/tags/analytics/)[page views](https://wordpress.org/plugins/tags/page-views/) [statistics](https://wordpress.org/plugins/tags/statistics/)[View Counter](https://wordpress.org/plugins/tags/view-counter/) * [Advanced View](https://wordpress.org/plugins/cloudscale-site-analytics/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/cloudscale-site-analytics/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/cloudscale-site-analytics/reviews/) ## Contributors * [ andrewjbaker ](https://profiles.wordpress.org/andrewjbaker/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/cloudscale-site-analytics/)