=== Debug Tracker by Volade ===
Contributors: volade
Tags: activity log, debug, stack trace, audit, security
Requires at least: 6.0
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

User action timeline with PHP stack traces — hook watchlist, AJAX/REST capture, agency presets and free JSON export.

== Description ==

**Debug Tracker by Volade** records what happens on your WordPress site — logins, content edits, plugin changes, AJAX and REST calls — and attaches a **PHP stack trace** to each event so you can see *where* it came from, not just *what* happened.

Unlike classic activity logs (Stream, Simple History) that stop at “user X updated post Y”, Debug Tracker is built for **developers and agencies** who need forensic detail without juggling Query Monitor on every tab.

= Why Debug Tracker? =

* **Timeline + stack traces** in one lightweight plugin
* **4 capture presets**: Developer, Agency audit, WooCommerce, Security
* **Hook watchlist** with wildcards (`woocommerce_*`, `wp_ajax_*`)
* **AJAX & REST logging** with caller frames
* **Free JSON export** — no Volade account required
* **WP-CLI**: `wp dtb tail`, `wp dtb export`, `wp dtb status`
* **Site Health** test for logging status
* Works **standalone** or inside the Volade menu when the SDK is present

= Volade account (optional) =

* **Free without account**: basic logging, stack traces (5 frames), JSON export
* **Volade connected**: advanced search filters, CSV export, hook watchlist (8 frames)
* **V+ Premium**: long event history, PHP shutdown error capture, multisite rollup

= Complements Query Monitor =

Query Monitor shows live queries and hooks on the current request. Debug Tracker keeps a **persistent audit trail** with stack traces — ideal when a client says “something changed yesterday” and you were not watching the admin bar.

== Installation ==

1. Upload the plugin ZIP via **Plugins → Add New → Upload**
2. Activate **Debug Tracker by Volade**
3. Open **Volade → Debug Tracker** (or **Tools → Debug Tracker**)
4. Apply a preset (Developer recommended) and browse the timeline

== Frequently Asked Questions ==

= Does this replace Stream or Simple History? =

It overlaps on user activity logging but adds **stack traces per event** and developer-oriented presets. Many teams run Debug Tracker alongside Query Monitor for live debugging.

= Is a Volade account required? =

No. Core logging, stack traces and JSON export work without an account.

= Where are events stored? =

In a dedicated database table `{prefix}dtb_events`. Retention is pruned automatically based on your access tier.

= Multisite? =

Yes. V+ Premium adds a network rollup dashboard.

== Screenshots ==

1. Marketing hero — timeline with stack traces
2. Summary cards and capture presets
3. Activity timeline with severity badges
4. Expanded stack trace on AJAX event
5. Capture options and hook watchlist

== Changelog ==

= 1.0.0 =
* Initial release: timeline, stack traces, 4 presets, JSON/CSV export, WP-CLI, Site Health.
