Debug Log Manager

Beskrivning

Debug Log Manager allows you to:

  • Enable WP_DEBUG with one click to log PHP, database and JavaScript errors when you need to, and disable it when you’re done. No need to manually edit wp-config.php file.
  • Create the debug.log file for you in a non-default location with a custom file name for enhanced security.
  • Copy the content of the default / existing debug.log file into the custom debug.log file, and delete the default / existing debug.log file. So there is continuation in logging and enhanced security going forward.
  • Parse the debug.log file and view distinct errors and when they last occurred, which is better than looking at the raw log file (potentially) full of repetitive errors.
  • Quickly find and filter more specific errors for your debugging work.
  • Make error details easier to read by identifying error source (core / plugin / theme) and separating file path and line number.
  • Easily view files where PHP errors occurred. This includes WordPress core, plugin and theme files.
  • Enable auto-refresh to automatically load new log entries. No need to manually reload the browser tab, or to tail -f the log file on the command line.
  • Easily clear the debug.log file to save disk space and more easily observe newly occurring errors on your site.
  • Show an indicator on the admin bar when error logging is enabled.
  • Add a dashboard widget showing the latest errors logged.
  • Use error_log() to output error info into your debug log. e.g. error_log( $error_message ) for simple, string-based error message, or error_log( json_encode( $error ) ) when inspecting a more complex error info, e.g. array or object.

A simpler and more compact version of Debug Log Manager is included as part of the System Dashboard plugin, should you prefer a single plugin that does more.

What Users Say

”This is a great plugin for dev especially for people who tinker in the code.” ~PK Son

”I have used a couple of other logger plugins and this is by far the best one.” ~Brian Henry

Another massive time-saving tool. ~Jeff Starr

Give Back

Check These Out Too

  • System Dashboard: Central dashboard to monitor various WordPress components, processes and data, including the server.
  • Variable Inspector: Inspect PHP variables on a central dashboard in wp-admin for convenient debugging.
  • Code Explorer: Fast directory explorer and file/code viewer with syntax highlighting.
  • Database Admin: Securely manage your WordPress website’s database with a clean and user-friendly interface based on a custom-themed Adminer app. Only available on Github.
  • Admin and Site Enhancements helps you to easily enhance various admin workflows and site aspects while replacing multiple plugins doing it.
  • Flexible Scroll Top and Floating Share Buttons is a lightweight combo with minimalist UI.
  • WordPress Newsboard: The latest news, articles, podcasts and videos from 100+ WordPress-focused sources.

Skärmdumpar

  • Debug Log Manager main page
  • Fatal errors with the stack trace
  • More log entries sample
  • Admin bar indicator and dashboard widget

Vanliga frågor

Will this work with the managed WordPress hosting I am on?

Maybe. It’s been tested with Kinsta and GridPane (with Secure Debug turned off). If you find it’s not working with your managed host, please post in the support forum about the issue / error you encounter. I may ask for a test site that I can work with.

How was this plugin built?

Debug Log Manager is built using the excellent WPConfigTransformer class from WP Debug Log – Config Tool, DataTables.js, jSticky and jQuery Toast.

Recensioner

18 oktober 2023 1 svar
This is an incredible useful and lightweight plugin for easily review and filter errors in your Wordpress site. The developer is friendly, and highly skilled. I am using his other tools (free and premium too) with confidence. Thanks Bowo your work and efforts for the community.
25 maj 2023
I wish I had found out about this plugin a long time ago. It saves time when debugging client sites.
22 oktober 2022 1 svar
A stitch in time saves nine. This plugin is so important I have it as the #2 item in my admin menu (below only Dashboard). Proactively finding and fixing errors is essential to running a successful site. This plugin does a simple job, and it does it very well. Some niceties are the JavaScript logging, and the counting of log occurrences. The UI is simple, but appropriate. The developer is responsive. I have used a couple of other logger plugins and this is by far the best one.
19 september 2022
This is a great plugin for dev especially for people who tinker in the code. Not only does it help debug things, it's a great way to learn what kinds of mistakes you commonly make, and avoid them in the future. Great job Bowo!
Läs alla 7 betyg

Bidragsgivare och utvecklare

”Debug Log Manager” är programvara med öppen källkod. Följande personer har bidragit till detta tillägg.

Bidragande personer

”Debug Log Manager” har översatts till 1 språk. Tack till översättarna för deras bidrag.

Översätt ”Debug Log Manager” till ditt språk.

Intresserad av programutveckling?

Läs programkoden, kika på SVN-filförvaret eller prenumerera på utvecklarloggen via RSS.

Ändringslogg

2.3.1 (2023.11.30)

  • Improved the randomness of the debug log file name for improved security.

2.3.0 (2023.11.29)

  • Improved parsing of log entries with more than one set of bracketed info, e.g. [timestamp] [WARNING] detail info about error. It was parsed as ”No error message specified…”. Props to @azzuwayed for providing the one important line of code with the right preg_replace regex pattern to fix that. I find people who can churn out regex patterns as needed to have a special superpower!

2.2.2 (2023.11.29)

  • [SECURITY] Improved security of ajax call to clear log file. Authorized only for site admins and secured to prevent CSRF with nonce. Props to Dmitrii Ignatyev again for reminding to check on this one as well.

2.2.1 (2023.11.29)

  • [IMPORTANT][SECURITY] Fixed a security issue where the debug log manager directory can be opened in the browser allowing visitors to see and download the debug log file which may contain sensitive information. Once you update to v2.2.1, please visit the debug log page at least once. This will create an empty index.php file in the DLM directory and prevent the issue. This vulnerability was responsibly disclosed by Dmitrii Ignatyev from CleanTalk inc. on November 2, 2023. Apologies if this took me a while to get around to as I was fully occupied with the launch of ASE Pro.

