Creating an Email Notification Template

Crowd uses an email template to build the content of an email message that Crowd sends to a user. Crowd provides the following email templates:

Email Template for Password Resets (Forgotten Passwords)

This is a template for the email sent when an administrator asks a user to reset their password and when a user asks to reset their own forgotten password.

To edit the email template for password resets,

  1. Log in to the Crowd Administration Console.
  2. Click the 'Administration' tab in the top navigation bar.
  3. Click 'Mail Template' in the left-hand menu.
  4. In the 'Forgotten Password Template' text box, enter the text and macros that will form the body of the email message. Use a macro when you want to include a variable into the email text. Crowd will replace the macro with the relevant value when it sends the email. Below are the available macros and their replacement values:
    • $username – The username of the person who will receive the email.
    • $firstname – The user's first name.
    • $lastname – The user's last name.
    • $deploymenttitle – The title of your Crowd site, as defined in Deployment Title.
    • $date – The date/time of the message event.
    • $resetlink – The automatically-generated URL that the user can click, allowing them to choose a new password.
      Note: To ensure that the password reset URL will include the correct domain for your Crowd server, please set the crowd.base.url variable to the correct domain value in the <Crowd-Home-Directory>/crowd.properties file:
      crowd.base.url=http://your_domain.com
      
  5. Click 'Update'.

(info) Earlier releases of Crowd supplied the '$password' macro to represent the user's new password, automatically generated by Crowd. Crowd no longer generates a new password, but instead generates a link that the user can click to choose their own new password. For backwards compatibility, if your email template contains the '$password' macro, Crowd will now replace it with the text 'available at (link)'. The '(link)' will be the same as now available in the '$resetlink' macro.

Email Template for Forgotten Usernames

This is a template for the email sent when a user requests their forgotten username.

To edit the email template for forgotten usernames,

  1. Log in to the Crowd Administration Console.
  2. Click the 'Administration' tab in the top navigation bar.
  3. Click 'Mail Template' in the left-hand menu.
  4. In the 'Forgotten Username(s) Template' text box, enter the text and macros that will form the body of the email message. Use a macro when you want to include a variable into the email text. Crowd will replace the macro with the relevant value when it sends the email. Below are the available macros and their replacement values:
    • $username – The username of the person who will receive the email.
    • $firstname – The user's first name.
    • $lastname – The user's last name.
    • $deploymenttitle – The title of your Crowd site, as defined in Deployment Title.
    • $date – The date/time of the message event.
    • $email – The email address that the user entered when requesting forgotten usernames. This is the address to which the email message is sent.
    • $admincontact – The email address of the Crowd administrator.
  5. Click 'Update'.

Screenshot: Mail Templates



RELATED TOPICS

Requesting Forgotten Usernames
Resetting Forgotten Passwords

Crowd Documentation

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport