Zum Inhalt springen

Ankündigungen4 Min. Lesezeit

Temple: die Template-Engine von Emailit, jetzt dokumentiert

Variablen, Standardwerte und Bedingungen für E-Mails aus API und Automatisierungen. Und was in Kampagnen und bei SMTP tatsächlich passiert.

GVon George

Temple: die Template-Engine von Emailit, jetzt dokumentiert

Wenn Sie in einer Emailit-Vorlage schon einmal {{first_name}} verwendet haben, haben Sie bereits Temple genutzt, unsere kleine Template-Engine für Betreffzeilen, HTML und Text. Eine vollständige Referenz haben wir bisher nie veröffentlicht. Jetzt steht sie in der Dokumentation: Temple.

Temple ist weder Liquid noch Handlebars. Es beherrscht ein paar Dinge gut und belässt es dabei.

Was Sie schreiben können

Variablen, auch mit verschachtelten Pfaden:

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

Standardwerte, wenn ein Wert fehlt:

Hi {{first_name|"there"}}

Bedingungen (keine Vergleiche, nur truthy / falsy):

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

Keine Schleifen, keine eigenen Helper, keine Partials. Fehlende Variablen werden zu leeren Strings.

Wo Temple tatsächlich läuft

Genau dieser Teil war bisher nicht dokumentiert, und hier passieren leicht Fehler.

  • API POST /emails: Temple läuft, wenn Sie ein template und/oder ein variables-Objekt übergeben, auch bei Inline-HTML.
  • Automatisierungen, Schritt „Send Email“: Temple läuft immer. Kontakt-Automatisierungen stellen {{email}}, {{first_name}} und {{custom_fields.*}} auf oberster Ebene bereit, dazu contact, payload und meta.
  • Vorlagen in der Weboberfläche: Tags werden unverändert gespeichert. Gerendert wird erst beim Versand.
  • Kampagnen: kein Temple. Nur {{first_name}}, {{last_name}}, {{email}}, {{unsubscribe_url}} und {{cf.field}}.
  • SMTP: kein serverseitiges Templating. Wir versenden genau das MIME, das Sie einliefern.

Eigene Felder in Kampagnen verwenden {{cf.plan}}. Eigene Felder in Automatisierungen verwenden {{custom_fields.plan}}. Dieselben Kontaktdaten, unterschiedliche Präfixe.

Loslegen

Lesen Sie die vollständige Temple-Referenz mit Verfügbarkeitstabelle und Beispielen, oder senden Sie eine Vorlage über die E-Mail-API mit einem variables-Objekt.

Teilen

Probieren Sie aus, worüber Sie gerade gelesen haben.

3.000 E-⁠Mails im Monat gratis. Keine Kreditkarte erforderlich.

3.000 E-⁠Mails im Monat kostenlos · Keine Kreditkarte erforderlich