The Lume plugin for WordPress
A drop-in, zero-dependency plugin: no code, reports after the response, never blocks a page load.
Install
1Install the plugin
Upload lume-traffic.zip in Plugins → Add New → Upload Plugin and activate, or drop the file into wp-content/mu-plugins/ for a must-use install.
2Add your ingest token
Go to Settings → Lume Traffic and paste your token. No token ⇒ the plugin serves traffic and reports nothing.
3Set the trusted proxy
On the same screen, set Trusted proxy to match whatever sits in front of WordPress. This is what lets Lume verify that a crawler is authentic.
Good to know
- Reports each front-end request after the response is flushed (via fastcgi_finish_request when available), so it adds no perceived latency and can never break a page load. Uses only the WordPress HTTP API, no dependencies.
- Full-page caches (WP Rocket, Varnish, nginx fastcgi_cache) serve cached HTML without booting PHP, so cached human views aren’t reported: bots and cache misses still are. For complete human coverage on a fully-cached site, use the Cloudflare Worker instead (it sees requests before the cache).
- Front-end only: admin, cron, AJAX, REST, and XML-RPC requests aren’t reported.
Works with the rest of your stack
Lume is CDN-agnostic and server-side. This is one of several install paths, all feeding the same dashboard. Mix and match across hosts, or move providers without losing your history.
WordPress FAQ
Do I need to touch theme or template code?
No. It is a single-file plugin: install it, paste your ingest token, done. It uses only the WordPress HTTP API, with no dependencies.
Why do I have to set a trusted proxy?
Forwarded IP headers can be spoofed by anyone. Naming the proxy that is entitled to set them is what lets Lume trust the visitor IP for verification. Leave it unset behind a CDN and agents show as not verifiable rather than wrong.
Send your first WordPress event in minutes.
Free plan, one ingest token. See every human, bot, and AI agent, however you install.
Start for free →