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 &amp; Monitoring](/categories/logging)
4. /
5. tapp/filament-maillog

ActiveLibrary[Logging &amp; Monitoring](/categories/logging)

tapp/filament-maillog
=====================

Filament plugin to view outgoing mail

v2.1.0(2mo ago)2952.6k—3.1%141MITPHPPHP ^8.2CI passing

Since Apr 15Pushed 1mo 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 1mo ago

READMEChangelog (10)Dependencies (30)Versions (25)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),
        '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',
        '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.

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

57

—

FairBetter than 98% of packages

Maintenance88

Actively maintained with recent releases

Popularity43

Moderate usage in the ecosystem

Community24

Small or concentrated contributor base

Maturity63

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 ~41 days

Recently: every ~9 days

Total

18

Last Release

58d 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

### Community

Maintainers

![](https://www.gravatar.com/avatar/d72a8c345b7f4205dc1edaff8d05ce78f7fe1ec93dce0e52d29f18e885508d4f?d=identicon)[tapp](/maintainers/tapp)

---

Top Contributors

[![swilla](https://avatars.githubusercontent.com/u/304159?v=4)](https://github.com/swilla "swilla (51 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] (12 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (8 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)")[![LeanderVanBaekel](https://avatars.githubusercontent.com/u/6113314?v=4)](https://github.com/LeanderVanBaekel "LeanderVanBaekel (1 commits)")[![samuelterra22](https://avatars.githubusercontent.com/u/11915449?v=4)](https://github.com/samuelterra22 "samuelterra22 (1 commits)")[![carloeusebi](https://avatars.githubusercontent.com/u/129429172?v=4)](https://github.com/carloeusebi "carloeusebi (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

[spatie/laravel-health

Monitor the health of a Laravel application

86910.0M83](/packages/spatie-laravel-health)[spatie/laravel-slack-alerts

Send a message to Slack

3212.6M4](/packages/spatie-laravel-slack-alerts)[keepsuit/laravel-opentelemetry

OpenTelemetry integration for laravel

142347.8k](/packages/keepsuit-laravel-opentelemetry)[spatie/laravel-error-share

Share your Laravel errors to Flare

43965.6k3](/packages/spatie-laravel-error-share)[dotswan/filament-laravel-pulse

82137.2k1](/packages/dotswan-filament-laravel-pulse)[tapp/filament-google-autocomplete-field

Filament plugin that provides a Google Autocomplete field

3098.1k](/packages/tapp-filament-google-autocomplete-field)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
