Error Log Module — User Guide

The Error Log Viewer is the primary module of the Advanced Analytics plugin. It reads your PHP error log file in reverse order (newest entries first), parses each entry, and displays them in a searchable, filterable table directly inside your WordPress admin area.

Prerequisites

For the Error Log Viewer to function, the following conditions must be met on your server:

You can enable debuging from plugins settings, just make sure that both “WP Debug Enable” and “WP Debug Log Enabled” are checked. Plugin will try to populate the wp-config.php with these settings (if it can). Otherwise you have to enable it yourself.

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

Accessing the Error Log Viewer

Once the plugin is installed and activated:

1. In the WordPress admin sidebar, click “0 Day” (the top-level menu).
2. Click “Error Log viewer” from the submenu.

The viewer will automatically detect and read your PHP error log file. If any prerequisites are missing, you will see an informational message explaining what needs to be configured.

The Log Table

The main screen displays error log entries in a WordPress list table, sorted with the most recent entries at the top.

Columns

Stack Traces

When an error includes a stack trace, the Message column shows a “Show details” toggle. Clicking it reveals the full call stack with:

• Frame number and function/method name
• Source file path with line number
• Clickable links to view the source file at the error line

Severity Levels

The Error Log Viewer recognizes and color-codes the following severity types:

Severity Filtering

You can control which severity types are visible in the log table. This is useful for focusing on specific error types.

Toggle Individual Severities

1. Above the log table, locate the row of severity checkboxes with coloured labels.
2. Uncheck a severity to hide all entries of that type.
3. Check a severity to show entries of that type again.
4. The page reloads automatically after each toggle.

Show Only One Severity

1. Use the single severity dropdown above the table.
2. Select the severity type you want to view exclusively.
3. To reset and show all severities again, select the reset option from the dropdown.

Searching the Log

Use the search box in the top-right corner of the log table to search through error messages.

• The search queries both the error message text and stack trace content.
• Type your search term and press Enter or click Search.
• The search is case-insensitive and matches partial text.
• To clear the search, empty the box and press Enter.

Filtering by Plugin

You can filter the log to show only errors originating from a specific plugin:

1. Locate the plugin filter dropdown above the log table.
2. Select the plugin name from the list (populated from all installed plugins).
3. Click Filter to apply.
4. Select “All plugins” to remove the filter.

Source Code Viewer

The Error Log Viewer lets you inspect the source code at the exact line where an error occurred, without leaving the admin area.

1. In the Source column or within a stack trace, click the file link (e.g., “View source”).
2. A modal window (ThickBox) opens showing the PHP source file with syntax highlighting.
3. The error line is highlighted and the view automatically scrolls to it.
4. Close the modal to return to the log table.

If given error has stack trace info (you will see “Show Details” button), when viewing details, you can click on every path line and that will open the source viewer – the error line is highlighted and the view automatically scrolls to it.

Copy & Share

Each error entry provides quick actions for sharing error details:

Truncating the Log

Over time, the error log file can grow large. The plugin provides two truncation options:

Downloading the Log

You can download the complete error log file to your computer:

1. Click the “Download” button above the log table.
2. The file downloads with the original filename.

The download uses HTTP streaming with 8 MB chunks for efficient transfer of large files. It also supports resumable downloads (HTTP Range requests).

CSV Export

Export the currently filtered log entries to a CSV file for analysis in spreadsheet applications.

1. Apply any desired filters or search criteria (the export respects your current filter context).
2. Click the “CSV Export” button above the log table (only visible when entries are present).
3. A progress bar appears during the export. You can click Cancel if needed.
4. The CSV file downloads automatically once complete.

Exported Fields

Automatic Log Truncation

You can schedule automatic log truncation to prevent the error log from growing indefinitely.

1. Navigate to 0 Day → Settings.
2. Find the “Auto clear log” option.
3. Select a schedule: Hourly, Twice Daily, Daily, or Weekly.
4. Click Save Changes.

When the scheduled event runs, the log is truncated while keeping the last N records (as configured by the “Records to keep on truncation” setting).

To disable automatic truncation, set the schedule back to “Disabled”.

Admin Bar Notifications

The plugin adds a live notification node to the WordPress admin bar that shows the most recent error from your log.

• The notification appears in the admin bar on every admin page.
• It displays the latest error message with severity styling.
• Click the notification to navigate directly to the Error Log Viewer page.
• The notification updates via a REST API call each time a page loads.

This feature can be disabled in the plugin settings by turning off “Live notifications in admin bar”.

Browser Push Notifications

The plugin can send browser push notifications when new errors are detected, even when you are on a different admin page.

1. When you first visit a plugin page, your browser may ask for notification permission — click Allow.
2. The plugin polls for new errors at a configurable interval (default: every 10 seconds, minimum: 5 seconds).
3. When a new error is detected, a browser notification appears with the severity level and error message.
4. Click the notification to jump directly to the Error Log Viewer page.
5. Notifications auto-dismiss after 5 seconds.

Raw Log View

Below the parsed log table, the Error Log Viewer displays the raw log file content in a scrollable text block (dark background, white text, maximum height of 400 pixels).

• This shows the unprocessed log content exactly as it appears in the file.
• Auto-copy: Selecting any text in the raw log view automatically copies it to your clipboard. A tooltip confirms the copy.

Screen Options

Click Screen Options (top-right of the page, just below the admin bar) to customize the display:

Settings

The plugin settings page provides the following options relevant to the Error Log Viewer:

Error Log Options

Notification Options

General Options

Severity Customization

Each severity type can be individually configured with:

• Custom color — Change the badge color for any severity level.
• Visibility — Show or hide individual severity types from the log display.

Dark Skin

The entire plugin supports a dark skin mode. When activated, all severity badges and UI elements adapt to a dark color scheme.

The dark skin preference is stored in your browser’s local storage and persists across page loads.

Security Notice

To change the log file location, update your php.ini or wp-config.php:

// Option 1: Set a custom path in wp-config.php
define( 'WP_DEBUG_LOG', '/path/outside/webroot/php-errors.log' );

// Option 2: Set in php.ini
// error_log = /path/outside/webroot/php-errors.log

Troubleshooting