README

Form Mail

一个用于捕获提交的字段并向收件人发送响应的 Laravel 扩展包。

配置

• 将提供者添加到你的 config/app.php 文件中

    Pbc\FormMail\Providers\FormMailServiceProvider::class,
    Pbc\FormMailTemplate\Providers\FormMailTemplateServiceProvider::class,

• 运行 php artisan vendor:publish 以获取此包的配置和数据库迁移。
• 运行 php artisan migrate 以安装包表

配置

• branding 字符串用于品牌电子邮件消息
• rules 额外的表单验证字段
• queue 是否排队此消息或立即发送
• confirmation 是否发送确认消息

约定

收件人

此包将使用当前路由生成消息的电子邮件收件人。例如，如果存在路由 "contact-us" 且当前网站的 APP_URL 是 "http://www.example.com"，则收件人将是 "contact-us@example.com"。

字段

默认情况下，此包需要三个字段（除 CSRF 之外）

• name，必需
• email，必需且为有效电子邮件
• fields，必需且必须为数组。字段列表用于在响应中标记字段。数组应格式化为 ['field_name'=>'Field Label']。如果找不到特定字段的标签，则将使用字段名称。

任何其他必需字段都可以添加到 config/form_mail.php 配置文件中。

与语言一样，您可以使用路由名称作为规则所在位置的键，为路径添加特定的规则。

品牌

将图形/html/等添加到品牌配置项中，它将注入电子邮件消息的顶部。如果缺少品牌，则品牌将默认为语言字符串 ':domain :form Form'。

消息

要将文字（成功消息、下一步操作等）添加到消息的顶部，请在 resources/lang/vendor/pbc_form_mail/en/body.php 中添加一行，使用路由名称和以下键

• recipient 用于发送给收件人的电子邮件
• sender 用于 Pbc\FormMail\Http\Controllers\FormMailController@requestHandler 的返回值以及如果选项已开启的确认消息。

例如，如果您有一个指向 App\Http\Controllers\FormController@send 的路由，您将格式化消息数组如下

'form' => [
        'send' => [
            'sender' => 'Thanks for filling out the :form form,  we will get back to you as soon as possible! This is a summary of the form you submitted. A copy of this form will be forwarded to :recipient.',
            'recipient' => 'A new response from the :form was submitted at :time from :domain.',
            'subject' => [
                'sender' => 'Your form message has been received!',
                'recipient' => 'A new form submission created on :url',
            ]
        ]

自定义主题行

有一个助手可以自动为消息创建主题。如果您想要自定义主题，请添加一个包含键 subject 的数组，其中包含 sender 和 recipient 键，就像上面的例子一样。