欢迎参加我们将于 2022 年 10 月 18 日举办的 Firebase 峰会(线上线下同时进行),了解 Firebase 如何帮助您加快应用开发速度、满怀信心地发布应用并在之后需要时轻松地扩大应用规模。立即报名

Użyj szablonów kierownicy z rozszerzeniem Trigger Email

Jeśli podczas konfiguracji rozszerzenia określiłeś parametr „Kolekcja szablonów”, możesz tworzyć szablony szablonów Handlebars i zarządzać nimi dla swoich e-maili.

Struktura kolekcji szablonów

Nadaj każdemu dokumentowi łatwy do zapamiętania identyfikator, którego używasz jako nazwy szablonu w dokumentach, które piszesz w swojej kolekcji szablonów.

Dokument szablonu może zawierać dowolne z następujących pól:

  • subject: ciąg szablonu dla tematu wiadomości e-mail.
  • tekst: ciąg szablonu dla treści wiadomości e-mail w postaci zwykłego tekstu.
  • html: ciąg szablonu dla treści HTML wiadomości e-mail.
  • amp: ciąg szablonu dla treści AMP4EMAIL wiadomości e-mail.
  • załączniki: tablica załączników z ciągami szablonu jako wartościami; Obsługiwane opcje Nodemailera : ciąg utf-8, niestandardowy typ treści, adres URL, zakodowany ciąg, identyfikator URI danych i wstępnie wygenerowany węzeł MIME (pamiętaj, że Twój e-mail nie ma dostępu do systemu plików serwera w chmurze).

Przykładowy szablon może mieć identyfikator following i treści, takich jak:

{
  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}}"
    }
  ]
}

Wysyłaj e-maile za pomocą szablonów

Aby dostarczać wiadomości e-mail przy użyciu szablonów, podczas dodawania dokumentów do swojej kolekcji poczty dołącz pole template z właściwościami name i data . Na przykład, korzystając z naszego following szablonu z góry:

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"
      },
    },
  });

Części szablonu

Możesz komponować szablony używając częściowych wielokrotnego użytku , określając {partial: true} w dokumencie szablonu. Każde ze standardowych pól danych ( subject , html , text i amp ) zostanie zdefiniowane jako częściowe używane tylko we własnym środowisku. Na przykład częściowa footer może zawierać dane takie jak:

{
  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"
}

W innym szablonie dołącz podszablon, odwołując się do jego nazwy (identyfikatora dokumentu):

<p>This is my main template content, but it will use a common footer.</p>

{{> footer }}