استخدام نماذج المقاود مع إضافة Trigger Email

في حال تحديد "مجموعة النماذج" أثناء تهيئة ، يمكنك إنشاء نماذج شريط الأدوات وإدارتها القوالب لرسائلك الإلكترونية.

بنية مجموعة النماذج

ويمكنك منح كل مستند معرّفًا يسهُل تذكّره ويمكنك استخدامه كاسم النموذج في المستندات التي تكتبها إلى مجموعة النماذج.

يمكن أن يتضمن مستند النموذج أيًا من الحقول التالية:

subject: سلسلة نموذج لموضوع الرسالة الإلكترونية.
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 }}