Lumiblog Debug Log Inspector

Description

Lumiblog Debug Log Inspector is a powerful quality assurance and debugging tool that monitors your WordPress debug.log file for plugin-specific errors. Unlike other debug tools, it allows you to monitor ANY WordPress plugin through an easy-to-use settings interface – no coding required!

Key Features

• Universal Plugin Monitoring: Add any WordPress plugin to monitor through a simple settings page
• No Code Editing: Add/edit/delete monitored plugins through the WordPress admin interface
• Real-time Monitoring: Automatically scans your debug.log file for errors
• Visual Status Indicators: Color-coded admin bar display (Green = OK, Red = Errors Found, Gray = Debug Logging Disabled)
• Auto-Detection: Option to only monitor plugins that are currently active
• Plugin-Specific Tracking: Individual status for each monitored plugin
• Last Error Display: Shows the most recent error message for quick diagnosis
• Duplicate Prevention: Smart validation prevents adding the same plugin twice
• Enable/Disable Plugins: Toggle monitoring for specific plugins without deleting them
• Lightweight: Minimal performance impact with efficient log reading
• Well-Organized Code: Modular file structure for easy maintenance and customization

Perfect For

• QA Teams testing multiple plugins
• Plugin Developers debugging their own plugins
• WordPress Developers monitoring client sites
• Agency Teams managing multiple WordPress installations
• Anyone who wants to keep track of plugin errors

How It Works

1. Install and activate the plugin
2. Go to Settings > Log Inspector
3. Add any plugin you want to monitor by providing:
   • Plugin Name (e.g., “WooCommerce”)
   • Plugin File Path (e.g., “woocommerce/woocommerce.php”)
   • Search Terms (e.g., “woocommerce, wc-“)
4. Check the admin bar for real-time error status

Requirements

To use this plugin effectively, you need to enable WordPress debug logging by adding these constants to your wp-config.php file:

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );

Testing the Plugin

To verify Lumiblog Debug Log Inspector is working correctly, follow these steps:

Step 1: Enable Debug Logging

Add to your wp-config.php:

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );

Step 2: Add a Plugin to Monitor

1. Go to Settings > Log Inspector
2. Click “Add New Plugin to Monitor”
3. Fill in the form with a plugin you have installed (e.g., WooCommerce)
   • Plugin Name: WooCommerce
   • Plugin File Path: woocommerce/woocommerce.php
   • Search Terms: woocommerce, wc-
4. Click “Add Plugin”

Step 3: Generate a Test Error

Option A – Using a Test Plugin File:

1. Create a simple test plugin in wp-content/plugins/test-error/test-error.php:

   <?php
   /**

   • Plugin Name: Test Error Generator
     */
     if ( isset( $_GET[‘trigger_test_error’] ) ) {
     trigger_error( ‘This is a test error from WooCommerce integration’, E_USER_WARNING );
     }

2. Activate the test plugin

3. Visit: yoursite.com/wp-admin/?trigger_test_error=1
4. Check your admin bar – it should turn RED

Option B – Trigger a Real Error:

1. Temporarily add this line to any active plugin’s main file:
   trigger_error( ‘woocommerce test error for debugging’, E_USER_WARNING );

2. Reload any page in your WordPress admin

3. Remove the line immediately after testing

Step 4: Check the Results

1. Look at the admin bar – “LOG INSPECTOR” should now be RED
2. Click on “LOG INSPECTOR” to see:
   • WooCommerce: ERROR!
   • Last Error: [Your test error message]
3. Go to Settings > Log Inspector to manage monitored plugins

Step 5: View the Debug Log (Optional)

Navigate to wp-content/debug.log to see the actual error entries that were logged.

Clean Up:

1. Remove the test code you added
2. Either delete wp-content/debug.log or clear its contents
3. The admin bar should return to GREEN

Additional Information

Debug Constants

For enhanced debugging, you can also add these optional constants to your wp-config.php:

define( 'SCRIPT_DEBUG', true );
define( 'SAVEQUERIES', true );
define( 'WP_DEBUG_DISPLAY', false ); // Set to false on production sites

For Developers

The plugin is designed to be easily extendable. All classes are well-documented and follow WordPress coding standards. Feel free to fork and customize for your specific needs.

Support

For support, feature requests, or bug reports, please visit the WordPress.org support forums for this plugin.

Contributing

Contributions are welcome! Please visit the plugin’s WordPress.org page for more information.