Jika Anda menetapkan parameter "Koleksi template" selama konfigurasi ekstensi, Anda dapat membuat dan mengelola template template Handlebars untuk email Anda.
Struktur koleksi template
Berikan setiap dokumen ID yang mudah diingat yang Anda gunakan sebagai nama template dalam dokumen yang Anda tulis ke koleksi template Anda.
Dokumen template dapat menyertakan salah satu bidang berikut:
- subjek: Sebuah template string untuk subjek email.
- teks: Sebuah template string untuk konten plaintext email.
- html: Sebuah template string untuk konten HTML email.
- amp: String template untuk konten email AMP4EMAIL .
- lampiran: Larik lampiran dengan string templat sebagai nilai; Opsi nodemailer yang didukung: string utf-8, tipe konten khusus, URL, string yang disandikan, URI data, dan node MIME yang dibuat sebelumnya (perhatikan bahwa email Anda tidak memiliki akses ke sistem file server cloud).
Template contoh mungkin memiliki ID following
dan konten seperti:
{
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}}"
}
]
}
Kirim email menggunakan template
Untuk mengirimkan email menggunakan template, saat menambahkan dokumen ke koleksi email Anda, sertakan bidang template
dengan properti name
dan data
. Misalnya, menggunakan templat kami following
dari atas:
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"
},
},
});
Partial Templat
Anda dapat membuat template menggunakan sebagian yang dapat digunakan kembali dengan menentukan {partial: true}
dalam dokumen template. Setiap bidang data standar ( subject
, html
, text
, dan amp
) akan ditentukan sebagai sebagian yang hanya digunakan di lingkungannya sendiri. Misalnya, footer
yang dipanggil sebagian mungkin memiliki data seperti:
{
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"
}
Di templat lain, sertakan sebagian dengan mereferensikan namanya (ID dokumen):
<p>This is my main template content, but it will use a common footer.</p>
{{> footer }}