Documentation
Email templates
Email templates can contain plain text or HTML markup and are used as templates for the emails that are sent to the subscribers. Every single email that is added to the email queue is constructed from the email template that is assigned to the respective notification event.
Email templates can contain any of the following placeholders. Placeholders are special text strings that are dynamically replaced by the appropriate content when an email is constructed and added to the email queue.
Placeholders | Description |
---|---|
[NOTIFICATION_DATE] |
Date of notification event. |
[RECIPIENT_NAME] |
Name of email recipient. |
[OBJECT_ID] |
ID of notification object. |
[OBJECT_TYPE] |
Type of notification object. Applies only for subscribe/unsubscribe emails. |
[OBJECT_TITLE] |
Title of notification object. |
[OBJECT_URL] |
Front-end URL of notification object. |
[AUTHOR_NAME] |
Name of notification object author. |
[PARENT_TITLE] |
Title of notification object parent. Depends on user subscription type (category, author, tag). Does not apply if user has subscribed directly to an article. |
[PARENT_URL] |
Front-end URL of notification object parent. |
[SITE_NAME] |
Site name. |
[SITE_URL] |
Site URL. |
[SUBSCRIBE_URL] |
Subscription verification URL. Applies only for subscribe email. |
[UNSUBSCRIBE_URL] |
Unsubscribe URL. |
Default email templates
Default email templates are automatically assigned to a notification event according to the notification event type and language. For example, if you have created a notification event for an article that is available only in english (en-GB), then the email template of that specific language (en-GB) will be assigned automatically to that notification event.
If an email template for a particular language does not exist, then the email template with language All will be used by default.
Info
In multi-language sites, the most recent and published default email template for a specific language will be used as an email template for that language.
Custom email templates
Custom email templates are very handy when you want to create email notifications with special content. Instead of editing the default email templates every time, you can create as many custom email templates as you want and use them instead.
Info
Custom email templates inherit language settings from the parent notification event.