Title: Traffic Warden
Author: Hammad Meer
Published: <strong>September 23, 2026</strong>
Last modified: September 23, 2026

---

Search plugins

![](https://ps.w.org/traffic-warden/assets/banner-772x250.png?rev=3711878)

![](https://ps.w.org/traffic-warden/assets/icon-256x256.png?rev=3711878)

# Traffic Warden

 By [Hammad Meer](https://profiles.wordpress.org/hammadfarooqmeer/)

[Download](https://downloads.wordpress.org/plugin/traffic-warden.2.0.0.zip)

 * [Details](https://wordpress.org/plugins/traffic-warden/#description)
 * [Reviews](https://wordpress.org/plugins/traffic-warden/#reviews)
 *  [Installation](https://wordpress.org/plugins/traffic-warden/#installation)
 * [Development](https://wordpress.org/plugins/traffic-warden/#developers)

 [Support](https://wordpress.org/support/plugin/traffic-warden/)

## Description

Traffic Warden provides a native administration dashboard for local diagnostics.
Historical recording is disabled on activation; live inspection is enabled by default
for authorized accounts. Administrators choose recording scope, retention, body 
capture and access permissions.

Features include searchable captures, incoming/outgoing correlation, caller attribution,
sanitized JSON/form bodies, SQL timing and duplicate groups, shutdown fatal PHP 
errors, short-lived targeted capture, pagination and bounded cleanup.

Live Inspector adds an optional WordPress toolbar and lazy React dock with 17 current-
request panels. Live inspection is enabled by default for authorized accounts on
supported administration and frontend pages. Site and account settings can disable
it; existing saved choices are preserved on upgrade. Live snapshots are private 
to the current account/session/site, expire after ten minutes and do not enable 
historical recording. Captured contents are not embedded in page markup or saved
to browser storage. Admission and reads are bounded; delayed cleanup can delay physical
removal after expiry. No second plugin or database drop-in is installed. Readable
source is included; this readme describes activation and privacy.

Hook occurrence/registration inspection, a shared-origin timeline, sanitized JSON/
HAR/SQL/body exports, POSIX cURL copying, CIDR/proxy rules, restricted redaction
patterns, audit records, saved scopes, local sharing, comparison, component reports,
regression review and permission-protected WP-CLI commands are included. Callback
execution timings remain unavailable. HAR network phases are explicitly marked as
projections. Saved scopes never bypass capture retention.

Advanced replay is disabled by default and limited to explicitly confirmed safe-
method public HTTPS requests on staging with an exact hostname allowlist. Synthetic
EXPLAIN is limited to a restricted read-only grammar and a MariaDB per-statement
timeout adapter. No captured SQL is automatically executed and redacted credentials
are never reconstructed.

Database timings require SAVEQUERIES to be explicitly enabled outside this plugin.
Detailed database and stack collection requires WP_DEBUG when the production guard
is enabled. Traffic Warden does not enable global query logging itself.

Capture starts after plugins load. Cached pages that bypass PHP, earlier bootstrap
events and browser-side requests are outside coverage. General page output is not
buffered; structured REST responses and WordPress HTTP API responses can be captured
when body capture is enabled. Missing data is labelled explicitly.

Privacy: diagnostic data stays in this site’s database. No analytics or external
service is contacted by the plugin. Bodies are off by default. Known credentials,
SQL literals and common personal-data keys are removed before storage, but diagnostic
content can still contain personal data. Restrict access and capture scope, and 
purge data after debugging. Retention defaults to seven days, 5,000 request rows
and a 250 MB admission budget. WP-Cron performs bounded cleanup; delayed cron may
delay physical removal. Deactivation stops collection. Uninstall retains data unless
the administrator enabled deletion.

Author: Hammad Farooq Meer – https://hammadmeer.netlify.app

PHP diagnostics in 2.0.0 observe eligible fatal errors at shutdown after the collector
starts. Nonfatal warnings, notices and deprecations are not intercepted. No error
handler or reporting mask is installed or changed. A zero count does not prove absence
of errors.

## Screenshots

[[

[[

[[

[[

[[

## Installation

 1. Upload the traffic-warden directory to wp-content/plugins, or install the release
    ZIP through Plugins > Add New.
 2. Activate Traffic Warden.
 3. Open Traffic Warden > Settings and select a recording mode before enabling capture.
 4. Reproduce the issue, inspect the capture, and disable recording when finished.

#### Upgrading from an earlier name

Deactivate the older plugin before activating Traffic Warden. Do not delete its 
data. Under Tools > Traffic Warden migration, copy retained history in batches or
start with empty history while keeping settings and account opt-outs. Back up the
database first. Migration never copies live snapshots or access tickets. Alternatively
run wp traffic-warden migrate –user= (add –url for each multisite site). New integrations
use traffic-warden/v1 and traffic_warden_* hooks; older aliases are not registered.

## FAQ

### Why are database timings unavailable?

Enable SAVEQUERIES in your own development configuration and enable database diagnostics
in the plugin. Query logging has memory overhead independent of this plugin’s bounded
buffers.

### Does a zero count prove nothing happened?

No. Check collector availability, coverage, sampling and dropped-event indicators.

### How is source provided?

Readable TypeScript and CSS are in admin/src. The release includes build manifests
and instructions in BUILD.txt. WordPress supplies React and the WordPress JavaScript
APIs. Fonts are bundled locally under the SIL Open Font License.

## Reviews

![](https://secure.gravatar.com/avatar/b8f094a5fb6492c438fd375e1eb33397c6f5bf178bc2b7cefe0cde33aa3cd812?
s=60&d=retro&r=g)

### 󠀁[Great plugin for debugging](https://wordpress.org/support/topic/great-plugin-for-debugging-4/)󠁿

 [Abdullah Sarfraz](https://profiles.wordpress.org/abdullah6179/) September 26, 
2026

Easy to set up, shows requests and queries clearly, and saves a lot of troubleshooting
time. Highly recommend

 [ Read all 1 review ](https://wordpress.org/support/plugin/traffic-warden/reviews/)

## Contributors & Developers

“Traffic Warden” is open source software. The following people have contributed 
to this plugin.

Contributors

 *   [ Hammad Meer ](https://profiles.wordpress.org/hammadfarooqmeer/)

[Translate “Traffic Warden” into your language.](https://translate.wordpress.org/projects/wp-plugins/traffic-warden)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/traffic-warden/), check
out the [SVN repository](https://plugins.svn.wordpress.org/traffic-warden/), or 
subscribe to the [development log](https://plugins.trac.wordpress.org/log/traffic-warden/)
by [RSS](https://plugins.trac.wordpress.org/log/traffic-warden/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 2.0.0

 * Complete Traffic Warden identity, traffic-warden text domain, API and package.
 * Removed custom nonfatal PHP-error capture and all error_reporting calls.
 * PHP diagnostics now cover eligible shutdown fatal errors only; warnings, notices
   and deprecations are not collected.
 * New isolated storage and explicit legacy migration; old plugin data is not deleted.
 * Updated investigator artwork and retained private live inspection defaults.

#### 1.0.0

 * Renamed to TraceSleuth – Request Diagnostics with the tracesleuth slug and text
   domain.
 * Updated dashboard, toolbar, API routes, CLI command and supplied logo.
 * Preserved existing captures, settings and account preferences from development
   releases.
 * Corrected readme author encoding and submission metadata.

#### 0.10.2

 * Fixed single-site deactivation and uninstall calling multisite-only functions.
 * Restore the original site after network deactivation cleanup, including exceptional
   exits.
 * Explicitly restrict recorder site switching to multisite.

#### 0.10.1

 * Removed the unexpected root Markdown guide from the production package.
 * Enabled live inspection by default for authorized accounts, preserving saved 
   opt-outs.
 * Replaced generic loaders with panel-specific skeleton layouts.

#### 0.10.0

 * Integrated private Live Inspector toolbar and lazy React dock with 17 diagnostic
   panels.
 * Per-account opt-in, ten-minute snapshots, session isolation and bounded collectors.
 * Developer timers/logs, lifecycle, assets, language, transient and capability 
   observations.
 * Independent live and history policies; no additional plugin or database drop-
   in.

#### 0.3.0

 * Initial local request, HTTP, database and PHP diagnostic implementation.

#### 0.9.0

 * Added hooks, timeline, portable traces, advanced policy, audit, local sessions,
   comparison, reports and CLI workflows.
 * Added bounded structured text, concurrent admission checks and multisite lifecycle
   coverage.

## Meta

 *  Version **2.0.0**
 *  Last updated **3 days ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.6 or higher **
 *  Tested up to **7.1.2**
 *  PHP version ** 8.1 or higher **
 * Tags
 * [database](https://wordpress.org/plugins/tags/database/)[debugging](https://wordpress.org/plugins/tags/debugging/)
   [developer](https://wordpress.org/plugins/tags/developer/)[diagnostics](https://wordpress.org/plugins/tags/diagnostics/)
   [http](https://wordpress.org/plugins/tags/http/)
 *  [Advanced View](https://wordpress.org/plugins/traffic-warden/advanced/)

## Ratings

 5 out of 5 stars.

 *  [  1 5-star review     ](https://wordpress.org/support/plugin/traffic-warden/reviews/?filter=5)
 *  [  0 4-star reviews     ](https://wordpress.org/support/plugin/traffic-warden/reviews/?filter=4)
 *  [  0 3-star reviews     ](https://wordpress.org/support/plugin/traffic-warden/reviews/?filter=3)
 *  [  0 2-star reviews     ](https://wordpress.org/support/plugin/traffic-warden/reviews/?filter=2)
 *  [  0 1-star reviews     ](https://wordpress.org/support/plugin/traffic-warden/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/traffic-warden/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/traffic-warden/reviews/)

## Contributors

 *   [ Hammad Meer ](https://profiles.wordpress.org/hammadfarooqmeer/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/traffic-warden/)