PHP Error Log Viewer for ClassicPress
The PHP Error Log Viewer plugin brings your error log straight into your ClassicPress dashboard. Color-coding helps you to quickly scan even the longest of error logs. Or, just filter out the errors you don't want to see. No more wall-of-text error messages – this plugin turns your PHP error log into an incredibly useful display.
Frequently Asked Questions
-
My error log is huge...can the plugin handle it?
The plugin has been successfully tested with error logs up to 20Mb (100,000+ entries). With an error log that huge, it took about 15 seconds to finish rendering the (stylized) error log on the screen. However, for error logs with tens of thousand of entries (or less,) it only takes a second or two. Of course, your results will vary with your server configuration. -
Why don't I see the purge button?
If your error log is not writable by web server, thePurge Error Logbutton will not appear in the interface. -
How big should my error log be?
You should always aim to run a site that produces no notices, warnings, or errors. Your target file size for the error log should be exactly0 bytes. -
How can I change the error colors?
See the Styling section for specific details. -
Why are there sometimes more errors than stack traces?
While many errors do produce a stack trace, some do not. This is the reason for the difference. -
My error log wasn't found? What now?
If your error log isn't automatically detected by the plugin, you will see a screen that offers three possible solutions. Most likely, one of the solutions will work for you.
Screenshots
Built for Quick Reading – Error messages are separated nicely. Built-in color-coding and filtering allows you to quickly find what you need.
Changelog
License
The PHP Error Log Viewer plugin is released under the General Public License.
Installation Requirements
- ClassicPress 1.0.0 or later
- PHP 5.6 or later
Manual Installation
- Download the zip file to your local computer
- Login to your ClassicPress website.
- Navigate to
Dashboard > Plugins > Add New > Upload Plugin - Upload the plugin zip file to your site
- Click to
Installthe plugin - Click to
Activatethe plugin - See the documentation for next steps
Standard Installation
- Login to your ClassicPress website.
- Navigate to
Dashboard > Plugins > Add New - Search for
Code PotentorPHP Error Log Viewer - Find the
PHP Error Log Viewerplugin in the results - Click to
Installthe plugin - Click to
Activatethe plugin - See the documentation for next steps
Note: This method will be available when the official ClassicPress plugin directory is ready.
Checksums
Checksums allow you to verify the integrity of the plugin file.
Coming soon!
Conflicts
There are no reported conflicts between the PHP Error Log Viewer plugin and other ClassicPress plugins or themes. If you experience any kind of problem or annoyance, please submit an issue if you have a GitHub account, or send an email!
Usage
Viewing the Error Log
Navigate to Dashboard > Tools > PHP Error Log to view the error log.
Filtering the Error Log
The checkboxes across the top of the display allow you to show and hide each of the various types of errors: Deprecated, Notice, Warning, Error, Stack Trace, and Other. In addition, the Date/Time checkbox can show or hide error meta data such as dates, times, timezones, and IP addresses to further improve readability. Tick your preferred boxes and click the Apply Filters button to update the display.
Refreshing the Error Log
When viewing the error log, you will find a button to Refresh Error Log at the right side of the page. Clicking this button has the same effect as clicking your browser's refresh button. The error log will be re-read and displayed fresh.
Purging the Error Log
When viewing the error log, you will find a button to Purge Error Log at the right side of the page. Clicking this button will purge all messages from the error log. A confirmation dialog prevents accidental deletion. If your error log is not writable by the PHP process, you will not see this button.
Settings
Error Filtering
The checkboxes at the top of the error log display allow you to choose which types of messages you want to see. Check any of the boxes and click the Apply Filter button to update the display.
- Date/Time
Check this box to show dates, times, and other meta data. - Notice
Check this box to show non-critical PHP notices. - Warning
Check this box to show non-critical PHP warnings. - Error
Check this box to show critical PHP errors. - Stack Trace
Check this box to show stack traces for critical errors. Note that not all critical errors will generate a stack trace. - Other
Check this box to show any other errors that didn't meet the above criteria.
Shortcodes
There are no shortcodes associated with the PHP Error Log Viewer plugin. If you have an idea for a new shortcode, please send an email!
Filters
There are no filter hooks implemented in the PHP Error Log Viewer plugin at this time. If you have an idea for a new filter hook, please send an email!
Actions
There are no action hooks implemented in the PHP Error Log Viewer plugin at this time. If you have an idea for a new action hook, please send an email!
Styling
Using Custom Error Colors
To override the color-coding for the error messages and legend, copy the following styles into your theme's style.css file and make your changes there.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 |
/* Deprecated code. */ #codepotent-php-error-log-viewer .php-deprecated, .codepotent-php-error-log-viewer-legend-box.item-php-deprecated { border-left:10px solid #847545; } /* Notices. */ #codepotent-php-error-log-viewer .php-notice, .codepotent-php-error-log-viewer-legend-box.item-php-notice { border-left:10px solid #ccc; } /* Warnings. */ #codepotent-php-error-log-viewer .php-warning, .codepotent-php-error-log-viewer-legend-box.item-php-warning { border-left:10px solid #ffee58; } /* Errors. */ #codepotent-php-error-log-viewer .php-error, .codepotent-php-error-log-viewer-legend-box.item-php-error { border-left:10px solid #e53935; } /* Stack traces. */ #codepotent-php-error-log-viewer .php-stack-trace-title, #codepotent-php-error-log-viewer .php-stack-trace-step, #codepotent-php-error-log-viewer .php-stack-trace-origin, .codepotent-php-error-log-viewer-legend-box.item-php-stack-trace-title { border-left:10px solid #ef9a9a; } /* Any other messages. */ #codepotent-php-error-log-viewer .php-other, .codepotent-php-error-log-viewer-legend-box.item-php-other { border-left:10px solid #00bcd4; } |
Share Your Experience
Had a great experience with the PHP Error Log Viewer plugin for ClassicPress? Share your thoughts and get a link back to your site! Emails are not shared or published.