da-insys / mailing
Dainsys 的邮件和收件人管理包。此包允许您将收件人关联到您的邮件文件。
v1.2.3
2023-03-13 13:04 UTC
Requires
- illuminate/support: ^8.0|9.0
- laravel/ui: ^3.0|4.0
- livewire/livewire: ^2.10
- php-flasher/flasher-laravel: ^1.7
- rappasoft/laravel-livewire-tables: ^2.8
Requires (Dev)
- nunomaduro/collision: v5.x-dev
- orchestra/testbench: 6.x-dev
- phpunit/php-code-coverage: 9.2.x-dev
README
一个全栈包,用于向 Laravel 应用程序添加邮件功能。此包允许您将收件人(联系人)关联到您的邮件文件。
安装
- 需要使用 composer:
composer require dainsys/mailing
。 - 您可以通过运行
php artisan mailing:install
命令安装所有包资产。- 另一种选择是单独安装每个资产
- 发布资产:
@php artisan vendor:publish --force --tag=mailing:assets
。- 可选地,您可以在
composer
文件中scripts
和post-update-cmd
键下添加以下行,以便在更新您的 composer 依赖项时发布资产:@php artisan vendor:publish --tag=mailing:assets --force --ansi
。
- 可选地,您可以在
- 发布资产:
- 如果您想在下一步之前自定义迁移,首先发布它们:
@php artisan vendor:publish --force --tag=mailing:migrations
。 - 运行迁移:
php artisan migrate
。
- 另一种选择是单独安装每个资产
- 只有超级管理员用户可以与应用程序交互。您可以使用以下任何一种选项来注册他们
- 使用您的
AuthServiceProvider
的注册方法:\Dainsys\Mailing\Mailing::registerSuperUsers(["super@user1.com", "super@user2.com"]);
。 - 在您的
.env
文件中,MAILING_SUPER_USERS='super@user1.com,super@user2.com'
- 使用您的
配置您的应用程序
- 访问包主路由:
/dainsys/mailing/about
。 - 可选地,您可能想发布并调整配置文件:
@php artisan vendor:publish --force --tag=mailing:config
。 - 此包有自己的视图,使用 livewire 和 AdminLte 设计。然而,如果您想更改它们,则可以使用
@php artisan vendor:publish --force --tag=mailing:views
发布它们。 - 包视图扩展其自己的布局应用。然而,您可以通过在
.env
文件中添加密钥MAILING_LAYOUT_VIEW
或者在mailing
配置文件下的layout
键中直接更改它来更改此设置。
用法
- 该包配置为自动发现
app\Mail
目录中的邮件。但是,如果您的邮件位于该文件夹之外或您想注册另一个目录,请将\Dainsys\Mailing\Mailing::bind(app_path('Mail'));
行添加到您的AppServiceProvider
中。包将尝试加载所有添加的目录中的邮件。 - 访问路由
/mailing/admin/recipients
来管理您的收件人联系人。 - 访问路由
/mailing/admin/mailables
来管理您的邮件并将它们分配给收件人。 - 在您的邮件中,您可以使用代码片段
\Dainsys\Mailing\Mailing::recipients($this);
访问与该类关联的收件人数组。例如,->to(\Dainsys\Mailing\Mailing::recipients($this))