WordPress plugin to make reviewing, analyzing and managing the debug.log file easier.
| Author: | Maxwell Berkel (profile at wordpress.org) |
| WordPress version required: | 3.9 |
| WordPress version tested: | 4.8 |
| Plugin version: | 1.2.1 |
| Added to WordPress repository: | 20-08-2015 |
| Last updated: | 15-06-2017
Warning! This plugin has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.
|
| Rating, %: | 80 |
| Rated by: | 14 |
| Plugin URI: | https://github.com/allbitsnbytes/wp-log-viewe... |
| Total downloads: | 58 538 |
| Active installs: | 1 000+ |
 Click to start download |
|
Screenshots
** Grouped view ** - Grouped view makes it easier to analyze errors and debug code
** Error details ** - Error message and details are neatly displayed
** Automagically refreshes ** - No need to refresh, new errors will be automatically displayed
** Realtime search ** - Makes finding what you are looking for super easy
** Filter errors ** - Click error types to filter results. Only see what you need
** Admin bar count ** - Easily see when you have errors. Click to go to log viewer
** Settings Pane ** - Customize your experience in one place
** Help section ** - Have questions? Get answers
Installation Instructions
From your WordPress Dashboard
- Click on “Plugins > Add New” in the sidebar
- Search for “WP Log Viewer”
- Activate WP Log Viewer from the plugins page
From wordpress.org
- Search for “WP Log Viewer”
- Download the plugin to your local computer
- Upload the wp-log-viewer directory to your “/wp-content/plugins” directory using your favorite ftp/sftp/scp program
- Activate WP Log Viewer from the plugins page
Once Activated
Click on “Tools > Log Viewer” in the sidebar or “Debug Log” in the admin bar.
Requirements
- PHP 5.4.0 or greater
- WordPress 3.9 or above
How to I access the plugin?
Once activated, you can access the plugin one of 3 ways:
- Click on the “Debug Log” link in the admin bar
- Click on “Tools” in the sidebar, then click on “Log Viewer”
- Click on “Dashboard”, then from the dashboard click the link in the widget
What is debug toggling?
This feature allows you to enable/disable debugging with a click. No more manually updating WP_DEBUG in wp-config.php.
How do I enable debug toggling?
Enabling this feature is easy and takes less than a minute.
- In your document root, create the following file: wplv-config.php
- Paste the following into wplv-config.php
<?php
if (!defined(‘ABSPATH’)) { header(‘HTTP/1.0 403 Forbidden’); die; }
define(‘WPLV_DEBUG’, false);
- In wp-config.php, add the following line. Add it before the line where you define WP_DEBUG.
include_once $_SERVER[‘DOCUMENT_ROOT’] . ‘/wplv-config.php’;
- In wp-config.php, replace the line where you define WP_DEBUG with the following
define(‘WP_DEBUG’, defined(‘WPLV_DEBUG’) ? WPLV_DEBUG : false);
define(‘WP_DEBUG_LOG’, true);
define(‘WP_DEBUG_DISPLAY’, false);
- That’s it. Refresh the page in the browser and you are ready to go.
How do I filter errors?
Errors are grouped by error types. These error types are listed at the top of the viewer and color coded. You can click on any of these error to filter results by those errors.
You can click on multiple errors to limit results to only those errors. Click a second time to deselect that error type. This feature works great with custom errors.
What are custom errors?
In settings, you can define custom errors. Each custom error has a key, label, and color. The key is used in your error message to the logviewer can identify your custom errors. The label and color are used to easily identify the error in the viewer.
How do I use custom errors?
When you write an error to the log, you have to start the error message with a # and the custom error key followed by a :.
Example: If you defined a custom error with a key: my-custom-error
In your code: error_log(‘#my-custom-error: The error message goes here’);
Do I need to refresh the log viewer?
No. The log viewer will automatically refresh and display new entries every 15 seconds by default. This feature is implemented using AJAX to avoid reloading the entire page.
What is Group View?
In Group View similar error entries are grouped together making it much easier to see unique errors and when they happened.
What is the count in the admin bar?
The count shown in the admin bar represent the number of unique errors in the log. So if there are 10 entries for the same error, it will only count as 1.
What is sidebar folding?
By default the sidebar will be folded when the log viewer is active. This increases the viewing. To disable, or toggle this behavior, click on settings then “Fold sidebar …”
What is the minimum length for a search query?
When using the realtime search, the search query must be atleast 3 characters or more in length.
Where can I report bugs?
Report bugs and suggest ideas at: https://wordpress.org/support/plugin/wp-log-viewer
All notable changes will be tracked in this change log.
1.2.1
Release date: 2017-06-14
- Fixed date timezone issue
1.2.0
Release date: 2017-06-14
- Tested WP 4.8
- Added support for filter: wplv_log_file_path
1.1.0
Release date: 2016-12-22
- Tested WP 4.7
1.0.7
Release date: 2016-08-17
- Tested wp 4.6
1.0.6
Release date: 2016-07-29
- Updated help section
1.0.5
Release date: 2016-05-11
- Tested wp 4.5.3
1.0.4
Release date: 2016-04-13
- Tested wp 4.5
1.0.3
Release date: 2016-01-29
- Fix
- Fixed a bug with permissions
1.0.2
Release date: 2016-01-28
-
Feature
- Added ability to limit who can see WP Log Viewer
-
Hook
- Added filter wplv_user_authorized
- Added filter wplv_can_download_log
- Added filter wplv_show_dashboard_widget
- Added filter wplv_show_adminbar_widget
1.0.1
Release date: 2016-01-04
-
Feature:
- Dashboard widget now supports custom errors
-
Fix:
- Fixed logic error that lead to undefined url_path error
- Fixed auto refresh not updating view
1.0.0
Release date: 2015-12-30
-
Feature:
- One click enable/disable debugging status
- One click downloading of smart log file
- One click error filtering by clicking error legends
- Smart downloads include only the latest unique entries. Duplicates are removed to reduce filesize and make reading the file easier
- Persist selected view, sorting across login sessions
- Settings pane added for easy management of viewer settings
- Add and edit custom error types
-
UI:
- WordPress sidebar is folded to increase viewer space
- Sidebar is sticky so actions are always present when scrolling
- Updated the header to display more error messages and to use less vertical space
- Display count for each error type
- Smarter display of error legends. Only legends with errors are displayed
- Search query is not displayed under search bar
- Increased error message area to display more horizontally which will reduce scrolling
- Made error message more readable by removing line number and file path
- Reorganized error details (type, line number and file path) to make it more space efficient
-
Fix:
- Fixed a bug that was breaking file path regex
0.13.0
Release date: 2015-10-16
- Fix:
- Disabled remote api and replaced it with WordPress Ajax handling. This should solve problems experienced with Multi-Tenant and extreme custom installs
0.12.5
Release date: 2015-08-28
- Fix:
- Fixed an issue where wp installs in sud directories sometimes caused the plugin not to load
0.12.4
Release date: 2015-08-26
- Fix:
- Improved loading of needed wp core files from api file
0.12.3
Release date: 2015-08-24
- Fix:
- Fixed a bug that cause plugin to not load based on certain server configurations
0.12.2
Release date: 2015-08-20
-
Fix:
- Fixed a error that was causing the right debug status to not be displayed sometimes
-
UI:
- Added color indicator for PHP Deprecated and WordPress database errors
0.12.1
Release date: 2015-08-14
- Fix:
- Improved debugging status detection
- Improved simulation mode detection in app, admin bar and dashboard components
0.12.0
Release date: 2015-08-14
-
Feature:
- Added debug simulation mode so when debug status can not be determined, user can still browse debug log if present
- Added dashboard widget
- Added admin bar menu with summary
-
Fix:
- When clearing log file, if that fails attempt to delete the file.
-
UI:
- Reformat error message to make it easier to read
- Made search more prominent
- Add focus to search field when log loads making it easy to search/filter entries without having to click
- Display error type, line number and path to file on their own line making the information easier to find
- Added count for number of entries
- Added color coding for error types fatal, warning and notice for each entry
- Added color coding legend
- Admin bar widget synchs realtime as log data updates when log viewer is open
0.11.1
Release date: 2015-06-22
-
Feature:
- Added group view which groups similar errors making it easier to browse log entries
-
Fix:
- Added support for when toLocaleDateString and toLocaleTimeString are not supported. Will instead use toDateString and toTimeString then format date/time accordingly.
- Added support for 401 errors what debug log update checker is running. A 401 error will not stop the auto checker.
0.11.0
Release date: 2015-06-01
-
Feature:
- Added realtime search
-
UI:
- Font Awesome support
- Icons to sidebar links