Mandrill supports a few helpers that are not included with handlebars: upper, lower, title, url, date, striptags & unsub
This acts as a polyfill for those helpers allowing you to build and test your templates locally before publishing
npm install mandrill-template-helpers --save
npm test
In your code
var hb = require('handlebars');
var mandrill-helpers = require('mandrill-template-helpers');
hb.registerHelper(mandrill-helpers);
...
var template = hb.compile('./template.html');
in your ./template.html
do
{{#if shout_out}}
{{upper shout_out}}!
{{/if}}
if shout_out
was hello then it would return HELLO
From Mandrill...
Helper | Function | Example |
---|---|---|
upper | uppercase the text provided | {{upper "your text"}} results in: YOUR TEXT |
lower | lowercase the text provided | {{lower "your text"}} results in: your text |
title | title-case the text provided | {{title "your text is neat"}} results in: Your Text is Neat |
url | urlencode the text provided | {{url "http://yourawesomeurl.com"}} results in: http%3A%2F%2Fyourawesomeurl.com |
date | print the current date with a given format, defaults to d/m/Y | {{date "Y-m-d"}} results in: 2015-03-10 |
striptags | strip any HTML tags from the given data | {{striptags "<p>your text</p>"}} results in: your text |
Mandrill also offers another helper, {{unsub}} to add an automatic unsubscribe link to your emails. Generally, you would add the unsub helper in handlebars as {{unsub "http://redirecturl.com"}} where you pass the URL directly in the helper and the URL must be enclosed in double quotes. For example:
<a href='{{unsub "http://redirecturl.com"}}'>Unsubscribe</a>
You can also pass the redirect URL as a merge_var:
<a href='{{unsub redirect_merge_var}}'>Unsubscribe</a>
with the merge var defined as:
"global_merge_vars": [
{
"name": "redirect_merge_var",
"content": "http://yourdomain.com"
}
]
Note: When using the {{unsub}}
helper inside of an anchor tag, be sure to use single quotes around for the href='{{unsub }}'
.
- implement
date
helper - create placeholder for
unsub
MIT