An open API service indexing awesome lists of open source software.

https://github.com/pekarskyi/ip-debug-log-viewer

A powerful WordPress debugging tool that displays PHP errors from debug.log in a structured, user-friendly format
https://github.com/pekarskyi/ip-debug-log-viewer

debug debugging-tool script wordpress

Last synced: 2 months ago
JSON representation

A powerful WordPress debugging tool that displays PHP errors from debug.log in a structured, user-friendly format

Awesome Lists containing this project

README

          

# IP Debug Log Viewer

[![GitHub release (latest by date)](https://img.shields.io/github/v/release/pekarskyi/ip-debug-log-viewer?style=for-the-badge)](https://GitHub.com/pekarskyi/ip-debug-log-viewer/releases/)

A powerful WordPress debugging tool that displays PHP errors from debug.log in a structured, user-friendly format.

## Features

- **Organized Error Display**: Shows errors from debug.log in a clean, organized table format
- **Error Grouping**: Automatically groups similar errors to reduce clutter
- **Color-coded Errors**: Different error types (Fatal, Warning, Notice, etc.) are color-coded for quick identification
- **Fatal Error Highlighting**: Fatal errors are prominently displayed in bright red
- **Component Detection**: Automatically identifies which plugin, theme, or core component is causing the error
- **WordPress Debug Status**: Displays the current state of WordPress debugging settings with colored indicators
- **Server Environment Information**: Displays detailed information about your WordPress, PHP, and database configuration
- **Plugins List**: Shows all installed plugins with their versions and activation status
- **Themes List**: Shows all installed themes with their versions and activation status
- **Error Log Clearing**: One-click button to clear the debug.log file

## ✅ Screenshots
![https://github.com/pekarskyi/assets/raw/master/ip-debug-log-viewer/ip-debug-log-viewer_log_1-0.jpg](https://github.com/pekarskyi/assets/raw/master/ip-debug-log-viewer/ip-debug-log-viewer_log_1-0.jpg)

![https://github.com/pekarskyi/assets/raw/master/ip-debug-log-viewer/ip-debug-log-viewer_list-themes_1-0.jpg](https://github.com/pekarskyi/assets/raw/master/ip-debug-log-viewer/ip-debug-log-viewer_list-themes_1-0.jpg)

![https://github.com/pekarskyi/assets/raw/master/ip-debug-log-viewer/ip-debug-log-viewer_log_status-debag_1-0.jpg](https://github.com/pekarskyi/assets/raw/master/ip-debug-log-viewer/ip-debug-log-viewer_log_status-debag_1-0.jpg)

## Installation

### Option 1:

1. Download the `IP Debug Log Viewer` (green Code button - Download ZIP).

2. **Upload Files**:
- Upload `ip-debug-viewer.php` to your WordPress site's root directory (where wp-config.php is located)

3. **Verify Permissions**:
- Make sure the file has the proper permissions (usually 644)

4. **Activate Debug Mode**:
- Ensure WordPress debugging is enabled in your `wp-config.php` file:
```php
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
define('WP_DISABLE_FATAL_ERROR_HANDLER',true);
```

4. **Access the Viewer**:
- Visit `https://your-site.com/ip-debug-viewer.php` directly

### Option 2 (recommended):

1. Install and activate this plugin (plugin installer): https://github.com/pekarskyi/ip-installer
2. Using the `IP Installer` plugin, install `IP Debug Log Viewer`.

## After debugging

1. Remove the `ip-debug-viewer.php` file.

2. In the `wp-config.php` file, change `define('WP_DEBUG', true);` to `define('WP_DEBUG', false);`.

3. Delete the `debug.log` file located in the `wp-content` folder.

## Questions

If you have any questions, please leave them in the Issues section: https://github.com/pekarskyi/ip-debug-log-viewer/issues

## Changelog

1.0.0 - 24.03.2025:
- Initial release