Temple: el motor de plantillas de Emailit, por fin documentado

Si alguna vez has usado {{first_name}} en una plantilla de Emailit, ya has usado Temple, nuestro pequeño motor de plantillas para asuntos, HTML y texto. Nunca habíamos publicado una referencia completa. Ahora ya está en la documentación: Temple.

Temple no es Liquid ni Handlebars. Hace unas pocas cosas bien y ahí se queda.

Qué puedes escribir

Variables, incluidas las rutas anidadas:

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

Valores por defecto para cuando falta un valor:

Hi {{first_name|"there"}}

Condicionales (sin comparaciones, solo verdadero o falso):

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

Sin bucles, sin helpers personalizados y sin parciales. Las variables que faltan se convierten en cadenas vacías.

Dónde se ejecuta de verdad

Esta es la parte que no estaba documentada y en la que es fácil equivocarse.

• API POST /emails: Temple se ejecuta cuando pasas template, un objeto variables o ambos, también con HTML en línea.
• Automatizaciones, paso Enviar email: Temple se ejecuta siempre. Las automatizaciones de contactos exponen {{email}}, {{first_name}} y {{custom_fields.*}} en la raíz, además de contact, payload y meta.
• Plantillas en el panel: las etiquetas se guardan tal cual. El procesado se hace en el momento del envío.
• Campañas: no usan Temple. Solo {{first_name}}, {{last_name}}, {{email}}, {{unsubscribe_url}} y {{cf.field}}.
• SMTP: no hay plantillas en el servidor. Enviamos exactamente el MIME que nos mandas.

Los campos personalizados de las campañas usan {{cf.plan}}. Los de las automatizaciones usan {{custom_fields.plan}}. Los mismos datos del contacto, con prefijos distintos.

Empieza ya

Lee la referencia completa de Temple, con la tabla de disponibilidad y ejemplos, o envía una plantilla desde la API de email con un objeto variables.