README

An email log for Filagora, as a Laravel 13 / Filament 5 plugin. Requires filagora/filagora-core and filagora/filagora-entitlements.

The package is at 0.1: the API may change between 0.x minor versions.

What it does

Email log. A read-only Filament screen over every outgoing message. When the mail_log_sending setting is on (it is off by default), every outgoing message is recorded: recipients (to, cc, bcc), subject, mailer, the notification class that sent it, and its status (sending, then sent with the message id). Logging never blocks the mail: a failure to log is reported to the application log and the message goes out. The EmailLog::forRecipient($address) scope finds a person's rows (given spelling and lowercase; a blank address matches nothing), for privacy export and erasure.
Access. The screen is read-only and needs the filagora.logs.view ability, mapped in config/filagora-logs.php to the entitlement of the same name. Point it at your own key there.
Table (email_logs, prefixed filagora_ by default) matches an existing site's index for index, so php artisan filagora:adopt accepts it.

An audit log viewer is planned but not part of this release.

composer require filagora/filagora-logs
php artisan migrate
php artisan filagora:entitlements:sync

->plugin(\Filagora\Logs\FilagoraLogsPlugin::make())

Then turn on the "Log Email Sending Activity" setting if you want the email log.

composer test

Tests run against a real MariaDB database named testing.

MIT. See LICENSE.