"Şablonlar koleksiyonu" belirttiyseniz parametresini Herkese açık kullanıcı adı şablonları kullanabileceğiniz yeni bir şablondur.
Şablon toplama yapısı
Her dokümana şablon adı olarak kullandığınız akılda kalıcı bir kimlik verin: koleksiyonunuza ekleyebilirsiniz.
Şablon belgesi aşağıdaki alanlardan herhangi birini içerebilir:
- subject: E-postanın konusu için bir şablon dizesi.
- text: E-postanın düz metin içeriği için bir şablon dizesi.
- html: E-postanın HTML içeriği için bir şablon dizesi.
- amp: E-postanın AMP4EMAIL içeriği için bir şablon dizesi.
- attachments: Değer olarak şablon dizeleri içeren bir ek dizisi; Desteklenen Nodemailer seçenekleri: utf-8 dizesi, özel içerik türü, URL, kodlanmış dize, veri URI'si ve önceden oluşturulmuş MIME düğümü (e-postanızın, bulut sunucusunun dosya sistemine erişimi olmadığını unutmayın).
Örnek bir şablonun kimliği following ve içeriği aşağıdaki gibi olabilir:
{
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}}"
}
]
}
Şablonları kullanarak e-posta gönderme
Şablonları kullanarak e-posta teslim etmek için, posta koleksiyonunuza doküman eklerken
name ve data özelliklerine sahip bir template alanı dahil edin. Örneğin,
yukarıdaki following şablonumuzu kullanarak:
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"
},
},
});
Şablon Kısmileri
Yeniden kullanılabilir kısmiler kullanarak şablonlar oluşturabilirsiniz.
(ör. şablon dokümanında {partial: true}) belirtebilirsiniz. Bu standartların her biri
veri alanları (subject, html, text ve amp), kısmi
yalnızca kendi ortamında kullanılmalıdır. Örneğin, footer adlı kısmi bir
şöyle veriler yer alır:
{
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"
}
Başka bir şablonda, adına (doküman kimliği) referans vererek kısmi öğeyi ekleyin:
<p>This is my main template content, but it will use a common footer.</p>
{{> footer }}