RTRT.me Communications - "Smart" Email Templates

Intro

The RTRT.me Communications Template Editor provides many ways to produce custom emails based on variables and conditions.  Below are a few helpful features that the RTRT templating engine supports.

VARIABLES

Your templates can include dynamic content populated by using variables.  Don't be intimidated by the word "variables".  A variable is just a way of giving each recipient a more personalized email.   You might want to use variables if you wish to send an email that shows, for example, the participant's 'name', 'bib',  and 'corral' assignment.   In the olden days, we called this mail merging

Use a variable by wrapping the field name in brackets.  For example:

Welcome [fname]!

Output examples: In this template, the fname in brackets will be replaced with the participants first name, e.g. 'Welcome Janet!'.

Fallbacks#fallbacks

Whenever you are not sure if a value will be available, you can provide a fallback.  

Display the "corral" field value or 'Pending' if there is no value yet for corral.

Your corral is [corral,fallback=Pending].

Output examples: "Your corral is A." or "Your corral is Pending."

conditionAls - "if" BLOCKS#conditionals--if-blocks

Sometimes you need to provide a section of content only if certain conditions are true.  You can accomplish this by placing a [if] and an [endif] wrapper around the content as demonstrated below.

Display a block of text only if the field contains a non-empty value.

 [if:corral] You are are assigned to corral [corral]. [endif]

Display a block of text if the field contains a particular value.

 [if:course=5k] Details about the 5k here! [endif]

Display the block of text based on 2 field values matching.

 [if:course=5k and corral=A] Details about the 5k corral A here! [endif]

Display the block of text if not matching by using exclamation point "!" before field, meaning "not".

 [if:!course=5k] Course is NOT 5k  [endif]
 [if:course=5k and !corral=A] Course is 5k but corral is not A [endif]

AdvancED Conditionals

Sometimes, when the condition is not matched, you want to display something else.  For this, you can use [if], [else] and [elseif].

Display a block of text if a condition matches, but display a different message otherwise.

[if:corral=Elite] 
Elite instructions here! 
[else] 
Instructions for everybody else here 
[endif]

Display a block of text if a condition matches, but display a different message based on another condition by using [elseif].

[if:corral=Elite] 
Elite instructions here! 
[elseif:corral=A] 
Instructions for corral A
[else]
Instructions for everybody else here
[endif]

NOTE: Using 'and' & 'or' is not supported with elseif's

conclusion

At first, trying to use variables and logic with variables in your templates might seem intimidating.  It takes some practice, but we are here to help.  Just ask!   We'd be happy to assist you with making a smart template to handle your event requirements.