Debugging
The debug overlay lists every event Pixelonce considered on a page, whether it fired, and — the part that matters — why it did not.
Open the overlay
Add ?stepcount_debug=1 to any URL. On a live host the overlay opens for logged-in administrators only; on a dry-run (staging) host it opens for anyone. The stepcount_debug_allowed filter changes who may open it.
Pixelonce was first developed as StepCount, and the plugin still uses that name in its code: the stepcount_debug URL parameter, the stepcount_* filters and the StepCount JavaScript object. They are the real names; use them as written.
Reading a suppression
scope revisit — reload or re-entry from the same rule (checkout-step-2)That line says: the event is set to once per visit, and the visitor arrived from the same page it was already fired for — so it was a reload or a re-entry, not a new arrival. Other common reasons:
- scope session / visitor / entity — already fired for this session, visitor or value.
- consent — the visitor has not granted consent (or refused it).
- dry run — this host is not in the live-hostnames list; evaluated and logged, not sent.
- sent elsewhere — the event is listed under Events sent elsewhere.
From the browser console
The plugin's JavaScript API is the StepCount object (its original name):
StepCount.context() // visitor and session ids, page key, previous page key, dry-run state
StepCount.log() // every decision made on this pagewp-config.php switches
| Constant | Effect |
|---|---|
STEPCOUNT_ENABLED | false switches all tracking off without deactivating the plugin |
STEPCOUNT_LIVE_HOSTS | comma-separated live hosts; overrides the setting |
STEPCOUNT_FORCE_LIVE | send for real from a non-live host (logged on every request) |
STEPCOUNT_TEST_PIXEL | send every event to this one pixel id instead |
When the template lies
Some templates render a different step than their URL says (a form that advances without changing the query string). The stepcount_request filter lets you correct the path and query Pixelonce matches pages against, so the decision is made on what the visitor actually sees.