vorakraft10/filament-mails

这是我打包的 filament-mails

dev-main 2024-09-27 14:25 UTC

This package is auto-updated.

Last update: 2024-09-27 14:27:10 UTC


README

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

Filament Mails 可以收集您可能想要跟踪的所有 Filament 应用已发送邮件的信息。本包提供了常见的用例

  • 仅记录特定属性的所有已发送电子邮件
  • 使用查看器在浏览器中查看所有已发送电子邮件
  • 使用 Webhook 收集电子邮件提供商关于交付的反馈
  • 将发送的电子邮件与 Eloquent 模型相关联
  • 当电子邮件退回时自动通知
  • 定期修剪电子邮件日志
  • 将记录的电子邮件重发到另一个收件人

为什么选择这个包

电子邮件作为协议非常容易出错。成功交付电子邮件没有任何保证,因此最好实时监控您的电子邮件发送。使用 Postmark、Mailgun 或 Resend 等外部服务通过提供日志和交付反馈等功能来提高电子邮件的发送,但仍然需要您的关注,并且可能无声无息地失败。因此,我们创建了 Laravel Mails 来填补所有空白。

此包是在 Laravel Mails 的基础上构建的。

Filament Mails

安装

您可以通过 composer 安装此包

composer require vormkracht10/filament-mails

您可以使用以下命令发布和运行迁移

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

您可以使用以下命令发布配置文件

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

可选地,您可以使用以下命令发布视图

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

然后,将插件添加到您的 PanelProvider

use Vormkracht10\FilamentMails\FilamentMailsPlugin;

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

配置

有时您想自定义资源,例如配置哪些用户或角色可以访问资源。您可以通过在 filament-mails 配置文件中覆盖 MailResourceEventResource 类来实现。确保您的自定义资源扩展了原始资源。

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

功能和截图

列出所有已发送电子邮件和统计数据

本包提供了一个清晰的电子邮件概述,包括统计信息和过滤数据的能力。请参阅Filament Mails

重发电子邮件

您可以重发电子邮件到同一个或另一个收件人。当您的电子邮件退回并希望重发时,这非常有用。请参阅Filament Mails

信息

您可以查看有关电子邮件的所有相关信息,例如主题、正文、附件、发件人地址、收件人地址、抄送地址、密送地址、回复地址、元数据和更多。请参阅Filament Mails Filament Mails Filament Mails Filament Mails

预览电子邮件

本软件包提供了邮件的预览功能。这有助于快速检查邮件是否正确。 Filament Mails

我们还提供了邮件的原始HTML和纯文本。 Filament Mails

事件

当发送邮件时,该软件包会记录所有触发的事件。这有助于跟踪邮件发送过程。 Filament Mails Filament Mails

使用方法

..

测试

composer test

变更日志

有关最近更改的更多信息,请参阅 变更日志

贡献

有关详细信息,请参阅 贡献指南

安全漏洞

有关如何报告安全漏洞的详细信息,请参阅 我们的安全策略

鸣谢

许可证

MIT许可证(MIT)。有关更多信息,请参阅 许可证文件