Temple: šablonovací jazyk Emailitu, konečně s dokumentací

Pokud jste v šabloně Emailitu někdy použili {{first_name}}, už jste používali Temple, náš malý šablonovací jazyk pro předměty, HTML a text. Kompletní referenci jsme ale nikdy nezveřejnili. Teď je v dokumentaci: Temple.

Temple není Liquid ani Handlebars. Pár věcí umí dobře a víc nepředstírá.

Co můžete psát

Proměnné, včetně vnořených cest:

Hello {{first_name}}
Item {{order.items.0.sku}}

Výchozí hodnoty pro případ, že hodnota chybí:

Hi {{first_name|"there"}}

Podmínky (bez porovnávání, jen pravda / nepravda):

{{#if plan}}
You are on the {{plan}} plan.
{{else}}
You are on the free plan.
{{/if}}

Žádné cykly, vlastní pomocné funkce ani dílčí šablony. Chybějící proměnné se nahradí prázdným textem.

Kde se doopravdy spouští

Tohle byla nezdokumentovaná část, ve které se snadno udělá chyba.

• API POST /emails: Temple se spustí, když pošlete template a/nebo objekt variables, a to i u vloženého HTML.
• Automatizace, krok Odeslat e-mail: Temple se spouští vždy. Automatizace nad kontakty zpřístupňují v kořeni {{email}}, {{first_name}} a {{custom_fields.*}} a k tomu contact, payload a meta.
• Šablony ve webovém rozhraní: značky se ukládají tak, jak jsou. Vykreslují se až při odeslání.
• Kampaně: Temple se nepoužívá. Fungují jen {{first_name}}, {{last_name}}, {{email}}, {{unsubscribe_url}} a {{cf.field}}.
• SMTP: na serveru se nic nevykresluje. Odešleme přesně ten MIME, který nám pošlete.

Vlastní pole v kampaních používají {{cf.plan}}. Vlastní pole v automatizacích používají {{custom_fields.plan}}. Stejná data kontaktu, jiné předpony.

Jak začít

Přečtěte si celou referenci Temple včetně tabulky dostupnosti a příkladů, nebo pošlete šablonu přes e-mailové API s objektem variables.