# WordPress Debug Tracker checklist
## Volade — practical guide · June 2026

Print this page or check items as you go.

---

## Phase 0 — Framing (before production activation)

- [ ] Documented goal: incident / client audit / WooCommerce debug / security
- [ ] Preset chosen: Developer / Agency audit / WooCommerce / Security
- [ ] Team briefed: who reads the timeline, who exports JSON
- [ ] Ignored users configured (internal agency accounts): __________
- [ ] Retention understood: 100 events no account · 2,000 connected · 50,000 V+

---

## Phase 1 — Install & preset

- [ ] Debug Tracker by Volade installed on **staging** first (or prod if urgent incident)
- [ ] One-click preset applied: __________
- [ ] Capture enabled (`enabled` = yes)
- [ ] Hook watchlist reviewed (Developer / WooCommerce preset if needed)
- [ ] First event visible in **Timeline** within 5 min

---

## Phase 2 — Investigation

- [ ] Category / severity / user filters tested
- [ ] Stack trace opened on suspect event
- [ ] AJAX or REST correlation identified (action or route)
- [ ] `plugin_activated` / `theme_switched` event spotted if recent change
- [ ] JSON export archived: `/client-debug/[date]-dtb.json`

---

## Phase 3 — Resolution & deliverable

- [ ] Root cause documented (plugin, theme, user, hook)
- [ ] Fix applied on staging then production
- [ ] Timeline rechecked — no critical events remain
- [ ] Client report: who / what / when / stack summary
- [ ] Preset switched to **Agency audit** or **Security** post-incident if too noisy

---

## Phase 4 — Volade stack (optional)

- [ ] **[Plugin Usage Detector](https://volade.com/en/cms/wordpress/extensions/plugin-usage-detector-by-volade)** if suspect plugin deactivated
- [ ] **[PHP Compatibility Checker](https://volade.com/en/cms/wordpress/extensions/php-compatibility-checker-by-volade)** if PHP error captured (V+)
- [ ] **[Heartbeat Control Manager](https://volade.com/en/cms/wordpress/extensions/heartbeat-control-manager-by-volade)** if recurring AJAX noise
- [ ] **Query Monitor** as complement for live SQL queries (slow page)

---

## If something goes wrong

| Symptom | Lead |
|---------|------|
| Empty timeline | Capture disabled or user in ignored_users |
| Too many events | Agency or Security preset · disable log_options |
| Stack too short | Volade connected account (8 frames) or V+ (12 frames) |
| Mysterious checkout failure | WooCommerce preset + filter category `ajax` |

---

volade.com/en/blog · Debug Tracker by Volade