Title: DebugZen
Author: Parag Das
Published: <strong>Ọwẹ́wẹ̀  6, 2026</strong>
Last modified: Ọwẹ́wẹ̀  8, 2026

---

Ṣàwárí àwọn plugin

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

![](https://ps.w.org/debugzen/assets/icon.svg?rev=3686903)

# DebugZen

 Láti ọwọ́ [Parag Das](https://profiles.wordpress.org/parag44/)

[Ṣe ìgbàsílẹ̀](https://downloads.wordpress.org/plugin/debugzen.1.1.1.zip)

 * [Àwọn àlàyé](https://yor.wordpress.org/plugins/debugzen/#description)
 * [Àwọn àgbéyẹ̀wò](https://yor.wordpress.org/plugins/debugzen/#reviews)
 *  [Ìgbéwọlẹ̀](https://yor.wordpress.org/plugins/debugzen/#installation)
 * [Ìdàgbàsókè](https://yor.wordpress.org/plugins/debugzen/#developers)

 [Ìrànlọ́wọ́](https://wordpress.org/support/plugin/debugzen/)

## Àpèjúwe

DebugZen is the ultimate developer tool for WordPress troubleshooting. It gives 
administrators a powerful, focused dashboard screen for managing WordPress debugging
settings and diagnosing fatal errors, warnings, and notices in real time.

If you have ever struggled with finding the `debug.log` file, or if you need an 
intuitive error log viewer right inside your WordPress admin area, DebugZen makes
it effortless to monitor your siteÌtumọ̀ Yorùbá: ’s health and troubleshoot issues
without relying on FTP or SSH.

The plugin uses the battle-tested WP Config Transformer library to read, add, and
update these constants in `wp-config.php`:

 * `WP_DEBUG`
 * `WP_DEBUG_LOG`
 * `WP_DEBUG_DISPLAY`

DebugZen does not use fragile regex or string replacement to modify configuration
constants.

### Diagnostic Log Viewer & Smart Log Grouping

Instead of raw, unformatted text files that consume excessive memory, DebugZen provides
a structured, searchable diagnostic interface:

 * **Smart Log Grouping**: Automatically consolidates repeated identical errors 
   into single cards with occurrence counts and first/last seen timestamps.
 * **Source Code Context**: Expandable preview showing the exact lines of code surrounding
   an error, complete with line numbers, error highlighting, and a direct “View 
   in Editor” jump action.
 * **Severity Filtering & Search**: Instant debounced search and filtering across
   Fatal Errors, Warnings, Notices, Deprecations, and stack traces.
 * **Real-Time Live Tail**: High-performance streaming that reads newly appended
   log bytes using byte offsets without polling full files or exhausting PHP memory.
 * **Log Rotation & Size Management**: Monitor debug log size with visual thresholds,
   automatic truncation, or timestamped archival rotation.
 * **Secure Management**: Restrict every action to administrators with `manage_options`,
   protected by nonces and server-signed HMAC authentication.
 * **Zero External Dependencies**: Operates 100% locally with no telemetry, tracking,
   or remote CDNs.

#### Third-party libraries

DebugZen includes WP Config Transformer by the WP-CLI Development Group. It is distributed
under the MIT License. Its license is included at `vendor/wp-cli/wp-config-transformer/
LICENSE`.

This plugin does not contact external services, collect telemetry, or load remote
executable code.

## Àwọn àwòrán ìbòjú

[⌊The DebugZen diagnostic dashboard with smart log grouping, severity filtering,
and live summary cards.⌉⌊The DebugZen diagnostic dashboard with smart log grouping,
severity filtering, and live summary cards.⌉[

The DebugZen diagnostic dashboard with smart log grouping, severity filtering, and
live summary cards.

[⌊The multi-tab Settings modal for managing WP_DEBUG constants, log rotation thresholds,
and viewer preferences.⌉⌊The multi-tab Settings modal for managing WP_DEBUG constants,
log rotation thresholds, and viewer preferences.⌉[

The multi-tab Settings modal for managing WP_DEBUG constants, log rotation thresholds,
and viewer preferences.

## Ìgbéwọlẹ̀

 1. Upload the `debugzen` folder to `/wp-content/plugins/`, or install the plugin ZIP
    from Plugins > Add New > Upload Plugin.
 2. If installing from source without the bundled `vendor` directory, run `composer
    install --no-dev --optimize-autoloader` inside the plugin directory.
 3. Activate DebugZen through the Plugins screen in WordPress.
 4. Open Tools > DebugZen.
 5. Ensure `wp-config.php` is writable before saving changes. Restore restrictive permissions
    after configuration if required by your hosting environment.

## FAQ

### Does the plugin directly edit debug constants with string replacement?

No. It uses WP Config Transformer to locate, read, add, and update debug constants
safely via AST tokenization.

### Why can I not save settings?

The plugin must be able to read and write `wp-config.php`. File ownership, permissions,
or host-level restrictions may prevent changes.

### Where is the debug log?

By default, WordPress writes the log to `wp-content/debug.log`. If `WP_DEBUG_LOG`
contains a custom path, DebugZen uses that path.

### How does Source Code Preview stay secure?

Source code inspection is protected by server-signed HMAC tokens, strict path traversal
checks, canonical realpath validation confined to the WordPress installation, and
explicit blacklists for `wp-config.php` and dotfiles. Files are never executed.

### Does DebugZen send data anywhere?

No. DebugZen has no telemetry, analytics, external API connection, or remote code
loading.

## Àwọn àgbéyẹ̀wò

Kò sí àwọn àgbéyẹ̀wò fún plugin yìí.

## Àwọn Olùkópa & Olùgbéejáde

“DebugZen” jẹ́ ètò ìṣàmúlò orísun ṣíṣí sílẹ̀. Àwọn ènìyàn wọ̀nyí ti ṣe ìkópa sí 
plugin yìí.

Àwọn Olùkópa

 *   [ Parag Das ](https://profiles.wordpress.org/parag44/)

[Túmọ̀ “DebugZen” sí èdè rẹ.](https://translate.wordpress.org/projects/wp-plugins/debugzen)

### Ṣe o nífẹ̀ẹ́ sí ìdàgbàsókè?

[Ṣàwárí koodu](https://plugins.trac.wordpress.org/browser/debugzen/), ṣàyẹ̀wò [ibi ìpamọ́ SVN](https://plugins.svn.wordpress.org/debugzen/),
tàbí ṣe àgbékalẹ̀ sí [àkọsílẹ̀ ìdàgbàsókè](https://plugins.trac.wordpress.org/log/debugzen/)
nípasẹ̀ [RSS](https://plugins.trac.wordpress.org/log/debugzen/?limit=100&mode=stop_on_copy&format=rss).

## Àkọsílẹ̀ àwọn àyípadà

#### 1.1.1

 * Bumped ‘Tested up to’ tag to 7.1.

#### 1.1.0

 * Major feature release introducing an interactive diagnostic log viewer, smart
   log grouping, and source code context preview.
 * Added Admin Toolbar quick link: Instant access to the DebugZen dashboard from
   anywhere in WordPress for users with manage_options capability.
 * Enhanced Visual Hierarchy: Redesigned log cards with intuitive color-coded severity
   indicators (Fatal Errors, Warnings, Notices, Deprecated) for quick scanning.
 * Added Smart Log Grouping: automatically consolidates repeated identical log entries
   into a single card with occurrence counts and first/last seen timestamps.
 * Added Log Grouping setting under Settings > Advanced (enabled by default) with
   real-time Live Tail duplicate merging.
 * Added Source Code Context preview around reported error lines with lazy loading,
   line number gutter, and error line highlight.
 * Added secure “View in Editor” action opening the WordPress Plugin/Theme file 
   editor directly positioned at the error line.
 * Added configurable context window setting (3, 5, 8, 10 lines) in Settings > Advanced.
 * Added dedicated log parser recognizing Fatal Errors, Warnings, Notices, Deprecations,
   and stack traces.
 * Added server-side debounced search, severity filtering, and memory-conscious 
   pagination.
 * Added high-performance Live Tail with byte-offset tracking to prevent server 
   memory spikes.
 * Added Log Size management with visual limit progress indicators and automatic
   truncation or timestamped rotation.
 * Added multi-tab Settings modal for General, Log Rotation, and Advanced options.
 * Added clean uninstallation routine (uninstall.php) removing plugin options.
 * Added server-signed HMAC authentication and strict path traversal protection 
   for source code preview.
 * Added secure Download Log and Copy Path actions.

#### 1.0.0

 * Initial release.
 * Added secure controls for `WP_DEBUG`, `WP_DEBUG_LOG`, and `WP_DEBUG_DISPLAY`.
 * Added a memory-conscious debug-log viewer and secure clear-log action.
 * Added WP Config Transformer integration.

## Àkójọpọ̀ Meta

 *  Ẹ̀yà **1.1.1**
 *  Ìgbàgbọ́hùn tó kẹ́yìn **ọjọ́ 2 sẹ́yìn**
 *  Àwọn ìgbéwọlẹ̀ tó ṣiṣẹ́ **Tó kéré sí 10**
 *  Ẹ̀yà WordPress ** 5.8 tàbí ju bẹ́ẹ̀ lọ **
 *  Dánwò dé **7.1**
 *  Ẹ̀yà PHP ** 7.4 tàbí ju bẹ́ẹ̀ lọ **
 *  Èdè
 * [English (US)](https://wordpress.org/plugins/debugzen/)
 * Àwọn àmì
 * [debug](https://yor.wordpress.org/plugins/tags/debug/)[Debug log](https://yor.wordpress.org/plugins/tags/debug-log/)
   [error log](https://yor.wordpress.org/plugins/tags/error-log/)[troubleshooting](https://yor.wordpress.org/plugins/tags/troubleshooting/)
   [wp-config](https://yor.wordpress.org/plugins/tags/wp-config/)
 *  [Ìwòye Tó Péye](https://yor.wordpress.org/plugins/debugzen/advanced/)

## Àwọn ìbò

Kò sí ìwádìí tí a tíì fi ránṣẹ́.

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

[Wo gbogbo àwọn àgbéyẹ̀wò](https://wordpress.org/support/plugin/debugzen/reviews/)

## Àwọn Olùkópa

 *   [ Parag Das ](https://profiles.wordpress.org/parag44/)

## Ìrànlọ́wọ́

Nǹkan wà tí o fẹ́ sọ? Ṣé o nílò ìrànlọ́wọ́?

 [Wo àpéjọ ìrànlọ́wọ́](https://wordpress.org/support/plugin/debugzen/)