ZURB Foundation for Emails integration into Nette framework consisting of a mail factory to create email messages with nette/latte templates using Inky markup and an optional simple mail service to send the messages.
- PHP 7.0+
- Nette 2.4+
composer require vitrozsival/nette-foundation-emails
mailFactory extension in your config:
Then you can configure the extension with following parameters:
email: 'email@example.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 has only one method called
create to be used with your email messages. It accepts two arguments:
- an absolute path to your own message template
- or a path relative to the configured templates directory path (if using a relative path, you can omit
.latteextension as it will be added if needed)
- if no template is found, the method throws
- an absolute path to your own build of Foundation for Emails stylesheet
- or a path relative to the configured resources directory path
- if none provided, the factory will look for the configured
cssFilenameinside the configured
- if no stylesheet is found at all, default
resources/foundation-emails.min.csswill be used
The mail factory will use any valid Nette
ITranslator from your DI container to translate your messages.
You can also use the simple
MailService that ships with this package to send messages created
MailFactory. The service gets registered with the
MailFactoryExtension therefor it is present in your DI
The service has three methods - to
createMessage through the
MailFactory (this method accepts same arguments
create method of
MailFactory and only returns the resulting message), to create a
link to your website
LinkGenerator and to send the created
sendMessage method throws
if the message could not be sent through Nette
Anyway, feel free to implement the
MailFactory into your own mail service as you need.