vitrozsival/nette-foundation-emails

此包已弃用且不再维护。未建议替代包。

ZURB Foundation for Emails 与 Nette 框架的 Inky 标记集成。

1.0.0 2017-09-29 11:57 UTC

This package is not auto-updated.

Last update: 2020-02-02 11:21:05 UTC


README

ZURB Foundation for Emails 集成到 Nette 框架,包括一个邮件工厂,用于使用 nette/latte 模板和 Inky 标记创建邮件消息,以及一个可选的简单邮件服务来发送消息。

Build Status Coverage Status Packagist License

要求

  • 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 容器中。

该服务有三个方法 - 通过 MailFactorycreateMessage 方法(此方法接受与 MailFactorycreate 方法相同的参数,并仅返回结果消息),使用 Nette LinkGenerator 创建到您网站的 link,以及发送创建的 Message。如果消息无法通过 Nette IMailer 发送,则 sendMessage 方法将抛出 MailServiceException

无论如何,您都可以根据需要将 MailFactory 实现到您自己的邮件服务中。

许可

MIT 许可证