🔍 Lion Debug Tools Docs

1 Getting Started

Lion Debug Tools reads WordPress' own debug log and scans your site for common problems, giving you a plain-English overview instead of a raw PHP error log.

1. Install and activate the plugin from Plugins → Add New or upload the ZIP manually.
2. Go to LionWP Debug in your WordPress admin menu.
3. The Overview page summarizes recent errors and site health at a glance.

2 Enabling & Reading the Debug Log

WordPress only writes detailed error logs when debug logging is turned on. If the Debug Log page shows no data, add these lines to your site's wp-config.php (above the "That's all, stop editing!" line):

1. define('WP_DEBUG', true);
2. define('WP_DEBUG_LOG', true);
3. define('WP_DEBUG_DISPLAY', false); - keeps errors out of visitors' view while still logging them

Once enabled, the Debug Log page shows real PHP notices, warnings, and fatal errors as they happen, and lets you clear the log with one click.

3 Debug Scan

The Debug Scan page actively checks your site for common issues - broken plugin/theme files, PHP version compatibility problems, misconfigured permissions, and known problematic patterns - and reports them with a plain explanation of what to fix.

4 Health Check

The Health Check page gives a broader snapshot of your WordPress environment: PHP version, memory limits, active plugin count, and other server-level details that commonly cause hard-to-diagnose issues.

5 Debug Report

The Debug Report page compiles everything - recent log entries, scan results, and environment info - into a single shareable report, useful when asking for support help from a developer or hosting provider.

6 Frequently Asked Questions