Explained: Notification templates – Agylia Support

Introduction

The Agylia LMS sends emails to both admins and learners in various circumstances. For example, confirmation emails are sent when a user registers interest in an event, or enrols on a specific session of an event.

The emails sent by the system are based on pre-defined templates, which are supplied as defaults with the initial LMS implementation. Global administrators can customise these system level default templates, to match their requirements.

In addition, global administrators and content administrators can override the system-level email templates at the content item level. Customising the content item level templates, will for example, allow you to create content specific completion or enrolment emails per content item.

System-level templates

The system-level defaults can be viewed in the Administration portal on the Settings | Notification templates page.

The page displays the following information per template:

TEMPLATE. The template name and description
ITEM OVERRIDES. The number of times the template has been overridden with content item specific template definitions.
STATUS. Whether the template uses the system default template definition or has been overridden by an admin. Where an email template uses the default system level email template, it is displayed with a STATUS of Default. Where the email template has been customised, it is displayed with a STATUS of Custom.
Edit Config (). Edit config allows admins to configure whether the system should send the associated notification. The notification can be either Enabled or Disabled.

Global administrators can customise the email templates, using the template editing feature.

To edit an email template, click the template you wish to edit. For example, the Content - Complete email template (which is used when an email is sent to learners when they complete an item, where the item has been configured to send a completion email) shown below:

You can change the template wording, formatting, and use placeholders (such as the content items title), which are replaced with user or context specific values when an email is sent.

Each email template has a set of placeholders, that are appropriate for the template that you are editing. The placeholders include standard items, such as the user profile properties defined on the system and your defined email signature.

The LMS signature is itself a template (that Global administrators can update), and is included by default in all other email templates. If required, you can remove or replace the LMS Signature placeholder on a per email template basis.

Once a template has been customised, it is used for any new emails that are sent from the LMS (unless the template has been overridden on a content item). However, you can reset the template back to its default format, should you wish to discard any previous edits.

Content item level templates

The content level defaults can be viewed in the Administration portal on the Catalogue| {Content item} | Notification templates page.

The page displays the following information per template:

TEMPLATE. The template name and description
STATUS. Whether the template uses the system default template definition or the item template definition. Where an email template uses the default system level email template, it is displayed with a STATUS of System. Where the email template has been customised at the item level, it is displayed with a STATUS of Item.
Edit Config (). Edit config allows admins to configure whether the system should send the associated notification. The available options are:
- Enabled (inherited from system level). This notification is enabled and will use the system level template definition.
- Enabled (configured at the item level). This notification is enabled and will use the item level template definition.
- Disabled (configured at the item level). This notification is disabled and will not be sent for this item, irrespective of the system level configuration.

The page displays email templates that are relevant for the selected content item. If required, global administrators, can customise the email templates, using the template editing feature.

You can change the template wording, formatting, and use placeholders (such as the content items title), which are replaced with user or context specific values when an email is sent.

Once a template has been customised, it is used when any emails using this template are sent from the LMS for this item. However, you can reset the template back to its original format, should you wish to discard any previous edits.

Related