This module provides a configurable system for managing and sending emails. It allows site administrators to define and customize system emails, such as those for user registration or password resets, using a configuration entity. The module also offers a service for sending emails from any entity that implements a specific interface, aiming to replace the traditional hook_mail() system.
Provides a config entity for system emails, and a service for mailing any entity which implements the interface.
This project is intended as a testing ground for replacing hook_mail() in core: see https://www.drupal.org/node/1346036 for details.
Overview
This module's mail message entity type is intended for system emails, that is, emails where the text is initially defined in code, possibly configurable, and may be processed to have tokens replaced. Examples include user registration and password reset, content subscription emails, Commerce order emails, moderation notification emails, event reminder emails, and so on.
A mail message entity can define which mail backend to use, to override the site setting, and which mail processor plugin to use. The processor plugin does the equivalent work of hook_mail(): replaces tokens, and so on.
Modules using this system define their emails as default config entities. The 'group' property on mail message entities allows the creation of an admin list that only shows the mail message entities for a particular group, which modules defining messages can use to create an admin UI for editing their own emails. The Mail Example submodule provides an example of doing this.