2.2.0 (2023.06.26)

  • Hide dashboard widget and admin bar icon for non-administrator users
  • Stop public.js from loading on the frontend if logging is disabled

2.1.4 (2023.04.15)

2.1.3 (2023.02.25)

2.1.0 (2023.02.21)

  • Correctly parse the content of entries added via the error_log() function. Instead of print_r(), please use json_encode(), if you’re trying to output a PHP $variable containing an array or object into the debug log. e.g. error_log( json_encode( $variable_name ) ). Props to @guyinpv for reporting the issue.

2.0.0 (2022.12.03)

  • WordPres core, plugin or theme files where PHP errors occurred can now be easily viewed by simply clicking on the file path in each error entry. This is done using core’s plugin/theme editor (modified to load in view-only mode) and the wordpress-develop repo on Github for core files.
  • SCRIPT_DEBUG constant is now set to true in wp-config when error logging is enabled, which should help with debugging javascript errors.
  • Added a button to disable plugin/theme editor below the error entries table. This is for when you’re done with debugging, i.e. you’ve disabled error logging and cleared the debug log file, and wants to keep things secure.

1.9.1 (2022.12.02)

  • Fixed styling issue for external link dashicon in entries when datatable is auto-refreshed.

1.9.0 (2022.12.02)

  • Detect PHP Exception error type and add it to the entries table filter.
  • Make error entries easier to read by identifying error source (core / plugin / theme) and separating file path and line number.

1.8.7 (2022.10.22)

  • Fix for missing wp_date() function for WordPress before v5.3.
  • Suppress all admin notices when viewing log entries. Thanks to a nice patch from @brianhenryie.
  • Improve inline comments for some of the code.

1.8.6 (2022.10.09)

  • Fix wrong reference to old app.js. Change to admin.js.

1.8.5 (2022.10.08)

  • Smooth out the behaviour of scroll-to-fix-on-top the position of DLM page’s header.
  • Change default number of entries to show on dashboard widget from 10 to 5.

1.8.4 (2022.10.08)

1.8.3 (2022.10.07)

  • CSS fix for dashboard widget to ensure error messages wrap properly, i.e. not overflow the widget container.

1.8.2 (2022.10.05)

  • CSS fixes for dashboard widget footer as well as main page header and footer sizing.

1.8.0 (2022.10.02)

  • Add dashboard widget showing the latest errors logged, the error logging status and a link to the Debug Log Manager page.

1.7.0 (2022.09.28)

1.6.4 (2022.09.27)

  • Fix PHP Warning issue: ”Trying to access array offset on value of type bool” reported by @brianhenryie and @hogash.

1.6.3 (2022.09.27)

  • Further fixes (HTML, CSS, JS) to ensure error details are properly wrapped inside the data table and not cause the table to overflow the page width. This includes scenarios when auto-refresh is enabled and pagination is in use.

1.6.2 (2022.09.26)

  • CSS fix to ensure error details are properly wrapped inside the data table and not cause the table to overflow the page width.

1.6.1 (2022.09.26)

  • Improve detection of anchor text in wp-config.php for the WP_Config_Transformer class. Make sure toggling of WP_DEBUG works for wp-config.php that uses either ”Happy publishing” or ”Happy blogging”.

1.6.0 (2022.09.25)

  • Add admin bar status icon. Will only show up if error logging is enabled and on pages other than the Debug Log Manager main page, including the front end.

1.5.3 (2022.09.24)

  • Improve log parser for handling error messages that contain the # and [ characters, e.g. ”Argument #1” or ”[internal function]”

1.5.2 (2022.09.22)

  • Disable auto-refresh when pagination is used. Otherwise, table will always go back to the first page.

1.5.1 (2022.09.21)

  • Fix typo in Error Type dropdown filter for ’JavaScript’ preventing filter to work properly for this error type.

1.5.0 (2022.09.21)

  • Add Error Type dropdown filter.

1.4.0 (2022.09.21)

  • JavaScript errors on wp-admin and the front end is now logged by default.
  • Improve copy around error types for simplicity and clarity.
  • Fix an issue where AJAX calls for the auto-refresh feature won’t properly stop in multiple scenarios of clicking the Error Logging and/or Auto-Refresh toggles.

1.3.3 (2022.09.20)

1.3.1 (2022.09.18)

  • Fix bugs around the auto-refresh feature. Disabling auto-refresh works only on the toggle and wp_option entry but not on the actual ajax calls. If auto-refresh is enabled, it only worked on clicking the toggle but not on page load. Both issues are fixed.

1.3.0 (2022.09.18)

  • Implement toast notifications on various action completions, e.g. clearing log file.
  • Change date format to M j, Y – H:i:s, e.g. Dec 31, 2021 – 20:06:34.
  • Implment auto-refresh feature that will automatically load the latest error entries every 5 seconds.

1.2.0 (2022.09.16)

  • Fix detection of existing debug log file, if there is one, so it is copied correctly into DLM’s debug log file.
  • Auto update entries table when logging is enabled, including when copying entries from existing debug.log file.
  • Code refactor: added autoloader of plugin’s PHP classes.

1.1.0 (2022.09.13)

  • Improve implementation of WP PHP Coding Standards across the codebase.
  • Improve variable sanitization and escaping.
  • Set initial data table sort based on the # column so that Last Occurence column is properly sorted according to the timestamp.
  • Add get_value() method to WP_Config_Transformer class to work with existing debug log constants in wp-config.php.
  • Enable $options argument for the add() and update() method in WP_Config_Transformer to ensure formatting of debug log constants is correct in wp-config.php.

1.0.1 (2022.08.31)

  • Refactor code for better organization and maintainability.
  • Improve plugin description / README.md.

1.0.0 (2022.08.29)

  • Initial stable release.