ejoi8/filament-email-logs

Email log viewer and resend tools for Filament panels.

v1.0.0 2026-04-27 01:55 UTC

Requires

• php: ^8.3
• filament/filament: ^5.4
• illuminate/auth: ^13.0
• illuminate/database: ^13.0
• illuminate/mail: ^13.0
• illuminate/support: ^13.0
• illuminate/view: ^13.0

MIT

• ejoi8

• mail
• email
• laravel
• logs
• filament

README

Filament Email Logs is a Filament v5 plugin for Laravel 13 that records sent emails, shows them in a Filament resource, and lets administrators resend them to the original or corrected recipients.

• Source: https://github.com/ejoi8/filament-email-logs
• Issues: https://github.com/ejoi8/filament-email-logs/issues

Features

• Logs outgoing emails from Laravel's mail system
• Lists email logs inside a Filament panel
• Shows HTML and plain-text email content
• Resends a logged email to the original recipients
• Resends to corrected recipients when an email address was wrong
• Tracks resend lineage, resend count, resend note, and resent-by user

Requirements

• PHP 8.3+
• Laravel 13+
• Filament 5.4+

Installation

Composer

If you publish this package to a VCS repository or Packagist:

composer require ejoi8/filament-email-logs

For local development, you can also install it through a Composer path repository.

Migrations

Run the package migrations:

php artisan migrate

Optional: publish config

php artisan vendor:publish --tag=filament-email-logs-config

Optional: publish views

php artisan vendor:publish --tag=filament-email-logs-views

Registering the plugin

Register the plugin in your Filament panel provider:

use App\Models\User;
use Ejoi8\FilamentEmailLogs\FilamentEmailLogsPlugin;

->plugin(
    FilamentEmailLogsPlugin::make()
        ->authorizeUsing(fn (?User $user): bool => $user?->canManageSystem() ?? false)
)

This is a good fit when your application already has its own admin-access logic.

Configuration

The package config file is config/filament-email-logs.php.

<?php

use Filament\Support\Icons\Heroicon;

return [
    'logging' => [
        'enabled' => true,
    ],

    'authorization' => [
        'ability' => null,
    ],

    'navigation' => [
        'group' => 'System',
        'sort' => 1,
        'icon' => Heroicon::OutlinedEnvelope,
    ],
];

logging.enabled

Controls whether the package registers the MessageSent listener and records sent mail.

authorization.ability

Optional fallback authorization when you do not want to use ->authorizeUsing(...).

Example:

'authorization' => [
    'ability' => 'view email logs',
],

If ->authorizeUsing(...) is defined on the plugin, that callback takes priority.

navigation.group

Controls the Filament navigation group label.

navigation.sort

Controls the navigation order.

navigation.icon

Controls the resource navigation icon.

You can also override navigation directly in the plugin registration:

use Filament\Support\Icons\Heroicon;

->plugin(
    FilamentEmailLogsPlugin::make()
        ->navigationGroup('System')
        ->navigationSort(1)
        ->navigationIcon(Heroicon::OutlinedEnvelope)
        ->authorizeUsing(fn (?User $user): bool => $user?->canManageSystem() ?? false)
)

Plugin method overrides take priority over the config file.

How it works

The package listens for Laravel's Illuminate\Mail\Events\MessageSent event and stores the rendered email data in the email_logs table.

Each log stores:

• subject
• from address and name
• to, cc, and bcc addresses
• HTML body
• plain-text body
• mail message ID
• sent timestamp
• resend count
• last resent timestamp
• original email log ID for resent copies
• resent-by user ID
• resend note

When a resend happens, the package sends the stored message body again and the new outgoing message is logged as a new email log row. The original row is also updated with resend counters.

Resending behavior

The resend action supports two common cases:

Resend to original recipients

Use the default modal values and resend the email exactly as logged.

Resend to corrected recipients

Disable Send to original recipients, then enter one or more corrected addresses in Additional or corrected recipients.

This is useful when:

• a user registered the wrong email address
• the original recipient mailbox is no longer valid
• you need to resend only to a replacement address

The resent copy stores audit metadata so administrators can understand:

• which log was the source
• who triggered the resend
• what note was attached
• where the resent copy was delivered

Authorization patterns

This package is intentionally flexible because each project handles admin access differently.

Option 1: custom callback

Best when your app already has its own user methods or role logic.

->plugin(
    FilamentEmailLogsPlugin::make()
        ->authorizeUsing(fn (?User $user): bool => $user?->canManageSystem() ?? false)
)

Option 2: ability-based fallback

Best when your app uses Laravel policies, gates, or a permission package.

// config/filament-email-logs.php
'authorization' => [
    'ability' => 'view email logs',
],

Then register the plugin without a callback:

->plugin(FilamentEmailLogsPlugin::make())

Relationship to .env mail settings

This package does not manage your mail transport settings.

It uses whatever Laravel mail configuration is already active in your application, which usually comes from:

• .env
• config/mail.php
• any runtime mail configuration overrides your application applies

That means:

• the package logs sent mail
• the package resends through the currently active mailer configuration
• the package does not edit .env

Future admin-managed email settings

If you later build a dedicated admin page for SMTP or mailer settings, the recommended approach is:

1. Keep .env as the server-level fallback
2. Store admin-editable mail settings in the database
3. Build the active Laravel mail configuration at runtime from database settings
4. Let this package continue logging and resending through that active configuration

In that setup, this package does not need special changes to benefit from the admin-managed mail settings. It will automatically use the currently configured mailer at send time.

Package structure

• src/FilamentEmailLogsServiceProvider.php Registers config, migrations, views, policy, and the mail listener.
• src/FilamentEmailLogsPlugin.php Registers the Filament resource and package-level plugin options.
• src/Filament/Resources/EmailLogs Filament resource, pages, infolist, table, and resend action.
• src/Services/EmailLogResender.php Resend orchestration and recipient resolution.
• src/Listeners/LogSentEmail.php Persists sent mail to the database.
• src/Models/EmailLog.php The email log model with resend lineage helpers.

Development notes

This repository currently consumes the package through a local Composer path repository. That makes it easy to continue development here and later move the package into its own repository without changing the package namespace or structure.

Testing

Focused verification in this host app:

./vendor/bin/pest tests/Feature/EmailLogResourceTest.php tests/Feature/UserRoleAccessTest.php
vendor/bin/pint --dirty --format agent