Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ramnzys/filament-email-log

This package provides a Filament resource to view all Laravel sent emails.
https://github.com/ramnzys/filament-email-log

admin-panel filament laravel-package

Last synced: about 1 month ago
JSON representation

This package provides a Filament resource to view all Laravel sent emails.

Awesome Lists containing this project

README

        

![](https://banners.beyondco.de/filament-email-log.png?theme=light&packageManager=composer+require&packageName=ramnzys%2Ffilament-email-log&pattern=autumn&style=style_1&description=Laravel+sent+email+log+on+filament+dashboard&md=1&showWatermark=1&fontSize=100px&images=https%3A%2F%2Flaravel.com%2Fimg%2Flogomark.min.svg)

[![Latest Version on Packagist](https://img.shields.io/packagist/v/ramnzys/filament-email-log.svg?style=flat-square)](https://packagist.org/packages/ramnzys/filament-email-log)
[![GitHub Tests Action Status](https://img.shields.io/github/workflow/status/ramnzys/filament-email-log/run-tests?label=tests)](https://github.com/ramnzys/filament-email-log/actions?query=workflow%3Arun-tests+branch%3Amain)
[![GitHub Code Style Action Status](https://img.shields.io/github/workflow/status/ramnzys/filament-email-log/Check%20&%20fix%20styling?label=code%20style)](https://github.com/ramnzys/filament-email-log/actions?query=workflow%3A"Check+%26+fix+styling"+branch%3Amain)
[![Total Downloads](https://img.shields.io/packagist/dt/ramnzys/filament-email-log.svg?style=flat-square)](https://packagist.org/packages/ramnzys/filament-email-log)

This package provides a Filament resource to view all Laravel outgoing emails. It also provides a Model for the database stored emails.

## Installation

You can install the package via composer:

```bash
composer require ramnzys/filament-email-log
```

You can publish and run the migrations with:

```bash
php artisan vendor:publish --tag="filament-email-log-migrations"
php artisan migrate
```

You can publish the config file with:

```bash
php artisan vendor:publish --tag="filament-email-log-config"
```

This is the contents of the published config file:

```php
return [

'resource' => [
'group' => null,
'sort' => null,
],

'keep_email_for_days' => 90,

];
```

## Usage

This package will automatically register the `EmailResource`. You will be able to see it when you visit your Filament admin panel.

### Customization

**Group and sort order**. You can customize the navigation group for the `EmailResource` by publishing the configuration file and updating the `resource.group` and `resource.sort` values.

**Prunable model**. You can customize how many days to keep the email in the database by updating the `keep_email_for_days` value. Then you can use or schedule the command `artisan model:prune --model="Ramnzys\FilamentEmailLog\Models\Email"`. This will delete emails older than `keep_email_for_days` days old.
## Testing

```bash
composer test
```

## Changelog

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

## Contributing

Contributions are welcome. Please see [CONTRIBUTING](.github/CONTRIBUTING.md) for details.

## Credits

- [Ramón E. Zayas](https://github.com/ramnzys)
- [All Contributors](../../contributors)

## License

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.