Title: Debugger &amp; Troubleshooter
Author: Jhimross Olinares
Published: <strong>8 Luglio 2025</strong>
Last modified: 10 Novembre 2026

---

Ricerca i plugin

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

![](https://ps.w.org/debugger-troubleshooter/assets/icon-256x256.png?rev=3323985)

# Debugger & Troubleshooter

 Di [Jhimross Olinares](https://profiles.wordpress.org/jhimross/)

[Scarica](https://downloads.wordpress.org/plugin/debugger-troubleshooter.1.6.0.zip)

 * [Dettagli](https://it.wordpress.org/plugins/debugger-troubleshooter/#description)
 * [Recensioni](https://it.wordpress.org/plugins/debugger-troubleshooter/#reviews)
 *  [Installazione](https://it.wordpress.org/plugins/debugger-troubleshooter/#installation)
 * [Sviluppo](https://it.wordpress.org/plugins/debugger-troubleshooter/#developers)

 [Supporto](https://wordpress.org/support/plugin/debugger-troubleshooter/)

## Descrizione

The “Debugger & Troubleshooter” plugin provides essential tools for WordPress site
administrators to diagnose and resolve issues efficiently. It offers a dedicated
section in the WordPress dashboard that displays comprehensive site health information
and powerful debugging toggles.

**Key Features:**

 * **Troubleshooting Mode:** Activate a unique, **session-based** “Troubleshooting
   Mode” for your current browser session. This means any changes you make are temporary
   and only visible to you. This mode allows you to:
    - **Simulate Plugin Deactivation:** Selectively “deactivate” plugins. The plugin’s
      assets and code will be disabled for your session only.
    - **Simulate Theme Switching:** Preview any installed theme, while the public-
      facing site continues to use the active theme.
 * **User Role Simulator:** View your site as any other user or role (e.g., Subscriber,
   Editor) to test permissions and content visibility. This is session-based and
   includes a safe “Exit” button in the Admin Bar.
 * **Live Debugging:** Start logging PHP errors, warnings, notices and WordPress
   deprecation notices with a single click, without editing `wp-config.php`. Errors
   are logged without being displayed on the site.
 * **Smart Log Viewer:** Repeated errors are grouped with a count, filterable by
   level (Fatal, Warning, Notice, Deprecated, Database) and by source, and searchable.
   Every entry shows which plugin or theme caused it, even when the error is thrown
   inside WordPress core (identified from the stack trace). Includes auto-refresh,
   download and clear.
 * **Performance Profiler:** See why a page is slow. For your own requests only,
   it records load time, memory, a hook timeline, database query time per plugin,
   slow and duplicate queries, external HTTP requests and per-plugin load time. 
   A live summary appears in the admin bar.
 * **Comprehensive Site Information:** Get a quick, organized overview of your WordPress
   environment in collapsible cards. This includes detailed PHP, Database, and Server
   information, a full list of all themes and plugins with their status, and important
   WordPress constants.
 * **Copy to Clipboard:** A one-click button allows you to copy all the site information,
   making it incredibly easy to share with support forums or developers.
 * **SMTP / Mail Debugger:** Send a test email and see the exact error if delivery
   fails.
 * **PHP Compatibility Checker:** Scan WordPress core, your active theme and active
   plugins for deprecated functions and syntax that may break when upgrading PHP.
   Results displayed in a responsive card layout with clear warnings and incompatibility
   counts.
 * **Conflict Checker:** Systematically identify plugin conflicts through a binary
   search process. Narrow down suspect plugins by answering whether each group resolves
   the issue, all within a safe session-based mode.
 * **Safe Debugging & Cache Bypassing:** All troubleshooting actions are session-
   based. The plugin automatically attempts to bypass caching when Troubleshooting
   Mode is active, ensuring your changes are reflected instantly.
 * **User-Friendly Interface:** An intuitive dashboard interface makes it easy to
   access all features.
 * **Admin Notices:** Clear notices alert you when Troubleshooting Mode is active.

This plugin is an invaluable tool for developers, site administrators, and anyone
who needs to debug WordPress issues without risking site downtime or affecting user
experience.

### Usage

Once the plugin is installed and activated, navigate to **Tools > Debugger & Troubleshooter**
in your WordPress dashboard.

### 1. Site Information

The top section provides a comprehensive overview of your WordPress environment,
organized into collapsible cards that are closed by default. Click on any card title
to expand it and view the details.

### 2. Troubleshooting Mode

This session-based feature allows you to simulate theme switches and plugin deactivations
without affecting your live website for other visitors.

### 3. User Role Simulator

Safely view your site as another user or role (e.g., “Subscriber” or “Editor”) without
knowing their password. This is perfect for testing capabilities and content restrictions.

### 4. Live Debugging

Log errors without editing `wp-config.php`.

 * **Enable Live Debug:** Click this button to start logging PHP errors, warnings,
   notices and WordPress deprecation notices to `wp-content/debug.log` (or your 
   custom `WP_DEBUG_LOG` path). Errors are never shown to visitors.
 * **Smart Log Viewer:** Errors are grouped, colour-coded by level and attributed
   to the plugin or theme responsible. Click an entry to see the full message and
   stack trace. Use the level buttons, source dropdown and search box to narrow 
   things down, or switch to the Raw view to see the log as-is. Turn on Auto-refresh
   to watch new errors arrive.
 * **Download / Clear Log:** Save a copy of the full log, or clear it with a click.

### 5. SMTP / Mail Debugger

Send a test email to check your site’s mail configuration. If sending fails, the
exact error is shown.

### 6. Conflict Checker

If you are experiencing an issue on your site, use the Conflict Checker to identify
the culprit plugin. The plugin systematically deactivates groups of plugins using
your session-based Troubleshooting Mode, asking whether the issue persists after
each step. Once the culprit is found, you can deactivate it with one click.

### 7. PHP Compatibility Checker

Check whether WordPress core, your active theme and your active plugins are ready
for a newer PHP version. Select a target version and click “Run Compatibility Check”
to get a report for each item, with clear warnings and incompatibility counts.

### 8. Performance Profiler

Open the **Performance** tab and click **Enable Profiler**. For the next 24 hours,
every request you make (front end, admin, AJAX and REST) is profiled. Visitors and
other users are not affected. A summary (time, queries, memory) appears in the admin
bar; click it to open the full report with the timeline, query time per plugin, 
slowest and duplicate queries, external HTTP requests and plugin load times.

## Screenshot

[⌊The main Debugger & Troubleshooter dashboard showing all feature sections.⌉⌊The
main Debugger & Troubleshooter dashboard showing all feature sections.⌉[

The main Debugger & Troubleshooter dashboard showing all feature sections.

[⌊An expanded view of the Site Information card, showing detailed lists of themes
and plugins.⌉⌊An expanded view of the Site Information card, showing detailed lists
of themes and plugins.⌉[

An expanded view of the Site Information card, showing detailed lists of themes 
and plugins.

[⌊An example of the admin notice when Troubleshooting Mode is active.⌉⌊An example
of the admin notice when Troubleshooting Mode is active.⌉[

An example of the admin notice when Troubleshooting Mode is active.

[⌊The Live Debugging section with the log viewer.⌉⌊The Live Debugging section with
the log viewer.⌉[

The Live Debugging section with the log viewer.

[⌊The User Role Simulator feature to switch to other user.⌉⌊The User Role Simulator
feature to switch to other user.⌉[

The User Role Simulator feature to switch to other user.

[⌊The PHP Compatibility Checker and Conflict Checker tabs.⌉⌊The PHP Compatibility
Checker and Conflict Checker tabs.⌉[

The PHP Compatibility Checker and Conflict Checker tabs.

[[

## Installazione

 1. **Download** the plugin ZIP file.
 2. **Upload** the plugin to your WordPress site:
 3.  * Navigate to **Plugins > Add New** in your WordPress dashboard.
     * Click the “Upload Plugin” button.
     * Choose the downloaded ZIP file and click “Install Now”.
 4. **Activate** the plugin through the ‘Plugins’ menu in WordPress.
 5. Once activated, go to **Tools > Debugger & Troubleshooter** to access the plugin’s
    features.

**Manual Installation (if needed):**

 1. **Extract** the `debugger-troubleshooter.zip` file.
 2. **Upload** the `debugger-troubleshooter` folder to the `/wp-content/plugins/` directory
    via FTP or your hosting’s file manager.
 3. **Activate** the plugin through the ‘Plugins’ menu in WordPress.

## FAQ

### Q: How does Troubleshooting Mode work without affecting my live site?

A: Troubleshooting Mode uses a browser cookie specific to your session. When enabled,
the plugin filters WordPress functions that determine active plugins and themes,
redirecting them to your simulated settings. This happens only for your browser.

### Q: Will this work if I have a caching plugin active?

A: Yes. When Troubleshooting Mode is active, the plugin defines the `DONOTCACHEPAGE`
constant, which instructs most caching plugins and hosting environments to bypass
the cache for your session.

### Q: How does Live Debugging work without editing wp-config.php?

A: WordPress defines `WP_DEBUG` itself before any plugin loads, so no plugin can
change that constant. Instead, Live Debug applies the equivalent PHP settings directly(
full error reporting, logging to `wp-content/debug.log` or your custom `WP_DEBUG_LOG`
path, errors never displayed) and also logs WordPress’s own deprecation and “doing
it wrong” notices. A small must-use plugin loads these settings before other plugins
so their errors are captured too. It is removed automatically when Live Debug is
turned off.

### Q: Does the Performance Profiler slow down my site?

A: Only for you. Profiling runs solely on requests made by the administrator who
enabled it, and switches itself off after 24 hours. Visitors and other users are
never profiled.

### Q: How does the PHP Compatibility Checker work?

A: The checker reads the “Requires PHP” header of WordPress core, your active theme
and active plugins, then scans their PHP files for deprecated functions, incompatible
syntax, and other patterns known to break in newer PHP versions, then reports which
plugins are compatible, have warnings, or are incompatible.

### Q: How does the Conflict Checker work?

A: The Conflict Checker automates plugin conflict identification using a binary 
search — it splits plugins into groups and asks you whether the issue persists after
each test, quickly narrowing down the exact culprit.

## Recensioni

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

### 󠀁[Innovative plugin](https://wordpress.org/support/topic/innovative-plugin-5/)󠁿

 [Anand Upadhyay](https://profiles.wordpress.org/anandau14/) 25 Luglio 2025 2 risposte

This is a very innovative plugin. The functionality of simulating theme switch and
plugin deactivation for current logged in session is amazing. This will be super
useful while debugging live site.

 [ Leggi la recensione di 1 ](https://wordpress.org/support/plugin/debugger-troubleshooter/reviews/)

## Contributi e sviluppo

“Debugger & Troubleshooter” è un software open source. Le persone che hanno contribuito
allo sviluppo di questo plugin sono indicate di seguito.

Collaboratori

 *   [ Jhimross Olinares ](https://profiles.wordpress.org/jhimross/)

“Debugger & Troubleshooter” è stato tradotto in 1 lingua. Grazie a [chi traduce](https://translate.wordpress.org/projects/wp-plugins/debugger-troubleshooter/contributors)
per il contributo.

[Traduci “Debugger & Troubleshooter” nella tua lingua.](https://translate.wordpress.org/projects/wp-plugins/debugger-troubleshooter)

### Ti interessa lo sviluppo?

[Esplora il codice](https://plugins.trac.wordpress.org/browser/debugger-troubleshooter/)
segui il [repository SVN](https://plugins.svn.wordpress.org/debugger-troubleshooter/),
segui il [log delle modifiche](https://plugins.trac.wordpress.org/log/debugger-troubleshooter/)
tramite [RSS](https://plugins.trac.wordpress.org/log/debugger-troubleshooter/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.6.0 – 2026-11-10

 * **Fix (Important):** Live Debug now actually logs errors. Previously it tried
   to define `WP_DEBUG` after WordPress had already defined it, so it had no effect
   on most sites and wrongly reported that `WP_DEBUG` was “already defined as false
   in wp-config.php”.
 * **Feature:** Live Debug also logs WordPress deprecation and `_doing_it_wrong()`
   notices, with the file and line of the plugin or theme responsible.
 * **Feature:** Smart Log Viewer: grouped entries with counts, level and source 
   filters, search, plugin/theme attribution (including from stack traces), expandable
   stack traces, auto-refresh, download and raw view.
 * **Feature:** Performance Profiler: per-request load time, memory, hook timeline,
   query time by plugin, slow and duplicate queries, external HTTP requests (query
   strings redacted) and per-plugin load time, plus a live admin bar summary.
 * **Fix:** The log viewer and Clear Log now use the log file actually in use (a
   custom `WP_DEBUG_LOG` path or PHP’s `error_log` setting) instead of always assuming`
   wp-content/debug.log`.
 * **Fix:** Reading the log no longer scans the whole file; only the last 2 MB is
   read, keeping large logs fast.
 * **Enhancement:** Tabs can be opened directly via URL hash (e.g. `#performance`).

#### 1.5.1 – 2026-10-20

 * **Security Fix (Critical):** Fixed a privilege escalation in the User Role Simulator.
   A simulated low-privilege user could start another simulation for any account,
   including an administrator. Starting a simulation now requires `manage_options`,
   the target user is validated, and tokens are bound to the administrator who created
   them.
 * **Security Fix (High):** Simulation and troubleshooting tokens now expire after
   24 hours, are bound to the creating user, and are cleaned up on uninstall. The“
   Exit Simulation” action now uses a dedicated nonce.
 * **Security Fix (Medium):** The simulated theme is now validated against installed
   themes before Troubleshooting Mode applies it.
 * **Compatibility:** Tested up to WordPress 7.1.
 * **Fix:** Updated the asset cache-busting version and removed the unused `Domain
   Path` header.
 * **Fix:** Live Debug now warns when `WP_DEBUG` is already defined in `wp-config.
   php` and cannot be overridden.
 * **Fix:** Hardened filesystem handling when installing the troubleshooting MU 
   plugin and clearing the debug log.
 * **Fix:** Added translator comments and ordered placeholders; replaced direct 
   filesystem calls with WordPress APIs.

#### 1.5.0 – 2026-06-04

 * **Feature:** Added Plugin Compatibility Checker to scan and report PHP version
   compatibility across all installed plugins.
 * **Feature:** Added Conflict Checker to systematically identify plugin conflicts
   through binary search.
 * **Fix:** Added HTML escaping to all dynamically injected compatibility result
   content.
 * **Fix:** Removed unused `$roles` variable from User Simulation section.

#### 1.4.1 – 2026-05-20

 * **Enhancement:** Tested up to WordPress 7.0.
 * **Feature:** Added “SMTP / Mail Debugger” to test and verify site mail configuration.
 * **Feature:** Captures detailed WP_Error data and PHP environment diagnostics 
   upon mail delivery failure.
 * **Enhancement:** Improved AJAX feedback loops and visual status indicators in
   the dashboard.
 * **Fix:** Resolved minor UI layout issues in the Site Information cards.

#### 1.4.0 – 2026-03-19

 * **Security Fix (Critical):** Resolved a privilege escalation vulnerability where
   unauthenticated users could bypass authentication via the User Simulation feature.
 * **Security Fix (High):** Patched an authorization bypass in the Troubleshooting
   Mode configuration. State is now securely validated against database records 
   using cryptographic tokens.
 * **Security Fix (Medium):** Added strict nonces to the “Exit Simulation” admin
   bar action to prevent Cross-Site Request Forgery (CSRF).
 * **Fix:** Completely overhauled the “Troubleshooting Mode” plugin logic. The plugin
   now correctly intercepts early plugin loading via an automatically dropping MU(
   Must-Use) plugin template, resolving the issue where plugins were not adequately
   disabled during simulations.
 * **Fix:** Disconnected WP_Filesystem API usage from AJAX context actions down 
   to native PHP handlers to prevent silent AJAX failures on servers requiring FTP
   credentials.
 * **Fix:** Adjusted the “Exit Simulation” JavaScript rendering hook to ensure the“
   Exit Simulation” admin bar button functions properly on the front-end.

#### 1.3.2 – 2026-02-11

 * **Fix:** Resolved a UI conflict where the confirmation modal appeared automatically
   upon page load due to CSS class interference from other plugins.
 * **Fix:** Improved modal layering (z-index) to ensure the Success/Error alert 
   modal correctly appears above the confirmation modal.
 * **Fix:** Updated the “Confirm” action in the Debug Log viewer to automatically
   close the confirmation dialog before showing the result, preventing the UI from
   becoming unclickable.
 * **Enhancement:** Hardened the .hidden CSS utility with !important to prevent 
   external themes or plugins from forcing hidden elements to display.

#### 1.3.1 – 2025-11-21

 * **Fix:** Resolved a critical issue where admin scripts were not loading due to
   a hook name mismatch.
 * **Fix:** Addressed WordPress coding standard issues (deprecated functions, security
   hardening).

#### 1.3.0 – 2025-11-21

 * **Feature:** Added “User Role Simulator” to view the site as any user or role
   for the current session.
 * **Enhancement:** Added an Admin Bar “Exit Simulation” button for safe return 
   to the administrator account.
 * **Fix:** Improved layout stability for the troubleshooting dashboard.

#### 1.2.1 – 2025-07-11

 * **Fix:** Addressed all security and code standard issues reported by the Plugin
   Check plugin, including escaping all output and using the `WP_Filesystem` API
   for file operations.
 * **Fix:** Replaced the native browser `confirm()` dialog with a custom modal for
   a better user experience and to prevent potential browser compatibility issues.

#### 1.2.0 – 2025-07-11

 * **Feature:** Added “Live Debugging” section to safely enable/disable `WP_DEBUG`
   and `WP_DEBUG_LOG` from the UI without editing `wp-config.php`.
 * **Feature:** Added a `debug.log` file viewer and a “Clear Log” button to the 
   Live Debugging section.

#### 1.1.1 – 2025-07-10

 * **Fix:** Implemented cache-bypassing measures for Troubleshooting Mode. The plugin
   now defines the `DONOTCACHEPAGE` constant and sends no-cache headers to ensure
   compatibility with most caching plugins and server-side caches.

#### 1.1.0 – 2025-07-09

 * **Feature:** Site Information cards (WordPress, PHP, Database, Server, Constants)
   are now collapsible and closed by default for a cleaner interface.
 * **Feature:** Added a “Copy to Clipboard” button to easily copy all site information
   for support requests or documentation.
 * **Enhancement:** The “WordPress Information” card now displays a detailed list
   of all installed themes and plugins, along with their respective active, inactive,
   or network-active status.
 * **Enhancement:** The theme and plugin lists within the “WordPress Information”
   card are now compact, showing counts by default with a “Show All” toggle to view
   the complete list.
 * **Enhancement:** Expanded the displayed information for PHP, Server, and WordPress
   constants.
 * **Fix:** Resolved a bug that prevented the collapsible sections from functioning
   correctly.

#### 1.0.0 – 2025-06-25

 * Initial release.

## Meta

 *  Versione **1.6.0**
 *  Ultimo aggiornamento **3 giorni fa**
 *  Installazioni attive **90+**
 *  Versione WordPress ** 5.0 o superiore **
 *  Testato fino alla versione **7.1.4**
 *  Versione PHP ** 7.4 o superiore **
 *  Lingue
 * [English (US)](https://wordpress.org/plugins/debugger-troubleshooter/) e [Tagalog](https://tl.wordpress.org/plugins/debugger-troubleshooter/).
 *  [Traduci nella tua lingua](https://translate.wordpress.org/projects/wp-plugins/debugger-troubleshooter)
 * Tag
 * [compatibility](https://it.wordpress.org/plugins/tags/compatibility/)[debug](https://it.wordpress.org/plugins/tags/debug/)
   [developer](https://it.wordpress.org/plugins/tags/developer/)[PHP Info](https://it.wordpress.org/plugins/tags/php-info/)
   [troubleshoot](https://it.wordpress.org/plugins/tags/troubleshoot/)
 *  [Visualizzazione avanzata](https://it.wordpress.org/plugins/debugger-troubleshooter/advanced/)

## Valutazioni

 5 su 5 stelle.

 *  [  1 5- recensioni a stelle     ](https://wordpress.org/support/plugin/debugger-troubleshooter/reviews/?filter=5)
 *  [  0 recensioni a 4-stelle     ](https://wordpress.org/support/plugin/debugger-troubleshooter/reviews/?filter=4)
 *  [  0 recensioni a 3-stelle     ](https://wordpress.org/support/plugin/debugger-troubleshooter/reviews/?filter=3)
 *  [  0 recensioni a 2-stelle     ](https://wordpress.org/support/plugin/debugger-troubleshooter/reviews/?filter=2)
 *  [  0 recensioni a 1-stelle     ](https://wordpress.org/support/plugin/debugger-troubleshooter/reviews/?filter=1)

[La tua recensione](https://wordpress.org/support/plugin/debugger-troubleshooter/reviews/#new-post)

[Vedi tutte le recensioni](https://wordpress.org/support/plugin/debugger-troubleshooter/reviews/)

## Collaboratori

 *   [ Jhimross Olinares ](https://profiles.wordpress.org/jhimross/)

## Supporto

Hai qualcosa da dire? Ti serve aiuto?

 [Chiedi nel forum di supporto](https://wordpress.org/support/plugin/debugger-troubleshooter/)

## Dona

Vuoi supportare lo sviluppo di questo plugin?

 [ Fai una donazione per questo plugin ](https://paypal.me/jhimross28)