Debugger & Troubleshooter

The "Debug & 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, similar to the built-in Site Health feature, including PHP version, memory limit, WordPress constants, and active theme/plugin details. Key Features:

• Comprehensive Site Information: Get a quick overview of your WordPress environment, including PHP settings, WordPress version, active theme, active plugins, and important WordPress constants.
• Troubleshooting Mode: Activate a unique "Troubleshooting Mode" for your current browser session. This mode allows you to:
• Simulate Plugin Deactivation: Selectively "deactivate" plugins. The plugin's assets and code will be disabled for your session, mimicking actual deactivation, but the live site remains untouched for other visitors.
• Simulate Theme Switching: Preview any installed theme. Your browser will render the site using the chosen theme, while the public-facing site continues to use the active theme.
• Safe Debugging: All troubleshooting actions are session-based using cookies, ensuring that any changes you make in Troubleshooting Mode do not impact your live website or its visitors. This makes it a safe environment for diagnosing conflicts and issues.
• User-Friendly Interface: An intuitive dashboard interface makes it easy to access site information and manage troubleshooting options.
• Admin Notices: Clear notices alert you when Troubleshooting Mode is active, ensuring you are always aware of your current debugging state.

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.

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

Manual Installation (if needed):

1. Extract the debug-troubleshooter.zip file.
2. Upload the debug-troubleshooter folder (containing debug-troubleshooter.php, assets/css/admin.css, and assets/js/admin.js) to the /wp-content/plugins/ directory via FTP or your hosting's file manager.
3. Activate the plugin through the 'Plugins' menu in WordPress.

1.0.0 – 2025-06-25

• Initial release.
• Added comprehensive Site Information display (PHP, WP, Constants, Server).
• Implemented session-based Troubleshooting Mode for simulated theme switching.
• Implemented session-based Troubleshooting Mode for simulated plugin deactivation.
• Added AJAX handlers for mode toggling and state updates.
• Included admin notices for active troubleshooting sessions.
• Ensured compliance with WordPress.org plugin review guidelines for asset enqueuing and security.

1.1.0 - 2025-07-08

• 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 without taking up too much space.
• Enhancement: Expanded the displayed information for PHP, Server, and WordPress constants to provide more comprehensive data for debugging.
• Fix: Resolved a bug that prevented the collapsible sections from functioning correctly after recent updates.