Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Info
This page describes the features available from version 1.9 - see Templates (pre-1.9) for older versions

Notification templates allow you to control exactly what content is sent for each notification type. There are 3 template formats:

Plain: used for private messages and plain text emails

HTML: used for HTML emails

Simple: used for XMPP 

 

Editing Templates

Editing a template allows you to change each of the formats using the DotLiquid markup syntax.

Image Removed

 

Each Publisher type has a set of template formats which can be edited provide content for each notification type.

Templates

Image Added


Default template content is provided for each combination. When a template has been edited the format name is coloured blue.

Click the 'Edit' button for each notification type to edit the associated templates.


Editing Templates 

Image Added

The template content is shown in an editable text area under a tab for each template format. This uses DotLiquid markup syntax which allow you to specify variables using the {{variablename}} notation, control flow with {{for}} loops and {{if}} conditions and many others.



Editing the content will mark the associated tab with an asterisk

Image Added


and buttons will appear for saving the templates.

Image Added


Once an edited template has been saved, the tab will be marked with a pencil

Image Added


 and buttons will appear allowing you to revert the template to the default format.

Image Added


Below the editable text area, Below the input box is a list of variables that are available to be used in the template. These are specific to the notification type, so , for example, a build-related notification types, for example, will give you access to the build's version, status, associated changesets etc. Variables can be inserted into the template using curly brackets e.g. {{Configuration.Name}}

Image Added