README

通过添加以下内容使 CakePHP 3 的 Email 功能更加强大：

• 默认电子邮件布局，具有基本样式（适用于电子邮件）
• 扩展 HtmlHelper 的 EmailHelper，以自动格式化段落、链接等。
• 内置对主要提供商的支持/配置（Mailchimp、Sendgrid、Mandrill 等）- 即将推出。
• 管理员电子邮件预览 - 即将推出。

安装

使用 Composer

composer require gourmet/email:~3.0

然后您需要加载插件。在 boostrap.php 中，例如

\Cake\Core\Plugin::load('Gourmet/Email');

使用方法

在 config/app.php 中更改您的 default 电子邮件配置（或创建一个新的配置）

'Email' => [
	'default' => [
		'transport' => 'default',
		'from' => 'you@localhost',
		'layout' => 'Gourmet/Email.default',
		'helpers' => ['Html', 'Gourmet/Email.Email'],
		'emailFormat' => 'both',
	]
]

在您的电子邮件视图中，现在可以使用 Gourmet/Email.Email 助手

// app/Template/Email/html/welcome.ctp
Welcome <?= $user['username'] ?>

Please confirm your account by clicking on the link below:

<?= $this->Email->link('Confirm account', '/') ?>

If for any reason, you are unable to click the link above, copy/paste the following to your browser's address bar:

<?= \Cake\Routing\Router::url('/') ?>

Thank you for choosing us,

Company name

<?= $this->Email->image('logo.jpg') ?>

对于 text 版本，您只需要创建一个符号链接到相同的模板。我们将把所有 text 模板符号链接到 html

$ ln -s html app/Template/Email/text

现在可以发送电子邮件了

$email = new Email();
$email->to('john@doe.com');
$email->template('welcome');
$email->viewVars(['user' => ['username' => 'johndoe']]);
$email->send();

补丁与功能

• 分支
• 修改、修复
• 测试 - 这非常重要，以确保不会意外地破坏它
• 提交 - 不要修改许可、todo、版本等。（如果您确实修改了任何，请将它们分别提交，以便我可以忽略它们在拉取时所做的更改）
• 拉取请求 - 主题分支将获得额外加分

错误与反馈

http://github.com/gourmet/emails/issues

许可

版权（c）2014，Jad Bitar，许可协议为 MIT 许可证。