Если при настройке расширения вы указали параметр «Коллекция шаблонов», вы можете создавать и управлять шаблонами Handlebars для своих писем.
Структура коллекции шаблонов
Присвойте каждому документу запоминающийся идентификатор, который вы будете использовать в качестве имени шаблона в документах, которые вы добавляете в свою коллекцию шаблонов.
Шаблон документа может включать любое из следующих полей:
- Тема: Строка шаблона для темы электронного письма.
- текст: Строка шаблона для текстового содержимого электронного письма.
- 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 }}