Common Issues — Statnive Docs

Dashboard Shows Zero Visitors

Cause: The most common reason is a caching plugin serving a cached version of the tracking script endpoint.

Solution: Add Statnive’s collection endpoints (/wp-json/statnive/v1/hit, /wp-json/statnive/v1/event, /wp-json/statnive/v1/engagement) to your caching plugin’s exclusion list. If you use Cloudflare, create a Page Rule to bypass cache for /wp-json/statnive/*.

Visitor Count Seems Too Low

Cause: Statnive uses daily-rotating hashes for visitor identification. If your site has many repeat visitors within the same day, counts should be accurate. If counts seem low, the most likely cause is that an exclusion rule is filtering legitimate traffic.

Solution: Open the Statnive dashboard, go to Settings, and review the Exclusions section. Make sure no logged-in role you actually want to track is in Excluded roles, and that no live IP range sits in Excluded IPs.

Real-Time Counter Not Updating

Cause: The real-time counter relies on the WordPress REST API. Some security plugins block REST API access for non-authenticated users.

Solution: Ensure the endpoint wp-json/statnive/v1/realtime is accessible. Test by visiting the URL directly in your browser while logged in. If you see a JSON response, the endpoint is working. If you see a 403 error, check your security plugin’s REST API settings.

WooCommerce Revenue Report empty after activation

Cause: On a fresh v1.0.0 activation, the historical-orders backfill runs in the background via Action Scheduler. On large stores it can take a few minutes for the Revenue Report to fill in.

Solution: Open WooCommerce → Status → Scheduled Actions and filter by statnive/wc/backfill/chunk. You should see one or more queued or running actions. If you prefer to trigger or monitor it from the CLI, run:

wp statnive woocommerce-backfill

The command is idempotent (re-running while a backfill is in progress returns a 409). Chunk size is 500 orders per Action Scheduler hook; orders in processing, completed, and refunded status are counted. See the WooCommerce integration docs for details.