README

此包为 Laravel 添加了一个自定义的 Maileon 邮件驱动程序。

需要在 Maileon 用户界面中进行一些配置。

要求

• laravel/laravel:^8.0 || ^.0
• bensampo/laravel-enum:^6.1.0
• guzzlehttp/psr7:^1.8
• php-http/discovery:^1.14
• psr/http-client:^1.0
• psr/http-message:^1.0

安装

安装包

composer require dennis-koster/laravel-maileon

发布配置文件

php artisan vendor:publish --provider="DennisKoster\\LaravelMaileon\\Providers\\LaravelMaileonServiceProvider"

将缺少的环境变量添加到您的 .env 文件中

MAILEON_API_URL=
MAILEON_API_KEY=
MAILEON_TRANSACTIONAL_CONTACT_EVENT=

配置 Maileon

Maileon 默认不支持发送事务性邮件。我们需要在 Maileon 界面中进行几个步骤来设置一切。

1. 创建联系人事件

登录后，在顶部菜单中选择“列表与联系人”。然后在左侧菜单中点击“联系人事件”，再点击“创建新的联系人事件”按钮。

使用以下设置

Name: API_Transactional
Description: Contact event used for sending transactional emails
Further processing: Enabled
Retention period: 30 Days

然后创建以下两个字段

Name: subject
Description: Subject of the email
Mandatory: Yes
Format: Text

Name: body_html
Description: The HTML content of the email
Mandatory: Yes
Format: JSON (!! Very important and counter-intuitive)

2. 设置触发器

在顶部菜单中点击“邮件”，然后在左侧菜单中导航到“触发草稿”。然后点击 [new trigger draft] 按钮。

当提示时，选择“新内容编辑器”选项。

输入一个易于识别的名字，例如“事务性邮件”

对于主题，点击输入字段右侧的蓝色 [.] 图标。选择类型 联系人事件（事务性）。然后选择我们刚才创建的联系人事件（API_Transactional）并选择属性 subject。最后，点击 [Insert personalization] 按钮。

输入您的发件人详情，然后点击右下角的蓝色 Continue 按钮。

选择“从头开始”选项。

在拖放编辑器出现时，点击屏幕左下角的 [Drag & drop editor] 按钮，并选择 Code editor。

删除代码编辑器中的所有内容，并替换为以下内容

[[TRANSACTION|"body_html[0]"]]

然后点击右上角的 [Save] 按钮，然后点击 X Close 按钮。

再次点击屏幕右下角的蓝色 Contine 按钮，进入 Dispatch logic & Approval 屏幕。

对于 Mailing logic 类型，选择 Single dispatch for an event，然后对于事件，选择我们创建的触发器（API_Transactional）。

启用 Permission neutral sendout。

最后，点击右下角的 [activate Trigger-mailing] 按钮。