استخدم قوالب المقاود مع ملحق Trigger Email

إذا قمت بتحديد معلمة "مجموعة القوالب" أثناء تكوين الامتداد، فيمكنك إنشاء قوالب قوالب 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 }}