Configuring Email Templates

Overview

Learndot automatically sends emails to both staff as well as customers, participants, and other parties involved in your business. Administrators may like to configure and customize email templates. In this tutorial we will explain on updating email templates, overriding default templates, and related system settings in learndot. 

Updating Email Templates

The templates are fully customizable via Settings in the Learndot Admin.

To figure out which template to update, here's the naming convention:

email.template.<module>.<extension>

So:

All email templates start with email.template, so you can search just for that via Search box.

All templates have a <module> that will give you a good idea when it's being used.

<extension> is one of the following:

  • subject - simply the email subject
  • body.txt - text version of the email body
  • body.html - HTML version of the email body

So, for example, if you want to change email that is sent to participants when they register, you'd edit:

email.template.registration_info.subject to change the subject of that email
email.template.registration_info.body.html to set the HTML version of email body
email.template.registration_info.body.text to set text version of email body

The email body is composed using FreeMarker, an open source templeting engine which should be easy to figure out.

Overriding Default Email Templates

When overriding default email templates using system settings, a restart of the server will be required in order for the new templates to be applied.

Email Related System Settings

Here is a explanation of our current email templates and their triggers:

Setting

Description

email.template.affiliate_conversion

Sent to affiliate when an end-user that came from the affiliate's site does something that is considered a conversion (e.g. registers for a class)

email.template.affiliate_registration

Sent to affiliate after they register for the first time

email.template.affiliate_registration.notification

Sent to staff members with enabled Affiliate Registration notification when an affiliate registers

email.template.contact_email

Sent to contacts manually (along with a custom subject and message) by staff members. The contacts are explicitly selected from contact lists (e.g. contact search, expert search, registration search, etc.)

email.template.expert_registration

Sent to experts (instructors) after they register for the first time

email.template.expert_registration.notification

Sent to staff members with enabled Expert Registration notification when an expert registers

email.template.forum_post_notification

Sent to all users subscribed to a particular forum topic (i.e. when a new reply is added)

email.template.forum_topic_notification

Sent to all users subscribed to a particular forum (i.e. when a new topic is created)

email.template.member_registration

Sent to a regular user after they register for the first time

email.template.member_registration.notification

Sent to staff members with enabled Member Registration notification when a member registers

email.template.product_item_download

Sent to customer after they purchase a product that is downloadable (as opposed to shippable)

email.template.product_order

Sent to customer after they make a product purchase (contains the summary of their entire order)

email.template.product_order.notification

Sent to staff members with enabled Product Order notification when somebody purchases one or more products

email.template.product_order_update

Sent to customer of a product order (inc. additional bcc addresses) after a staff member explicitly requests this email to be sent along with their optional and custom message (contains the summary of their entire order)

email.template.provider_registration

Sent to a provider after they register for the first time

email.template.provider_registration.notification

Sent to staff members with enabled Provider Registration notification when a provider registers

email.template.registration_info

Sent to a participant of a particular class when they (or somebody else) registers; a separate email is sent for each registration in a given order

email.template.registration_order

Sent to customer after they submit a registration order (contains the summary of their entire order)

email.template.registration_order.notification

Sent to staff members with enabled Registration Order notification when somebody registers for one or more classes

email.template.registration_order_update

Sent to customer of a registration order (inc. additional bcc addresses) after a staff member explicitly requests this email to be sent along with their optional and custom message (contains the summary of their entire order)

email.template.request_for_class.notification

Sent to staff members with enabled Request for Class notification when a potential customer requests a class

email.template.request_for_contact.notification

Sent to staff members with enabled Expert Registration notification when a customer submits an RFC (inquiry request)

email.template.request_for_quote.notification

Sent to staff members with enabled Request for Quote notification when a potential customer requests a quote for an onsite delivery

email.template.request_for_talent.notification

Sent to staff members with enabled Request for Talent notification when a potential customer submits a request for talent

email.template.reset_password

Sent to the end user who requests their password to be reset

email.template.training_assessment_response.notification

Sent to staff members with enabled Training Assessment Response notification when a participant submits their training assessment form

email.template.training_survey_response.notification

Sent to staff members with enabled Training Survey Response notification when a participant submits their training survey form

email.template.user_message_notification

Sent to users who've received in-Spark messages from other users