Verwenden Sie Lenkervorlagen mit der Trigger-E-Mail-Erweiterung

Wenn Sie bei der Konfiguration der Erweiterung einen Parameter „Vorlagensammlung“ angegeben haben, können Sie Lenkervorlagenvorlagen für Ihre E-Mails erstellen und verwalten.

Struktur der Vorlagensammlung

Geben Sie jedem Dokument eine einprägsame ID, die Sie als Vorlagennamen in den Dokumenten verwenden, die Sie in Ihre Vorlagensammlung schreiben.

Das Vorlagendokument kann eines der folgenden Felder enthalten:

  • Betreff: Eine Vorlagenzeichenfolge für den Betreff der E-Mail.
  • text: Eine Vorlagenzeichenfolge für den Klartextinhalt der E-Mail.
  • html: Eine Vorlagenzeichenfolge für den HTML-Inhalt der E-Mail.
  • amp: Eine Vorlagenzeichenfolge für den AMP4EMAIL- Inhalt der E-Mail.
  • Anhänge: Ein Array von Anhängen mit Vorlagenzeichenfolgen als Werten; Unterstützte Nodemailer-Optionen : UTF-8-Zeichenfolge, benutzerdefinierter Inhaltstyp, URL, codierte Zeichenfolge, Daten-URI und vorgenerierter MIME-Knoten (beachten Sie, dass Ihre E-Mail keinen Zugriff auf das Dateisystem des Cloud-Servers hat).

Eine Beispielvorlage könnte die following ID und den folgenden Inhalt haben:

{
  subject: "@{{username}} is now following you!",
  html: "Just writing to let you know that <code>@{{username}}</code> ({{name}}) is now following you.",
  attachments: [
    {
     filename: "{{username}}.jpg",
     path: "{{imagePath}}"
    }
  ]
}

Senden Sie E-Mails mithilfe von Vorlagen

Um E-Mails mithilfe von Vorlagen zuzustellen, fügen Sie beim Hinzufügen von Dokumenten zu Ihrer E-Mail-Sammlung ein template mit name und data ein. Verwenden Sie zum Beispiel unsere following Vorlage von oben:

admin
  .firestore()
  .collection("MAIL_COLLECTION")
  .add({
    toUids: ["abc123"],
    template: {
      name: "following",
      data: {
        username: "ada",
        name: "Ada Lovelace",
        imagePath: "https://example.com/path/to/file/image-name.jpg"
      },
    },
  });

Vorlagenteilweise

Sie können Vorlagen mit wiederverwendbaren Teildateien erstellen, indem Sie im Vorlagendokument {partial: true} angeben. Jedes der Standarddatenfelder ( subject , html , text und amp ) wird als Teil definiert und nur in seiner eigenen Umgebung verwendet. Eine teilweise aufgerufene footer könnte beispielsweise folgende Daten enthalten:

{
  partial: true,
  html: "<p>This mail was sent by ExampleApp, Inc. <a href='https://example.com/unsubscribe'>Unsubscribe</a></p>",
  text: "This mail was sent by ExampleApp, Inc. Unsubscribe here: https://example.com/unsubscribe"
}

Fügen Sie den Teil in einer anderen Vorlage ein, indem Sie auf seinen Namen (Dokument-ID) verweisen:

<p>This is my main template content, but it will use a common footer.</p>

{{> footer }}