MailEssentials can be configured to send notification emails to administrators and users based on various events (e.g. notifications for failed messages, quarantined messages, etc). Such emails are built from standard templates that are stored in the GFI MailEssentials installation directory.
This article describes how to customize the static contents of these notification messages. Administrators with basic experience in stylesheet customizations (XSLT) and XML may customize the design and content of the notification templates.
This article describes two methods of modifying the standard notification templates. Administrative access to the MailEssentials configuration console is required. In addition, if modifying the templates by editing template files, you will require Windows Administrative privileges to access and edit the templates in the MailEssentials installation directory.
It is recommended to use a text editor with XML syntax highlighting for convenient schema validation if making the modifications through editing the template files directly.
- Template modifications are for advanced users only. Be sure to preserve the structure of the template, special tags as well as the structure of the HTML syntax to avoid display issues in email notifications.
- GFI MailEssentials Support Team does not provide help or support in customizing the templates or resolving any issues arising from the customization of the templates. You are advised to take a backup of the templates before modifying them.
- The subject prefix text for sanitized emails which by default reads "GFI MailEssentials sanitized email" is not configurable from the templates and can therefore not be changed or presented in a different language.
The Templates node which is accessed by navigating to GFI MailEssentials > General Settings > Templates lists the various notification templates that are available in MailEssentials. The templates are located in the installation directory under
..\GFI\MailEssentials\Templates. A template's name from the UI mirrors the folder name on disk. Each template has a link to edit the template.
Administrators can edit templates to customize their design and content. There are two ways to do this which are outlined below:
Editing through the Configuration Console
To edit a template from the MailEssentials Configuration UI:
- From the GFI MailEssentials Configuration, go to General Settings > Templates.
- Click the template you want to edit to open the Template modification screen. The below screenshot shows the licasevalexpired template that is sent to the Administrator when the AntiSpam evaluation license has expired.
- The following options will be available as separate tabs depending on the email template. Most templates, however, will only have the first two tabs i.e. Subject and Text.
|Subject||Edit the email Subject|
|Text||Edit the plain text version of the email body.|
|HTML||Edit the HTML version of the email body.|
|Images||Change inline images for HTML emails. Click Edit and Choose File.|
- Edit the template as desired and click Apply to save the changes.
Editing through the Template Files
The templates are stored as plain text files at
..\GFI\MailEssentials\Templates with different folders corresponding to the template names visible under GFI MailEssentials > General Settings > Templates on the configuration UI.
To edit a template from the text file:
- Browse to ...\GFI\MailEssentials\Templates located in the MailEssentials installation directory. The notification templates text files are found there.
- Open the notification template you would like to edit in a text editor and make the required changes. The subject and body of the messages can be modified.
- Save the changes.
- Restart the GFI Services and the IIS Admin Service (and all dependencies) for the changes to take effect.
The above changes can be confirmed by inspecting the relevant notification emails that have been triggered after the changes have been made.