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