[WIP] Add a logger

[Soare-Robert-Daniel]

Important

In ALPHA testing. Not final.

Summary

• Logs Tab
  • Export Button
  • Filters by level
• Settings Tab
  • Select logging level to report
  • Delete logs button
  • Enable email reporting toggle
  • Set the email address to send the report
• Emails
  • Email template
  • Errors counting from the interval
  • Send the email weekly
• Log Helper
  • Write the logs into a log file with JSON lines format.
  • Delete logs
  • Read recent logs
  • Check and delete the logs on a schedule
  • Size protection every 12 hours (delete if it passes 50MB)
  • Make an alternative to global $themeisle_log_event; to gather error messages per import ui
• Replace the old debug via 'themeisle_log_event`
• Add unit tests
• Add E2E tests

Will affect visual aspect of the product

NO

Screenshots

Test instructions

• Run an import in Debug mode and check the Logs tab
• Check the errors when importing a bad feed
• Check the email with the reporting (you will have SMTP setup, and you can manually trigger the event WP Control plugin )

Important

Test with and without PRO version: https://github.com/Codeinwp/feedzy-rss-feeds-pro/pull/927

Check before Pull Request is ready:

• I have written a test and included it in this PR
• I have run all tests and they pass
• The code passes when running the PHP CodeSniffer
• Code meets WordPress Coding Standards for PHP, HTML, CSS and JS
• Security and Sanitization requirements have been followed
• I have assigned a reviewer or two to review this PR (if you're not sure who to assign, we can do this step for you)

Closes https://github.com/Codeinwp/feedzy-rss-feeds-pro/issues/845

[pirate-bot]

Plugin build for 224275f is ready 🛎️!

• Download build

Note

You can preview the changes in the Playground

[Copilot]

Pull Request Overview

This PR adds comprehensive logging functionality to Feedzy RSS Feeds, introducing a structured logging system to help debug import issues and monitor system health.

• Implements a new JSON-based logger with configurable log levels (debug, info, warning, error, none)
• Adds a logs management interface in the settings with filtering, export, and email reporting capabilities
• Replaces legacy themeisle_log_event usage throughout the codebase with the new logging system

Reviewed Changes

Copilot reviewed 18 out of 18 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
includes/admin/feedzy-rss-feeds-log.php	Core logging class implementing singleton pattern with file-based JSON logging
includes/admin/feedzy-rss-feeds-task-manager.php	Manages scheduled tasks for log cleanup and email reporting
includes/layouts/settings.php	Updated settings page to include logs configuration and viewer tab
includes/layouts/feedzy-logs-viewer.php	New logs viewer interface with filtering and export functionality
includes/layouts/feedzy-email-report.php	Email template for weekly error reports
tests/test-log.php	Comprehensive unit tests for the logging functionality
tests/e2e/specs/logger.spec.js	End-to-end tests for the logging interface
includes/admin/feedzy-rss-feeds-import.php	Updated import process to use new logging system extensively
css/settings.css	Styling for the new logs interface
js/feedzy-setting.js	JavaScript for log management UI interactions

[Copilot]

There's a syntax error in the printf function call. The format string has mismatched placeholders - it should be '%1$s (%2$s)' but currently shows '%$1s(%2$s)' with incorrect placeholder syntax.

Suggested change

	'<p>%$1s(%2$s)</p>',
	'<p>%1$s (%2$s)</p>',

[Copilot]

The code uses filesize() directly without checking if the file exists, but earlier checks use $this->log_file_exists() and $this->is_log_readable(). This could cause a PHP warning if the file doesn't exist at this point due to race conditions.

Suggested change

	header( 'Pragma: public' );
	header( 'Pragma: public' );
	if ( ! $this->log_file_exists() || ! $this->is_log_readable() ) {
	return new WP_Error( 'no_logs', '', array( 'status' => 404 ) );
	}

[Copilot]

Similar to the filesize issue, readfile() is called without checking if the file still exists. Consider adding a final file existence check before these file operations.

Suggested change

	// Final check before reading the file.
	if ( ! file_exists( $this->filepath ) || ! is_readable( $this->filepath ) ) {
	return new WP_Error( 'no_logs', '', array( 'status' => 404 ) );
	}

[Copilot]

[nitpick] The variable $value is declared but may not be used when the business/personal conditions are false. Consider moving this declaration inside the conditional block or providing a default value that's more meaningful.

Suggested change

	$value = '';
	$value = null;

[Copilot]

The variable $import_errors is declared but never used in this test method. Since the logging system has changed, this variable appears to be leftover from the old implementation and should be removed.

[poonam279]

@Soare-Robert-Daniel, I noticed two things so far:

1. The export file is in JSONL format.
2. I created an import job, but the Info section shows repeated entries for Running job options via feedzy_shortcode_options. Is it intentional?

[Soare-Robert-Daniel]

1. The export file is in JSONL format.

This is intentional. The file is for us to analyze, its scope is to be given to support, then posted into the Github issues.

2. I created an import job, but the Info section shows repeated entries for Running job options via feedzy_shortcode_options. Is it intentional?

Yes

[poonam279]

@Soare-Robert-Daniel, I have used this feed URL https://www.nasa.gov/feeds/podcasts/explorers-apollo and the full content imported without any issue but the log shows an error Full content URL response received.

Could you please let me know why it appears?

[Soare-Robert-Daniel]

@Soare-Robert-Daniel, I have used this feed URL https://www.nasa.gov/feeds/podcasts/explorers-apollo and the full content imported without any issue but the log shows an error Full content URL response received.

This was marked wrong as an error, it was supposed to appear only for debug. Thanks for checking 🙏