Home

Awesome

Filament Mails

Latest Version on Packagist GitHub Tests Action Status GitHub Code Style Action Status Total Downloads

Nice to meet you, we're Vormkracht10

Hi! We are a web development agency from Nijmegen in the Netherlands and we use Laravel for everything: advanced websites with a lot of bells and whitles and large web applications.

About the package

Filament Mails can collect everything you might want to track about the mails that has been sent by your Filament app. Common use cases are provided in this package:

Upcoming features

Why this package

Email as a protocol is very error prone. Succesfull email delivery is not guaranteed in any way, so it is best to monitor your email sending realtime. Using external services like Postmark, Mailgun or Resend email gets better by offering things like logging and delivery feedback, but it still needs your attention and can fail silently but horendously. Therefore we created Laravel Mails that fills in all the gaps.

The package is built on top of Laravel Mails.

Filament Mails

Installation

You can install the package via composer:

composer require vormkracht10/filament-mails

You can publish and run the migrations with:

php artisan vendor:publish --tag="mails-migrations"
php artisan migrate

You can publish the config file with:

php artisan vendor:publish --tag="mails-config"
php artisan vendor:publish --tag="filament-mails-config"

Optionally, you can publish the views using

php artisan vendor:publish --tag="filament-mails-views"

Then add the plugin to your PanelProvider

use Vormkracht10\FilamentMails\FilamentMailsPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugin(FilamentMailsPlugin::make());
}

[!IMPORTANT] For setting up the webhooks to register mail events, please look into the README of Laravel Mails, the underlying package that powers this package.

Configuration

Sometimes you want to customize the resource, like configuring which users or roles may access the resource. You can do this by overriding the MailResource or EventResource classes in the filament-mails config file. Make sure your custom resource extends the original resource.

return [
    'resources' => [
        'mail' => \App\Filament\Resources\MailResource::class,
        'event' => \App\Filament\Resources\EventResource::class,
    ],
];

Features and screenshots

List with all sent emails and statistics

The package provides a clear overview of all emails, including statistics and the ability to filter the data. Filament Mails

Resending emails

You can resend emails to the same or another recipient(s). This is useful when your email has bounced and you want to resend it. Filament Mails

Information

You can view all relevant information about the email, such as the subject, the body, the attachments, the from address, the to address(es), the cc address(es), the bcc address(es), the reply to address, metadata and much more. Filament Mails Filament Mails Filament Mails Filament Mails

Preview email

The package provides a preview of the email. This is useful to quickly check if the email is correct. Filament Mails

We also provide the raw HTML and plain text of the email. Filament Mails

Events

The package also logs all events that are fired when an email is sent. This is useful to track the email sending process. Filament Mails Filament Mails

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

License

The MIT License (MIT). Please see License File for more information.