vitrozsival / nette-foundation-emails
此包已弃用且不再维护。未建议替代包。
ZURB Foundation for Emails 与 Nette 框架的 Inky 标记集成。
1.0.0
2017-09-29 11:57 UTC
Requires
- php: >=7.0
- hampe/inky: 1.3.6.2
- nette/application: ^2.4
- nette/di: ^2.4
- nette/mail: ^2.4
- nette/utils: ^2.4
- tijsverkoyen/css-to-inline-styles: ^2.2
Requires (Dev)
- mockery/mockery: ^0.9.9
- nette/tester: ^2.0
- tracy/tracy: ^2.4
This package is not auto-updated.
Last update: 2020-02-02 11:21:05 UTC
README
ZURB Foundation for Emails 集成到 Nette 框架,包括一个邮件工厂,用于使用 nette/latte 模板和 Inky 标记创建邮件消息,以及一个可选的简单邮件服务来发送消息。
要求
- PHP 7.0+
- Nette 2.4+
安装
composer require vitrozsival/nette-foundation-emails
配置
在您的配置中注册 mailFactory
扩展
extensions:
mailFactory: NetteFoundationEmails\DI\MailFactoryExtension
然后您可以使用以下参数配置扩展
mailFactory:
email: 'your@email.com' # default email to be set for messages as 'sent from'
name: 'Your Name' # default name to be set for messages as 'sent from'
cssFilename: 'emails.css' # default stylesheet filename located in resources directory
resourcesDir: ./resources # default resources directory path (stylesheets, images, etc.)
templatesDir: ./templates # default message templates directory path
用法
MailFactory
只有一个名为 create
的方法,用于与您的邮件消息一起使用。它接受两个参数
messageTemplate
- 到您自己的消息模板的绝对路径
- 或相对于配置的模板目录路径的路径(如果使用相对路径,您可以省略
.latte
扩展名,因为如果需要,将会添加它) - 如果没有找到模板,该方法将抛出
MailFactoryException
cssFile
(可选)
- 到您自己的 Foundation for Emails 样式表构建的绝对路径
- 或相对于配置的资源目录路径的路径
- 如果没有提供,工厂将在配置的
resourcesDir
中查找配置的cssFilename
- 如果找不到任何样式表,将使用默认的
resources/foundation-emails.min.css
邮件工厂将使用您的 DI 容器中的任何有效的 Nette ITranslator
来翻译您的消息。
邮件服务
您还可以使用此包附带简单的 MailService
来发送使用 MailFactory
创建的消息。服务通过 MailFactoryExtension
注册,因此它存在于您的 DI 容器中。
该服务有三个方法 - 通过 MailFactory
的 createMessage
方法(此方法接受与 MailFactory
的 create
方法相同的参数,并仅返回结果消息),使用 Nette LinkGenerator
创建到您网站的 link
,以及发送创建的 Message
。如果消息无法通过 Nette IMailer
发送,则 sendMessage
方法将抛出 MailServiceException
。
无论如何,您都可以根据需要将 MailFactory
实现到您自己的邮件服务中。