How to Add an Error Log Page in the WordPress Dashboard Under Settings > Error Log

<?php
/**
* Plugin Name: WP Dashboard Error Log
* Plugin URI: https://example.com/
* Description: Adds an Error Log page under Settings menu to view and clear the WordPress debug log.
* Version: 1.0.0
* Author: Your Name
* Author URI: https://example.com/
* License: GPL2
* Text Domain: wp-dashboard-error-log
*/

if ( ! defined( ‘ABSPATH’ ) ) {
exit;
}

if ( defined( ‘WP_DEBUG_LOG’ ) && WP_DEBUG_LOG ) {
ini_set( ‘error_log’, WP_CONTENT_DIR . ‘/debug/debug.log’ );
}

// Hook to add the submenu under the Settings menu
add_action( ‘admin_menu’, ‘add_error_log_submenu’ );

function add_error_log_submenu() {
add_submenu_page(
‘options-general.php’, // Parent slug (Settings)
‘Error Log’, // Page title
‘Error Log’, // Menu title
‘manage_options’, // Capability
‘error-log’, // Menu slug
‘display_error_log’ // Callback function to display the error log
);
}

// Callback function for displaying and clearing the debug log
function display_error_log() {
echo ‘<div class=”forguard-wrap” style=”padding: 20px 20px 20px 0px;”>’;

// Get the path to the debug.log file
$debug_log_path = WP_CONTENT_DIR . ‘/debug/debug.log’;

// Check if the form is submitted for deletion and nonce is verified
if ( isset( $_POST[‘delete_debug_log’] ) && check_admin_referer( ‘delete_debug_log_action’ ) ) {

// Check if the file exists before deleting its contents
if ( file_exists( $debug_log_path ) ) {

// Clear the contents of the debug.log file
file_put_contents( $debug_log_path, ” );

echo ‘<div class=”notice notice-success” style=”margin:0; margin-bottom:5px;”><p>Debug log file content deleted successfully.</p></div>’;

} else {

echo ‘<div class=”notice notice-error” style=”margin:0; margin-bottom:5px;”><p>Debug log file not found.</p></div>’;

}
}

// Display the admin page title
echo ‘<h1 style=”margin:0;background-color:#4d4d4d;color:#fff;padding:10px;font-size:20px;text-transform:uppercase;”>’ . esc_html( get_admin_page_title() ) . ‘</h1>’;

// Check if the debug.log file exists and display its content
if ( file_exists( $debug_log_path ) ) {

$log_content = file_get_contents( $debug_log_path );

// Split the log content into an array of lines
$log_lines = explode( “\n”, $log_content );

// Output the form with a “Delete Log Content” button
echo ‘<form method=”post” style=”font-family:Helvetica, Arial, Sans-serif, Verdana, Tahoma;margin:0;color:#4D4D4D;padding:0;box-sizing:border-box;line-height:1.5;”>’;

// Add a nonce for security
wp_nonce_field( ‘delete_debug_log_action’ );

echo ‘<input type=”hidden” name=”delete_debug_log” value=”1″>’;

// Display log content in a scrollable box with line numbers
echo ‘<div style=”display:flex;font-family:Helvetica, Arial, Sans-serif, Verdana, Tahoma;margin:0;color:#4D4D4D;box-sizing:border-box;line-height:1.5;”>’;

echo ‘<div style=”font-family:Helvetica, Arial, Sans-serif, Verdana, Tahoma;margin:0;color:#4D4D4D;box-sizing:border-box;line-height:1.5;flex:1;overflow:auto;background-color:#fff;padding:20px;height:400px;border:1px solid #ccc;”>’;

foreach ( $log_lines as $lineNumber => $lineContent ) {

echo ‘<div style=”display:flex;gap:4px;font-family:Helvetica, Arial, Sans-serif, Verdana, Tahoma;padding:0;box-sizing:border-box;line-height:1.5;”>’;

echo ‘<span style=”color:#97a2ac;font-family:Helvetica, Arial, Sans-serif, Verdana, Tahoma;padding:0;box-sizing:border-box;line-height:1.5;”>’ . esc_html( $lineNumber + 1 ) . ‘: </span>’;

echo esc_html( $lineContent );

echo ‘</div>’;

}

echo ‘</div>’;
echo ‘</div>’;

// Output the “Delete Log Content” button
echo ‘<div class=”debuglog-button” style=”margin:0;font-family:Helvetica, Arial, Sans-serif, Verdana, Tahoma;color:#fff;padding:10px;box-sizing:border-box;line-height:1.5;background-color:#4d4d4d;”>’;

echo ‘<input style=”font-size:11px;text-transform:uppercase;padding:5px;font-weight:700;color:#fff;background-color:#E52E50;border:none;border-radius:2px;box-shadow:0px 8px 15px rgba(0, 0, 0, 0.1);transition:all 0.3s ease 0s;cursor:pointer;outline:none;” type=”submit” class=”button button-secondary” value=”Delete Log Content”>’;

echo ‘</div>’;

echo ‘</form>’;

} else {

echo ‘<div class=”notice notice-info”><p>Debug log file is empty or not found.</p></div>’;

}

echo ‘</div>’;
}