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 }}