Если при настройке расширения вы указали параметр «Коллекция шаблонов», вы можете создавать шаблоны Handlebars для своих писем и управлять ими.
Структура коллекции шаблонов
Присвойте каждому документу запоминающийся идентификатор, который вы будете использовать в качестве имени шаблона в документах, которые вы записываете в свою коллекцию шаблонов.
Документ-шаблон может включать любое из следующих полей:
- Тема: строка шаблона темы электронного письма.
- text: строка шаблона для открытого текстового содержимого электронного письма.
- html: строка шаблона для HTML-содержимого электронного письма.
- amp: строка шаблона для содержимого электронного письма AMP4EMAIL .
- вложения: массив вложений со строками шаблона в качестве значений; Поддерживаемые параметры Nodemailer : строка utf-8, пользовательский тип контента, URL-адрес, закодированная строка, URI данных и предварительно созданный узел MIME (имейте в виду, что ваша электронная почта не имеет доступа к файловой системе облачного сервера).
Пример шаблона может иметь following
идентификатор и содержимое, например:
{
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}}"
}
]
}
Отправляйте электронные письма, используя шаблоны
Чтобы доставлять электронную почту с использованием шаблонов, при добавлении документов в коллекцию почты включите поле template
со свойствами name
и data
. Например, используя наш following
шаблон сверху:
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: true}
в документе шаблона. Каждое из стандартных полей данных ( subject
, html
, text
и amp
) будет определено как частичное, используемое только в своей собственной среде. Например, частичный footer
может содержать такие данные:
{
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"
}
В другом шаблоне включите частичный фрагмент, указав его имя (идентификатор документа):
<p>This is my main template content, but it will use a common footer.</p>
{{> footer }}