Enable the template or notification plugin
Enabling the plugin will make all of its templates available for customization.
- Mouse over Management.
- Click Administration.
- Click Notifications. The list of notifications appears.
- Click the desired email plugin or notification plugin.
- Click Enabled.
- Click Save.
Example: Add a token to a notification
You can easily add a new token to customize a template or notification for incorporating new information, such as abuse appeal expiration date.
- In the Template drop-down list, select the template you want to edit. In this case, we're editing the Email-Body template for the Abusive Appeal Expiration Notification Type.
- In the menu bar, click Insert > Insert token to add a token. The token list appears.
- In this example, we are selecting Abuse Appeal: Expiration Date.
- Click Ok to save the subtoken.
- Click Ok to save the token (which includes the text for this email).
- Click Save to save the email template.
- Click Preview email to view the email. (The content of the subtokens will not be displayed.)
Example: Change a token and add display limit
Adding or changing a token's display limit is a way to create alternative behavior in emails. Typically, a token with a text value would use a character limit to change behavior. An example would be changing the blog post body token to limit the post length displayed in the template. (A token with a numeric value is covered in the next example.)
To change what is displayed and its length:
- Select the template you want to edit in the Template drop-down list. In this case, we're editing the Blog Post Notification email - body template.
The text of this Email - Body template contains several blog-related tokens. In this example, the text field content is contained in the Blog Post: Excerpt token (which you can find out by right-clicking the token and selecting Edit Token). We want to display the entire blog post in the email rather than an excerpt. - Right-click the token you want to edit (Blog Post: Excerpt) and select Edit token. The Edit token window appears.
- Select Blog Post: Body from the Show list.
- We want to display the entire post, so we select a "With" value of Unlimited length. However you could mimic the blog post excerpt token by changing the character "With" field from "Unlimited length" to "Length limited to xxx characters."
- In the Template field, you can choose a differentiation from the available conditions. If you are not providing an alternative condition (what happens if the length is longer than the limit of 50 characters), the token will simply meet the character length limit and print up to 50 characters.
We've filled in the fields below as an example for displaying the Blog Post: Excerpt token's value up to 50 characters:- Show - Token name (Blog Post: Body)
- With - Length constraint or unlimited (Unlimited length)
- Varied - Not used here. (By nothing (render value directly). Most often used for comparison with a numeric value. Varied by nothing; equal to; less than; less than or equal to; greater than; greater than or equal to. - "Varied" is not always present. It is visible in the Insert/Edit token window only if the token renders a direct count.
- Template - Not present here since the value is being rendered directly. However if you were making a comparison, such as "greater than or equal to," it would be present and you could specify what you want the template to look like when the vary is true or when it is false.
- (For each token or subtoken you configure, you must click Ok in that window to save the changes.)
- Click Preview email to view how the template will look.
- Click Save to save the template.
Tokens with text values - for example, Site Name - should usually have the Varied "by nothing (render value directly)" option selected. The exception is when adding a condition for the text value being empty (or not set). This selection only indicates that the value should be displayed unless it doesn't meet the Template field drop-down parameter. For example, if you select With "Length Limited to" "0 characters," you will want to display text if there are more than 0 characters. So you would choose Varied "When greater than" "value" "0" and if that condition is true (i.e., the post contains text), you would select Template "Vary condition is true" and ensure the field contains text.
Example: Use numeric comparison to control what a token displays
In the following example, we're going to display the number of blog comments in the email subject unless the number is greater than 10, in which case we'll substitute "More."
- Select the template you want to edit in the Template drop-down list. In the Blog Post Comment Notification template, we are editing the Email - Subject template.
- Edit the text as desired and point your mouse to the location where you want to remove the old token and/or insert a new one. In the following example, we've added the Blog Post: Comment Count token by clicking Insert > Insert token.
- Place your mouse on the desired token (in this case, Blog Post: Comment Count) you want to add a condition for, right-click, and select Edit Token. The Edit Token window appears. Make the following edits:
- Show - Blog Post: Comment Count
- With - Unlimited length
- Varied by - When less than or equal to
- Value
- 10
- Template - Vary condition is false
- Text - More.
- Click Ok to save the token.
- Click Preview email to view how the template will look.
- Click Save to save the template.