PHPackages tapp/filament-maillog - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Logging & Monitoring](/categories/logging) 4. / 5. tapp/filament-maillog ActiveLibrary[Logging & Monitoring](/categories/logging) tapp/filament-maillog ===================== Filament plugin to view outgoing mail v2.2.1(3w ago)3070.3k↓29.2%141MITPHPPHP ^8.3CI passing Since Apr 15Pushed 3w ago6 watchersCompare [ Source](https://github.com/TappNetwork/filament-maillog)[ Packagist](https://packagist.org/packages/tapp/filament-maillog)[ Docs](https://github.com/tapp/filament-maillog)[ GitHub Sponsors](https://github.com/TappNetwork)[ RSS](/packages/tapp-filament-maillog/feed)WikiDiscussions 2.x Synced 4d ago READMEChangelog (10)Dependencies (58)Versions (33)Used By (1) Filament plugin to view outgoing mail ===================================== [](#filament-plugin-to-view-outgoing-mail) [![Latest Version on Packagist](https://camo.githubusercontent.com/3a9a9a0d4156397ff4cf11804668acf1e45df496f631658a896088333e8736f3/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f746170702f66696c616d656e742d6d61696c6c6f672e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/tapp/filament-maillog)[![GitHub Tests Action Status](https://github.com/TappNetwork/filament-maillog/actions/workflows/run-tests.yml/badge.svg)](https://github.com/TappNetwork/filament-maillog/actions/workflows/run-tests.yml/badge.svg)[![GitHub Code Style Action Status](https://github.com/TappNetwork/filament-maillog/actions/workflows/fix-php-code-style-issues.yml/badge.svg)](https://github.com/TappNetwork/filament-maillog/actions/workflows/fix-php-code-style-issues.yml/badge.svg)[![Total Downloads](https://camo.githubusercontent.com/ee8750d98e9d4225e523b9accda55df344f317cd58b34f3429c7dc2be48ec2af/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f746170702f66696c616d656e742d6d61696c6c6f672e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/tapp/filament-maillog) This plugin adds an event listener to log emails sent on `mail_logs` database table. It also adds a Filament resource to view the mail logs. Version Compatibility --------------------- [](#version-compatibility) FilamentFilament MailLogDocumentation4.x/5.x2.xCurrent3.x1.x[Check the docs](https://github.com/TappNetwork/filament-maillog/tree/1.x)Installation ------------ [](#installation) You can install the package via Composer: ``` composer require tapp/filament-maillog:"^2.0" ``` You can publish the config file with: ``` php artisan vendor:publish --tag="filament-maillog-config" ``` This is the contents of the published config file: ``` return [ 'amazon-ses' => [ 'configuration-set' => null, ], 'resources' => [ 'MailLogResource' => \Tapp\FilamentMailLog\Resources\MailLogResource::class, ], 'navigation' => [ 'maillog' => [ 'register' => true, 'sort' => 1, 'icon' => 'heroicon-o-rectangle-stack', ], ], 'sort' => [ 'column' => 'created_at', 'direction' => 'desc', ], 'tenancy' => [ 'enabled' => env('FILAMENT_MAILLOG_TENANCY_ENABLED', false), 'model' => null, // e.g. \App\Models\Team::class 'relationship_name' => env('FILAMENT_MAILLOG_TENANCY_RELATIONSHIP_NAME', null), 'column' => env('FILAMENT_MAILLOG_TENANCY_COLUMN', null), 'nullable' => env('FILAMENT_MAILLOG_TENANCY_NULLABLE', true), 'foreign_key' => [ 'on_delete' => env('FILAMENT_MAILLOG_TENANCY_ON_DELETE', 'cascade'), 'on_update' => env('FILAMENT_MAILLOG_TENANCY_ON_UPDATE', 'cascade'), ], 'auto_assign' => env('FILAMENT_MAILLOG_TENANCY_AUTO_ASSIGN', true), ], ]; ``` You can publish and run the migrations with: ``` php artisan vendor:publish --tag="filament-maillog-migrations" php artisan migrate ``` > **Warning:** If you use multi-tenancy, configure tenancy **before** publishing and running migrations. See "Multi-Tenancy Support" below. Optionally, you can publish the translations files with: ``` php artisan vendor:publish --tag="filament-maillog-translations" ``` Using the Resource ------------------ [](#using-the-resource) Add this plugin to a panel on `plugins()` method. E.g. in `app/Providers/Filament/AdminPanelProvider.php`: ``` use Tapp\FilamentMailLog\FilamentMailLogPlugin; public function panel(Panel $panel): Panel { return $panel // ... ->plugins([ FilamentMailLogPlugin::make(), //... ]); } ``` Multi-Tenancy Support --------------------- [](#multi-tenancy-support) Mail log entries can be scoped to a tenant (e.g. team or organization) when your Filament panel uses tenancy. ### Setup [](#setup) 1. **Configure tenancy before migrations** Publish the config and set in `config/filament-maillog.php`: ``` 'tenancy' => [ 'enabled' => true, 'model' => \App\Models\Team::class, 'relationship_name' => 'team', 'column' => 'team_id', 'nullable' => true, 'auto_assign' => true, ], ``` Or use env vars: `FILAMENT_MAILLOG_TENANCY_ENABLED=true`, `FILAMENT_MAILLOG_TENANCY_COLUMN=team_id`, etc. 2. **Publish and run migrations** The `mail_logs` table will get the tenant foreign key when tenancy is enabled: ``` php artisan vendor:publish --tag="filament-maillog-migrations" php artisan migrate ``` 3. **Panel** Ensure your panel uses the same tenant model, e.g. `->tenant(\App\Models\Team::class)`. When tenancy is enabled, the resource is scoped to the current tenant and new mail logs are associated with the current tenant. The tenant column is nullable by default so emails sent before a tenant context exists, such as registration or verification messages, can still be logged. Testing ------- [](#testing) ``` composer test ``` Changelog --------- [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently. Contributing ------------ [](#contributing) Please see [CONTRIBUTING](CONTRIBUTING.md) for details. Security Vulnerabilities ------------------------ [](#security-vulnerabilities) Please review [our security policy](../../security/policy) on how to report security vulnerabilities. Credits ------- [](#credits) - [Steve Williamson](https://github.com/swilla) - [All Contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 61 — FairBetter than 98% of packages Maintenance95 Actively maintained with recent releases Popularity44 Moderate usage in the ecosystem Community25 Small or concentrated contributor base Maturity67 Established project with proven stability Bus Factor2 2 contributors hold 50%+ of commits How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~37 days Recently: every ~16 days Total 22 Last Release 15d ago Major Versions v1.0.7 → v2.0.02025-06-19 v1.0.8 → v2.0.12025-12-17 1.x-dev → v2.0.22026-01-20 PHP version history (2 changes)v1.0.0PHP ^8.2 v2.1.2PHP ^8.3 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/837400?v=4)[tapp](/maintainers/tapp)[@tapp](https://github.com/tapp) --- Top Contributors [![swilla](https://avatars.githubusercontent.com/u/304159?v=4)](https://github.com/swilla "swilla (63 commits)")[![andreia](https://avatars.githubusercontent.com/u/38911?v=4)](https://github.com/andreia "andreia (44 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (14 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (9 commits)")[![scottgrayson](https://avatars.githubusercontent.com/u/7796074?v=4)](https://github.com/scottgrayson "scottgrayson (4 commits)")[![laravel-shift](https://avatars.githubusercontent.com/u/15991828?v=4)](https://github.com/laravel-shift "laravel-shift (2 commits)")[![csh-tech](https://avatars.githubusercontent.com/u/232831869?v=4)](https://github.com/csh-tech "csh-tech (2 commits)")[![carloeusebi](https://avatars.githubusercontent.com/u/129429172?v=4)](https://github.com/carloeusebi "carloeusebi (1 commits)")[![LeanderVanBaekel](https://avatars.githubusercontent.com/u/6113314?v=4)](https://github.com/LeanderVanBaekel "LeanderVanBaekel (1 commits)")[![pvullioud](https://avatars.githubusercontent.com/u/3446410?v=4)](https://github.com/pvullioud "pvullioud (1 commits)")[![samuelterra22](https://avatars.githubusercontent.com/u/11915449?v=4)](https://github.com/samuelterra22 "samuelterra22 (1 commits)") --- Tags filamentfilament-pluginfilamentphplaravelloggingmailmailloglaraveltapp networkmaillogfilament-maillog ### Code Quality TestsPest Static AnalysisPHPStan Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/tapp-filament-maillog/health.svg) ``` [![Health](https://phpackages.com/badges/tapp-filament-maillog/health.svg)](https://phpackages.com/packages/tapp-filament-maillog) ``` ### Alternatives [rawilk/profile-filament-plugin Profile & MFA starter kit for filament. 3914.6k](/packages/rawilk-profile-filament-plugin)[spatie/laravel-pdf Create PDFs in Laravel apps 1.0k4.8M47](/packages/spatie-laravel-pdf)[stephenjude/filament-jetstream A Laravel starter kit built with Filament inspired by Jetstream. 17760.2k3](/packages/stephenjude-filament-jetstream)[stephenjude/filament-debugger About 104162.2k2](/packages/stephenjude-filament-debugger)[croustibat/filament-jobs-monitor Background Jobs monitoring like Horizon for all drivers for FilamentPHP 274327.2k9](/packages/croustibat-filament-jobs-monitor)[finity-labs/fin-mail A powerful email template manager and composer for Filament with dynamic token replacement, template versioning, and inline email sending. 284.5k1](/packages/finity-labs-fin-mail) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)