بمجرد إعداد مصدر البيانات الخارجي بشكل صحيح، يمكنك استخدام مخرجاته في قالب البريد الإلكتروني باستخدام لغة نماذج السوائل.

استخدام مصدر البيانات الخارجي لتغذية المحتوى

لعرض تغذية المحتوى، يمكنك إنشاء API الذي يقدم json مع العديد من عناصر تغذية المحتوى. كمثال، يمكن أن يبدو كالتالي:

{
  "feed": {
    "version": "1.0",
    "title": "sample-data-feed",
    "items": [
      {
        "title": "Meet the Full Cast",
        "link": "https://bird.com/article",
        "description": "See who's joining previously announced stars Katie Brayben and Christian Borle in the Elton John-Jake Shears-James Graham musical.",
        "thumbnail": "https://assets.bird.com.jpg",
        "date": "2024-08-28T11:21:00",
        "creator": "Joe Black"
      },
      {
        "title": "Stars in ASL American",
        "link": "https://bird.com/article",
        "description": "Center Theatre Group is teaming up with Deaf West Theatre to reopen the Mark Taper Forum with a new production of the Green Day musical after bringing revivals of Big River and Spring Awakening to Broadway.",
        "thumbnail": "https://assets.bird.com.jpg",
        "date": "2024-08-28T11:59:00",
        "creator": "Joe Black"
      }
    ]
  }
}

يمكن استخدام تغذية json المذكورة أعلاه كعنوان URL API عند إنشاء مصدر البيانات الخارجي.

بمجرد إنشائه، يمكنك الإشارة إليه في قالب البريد الإلكتروني كما يلي:

1. أولاً، أضف عنصر html وأضف الشفرة أدناه لجلب مصدر البيانات الخارجي بالاسم أي {% datafetch "external-data-source-name" %}

2. استخدم دالة for في السائل للحصول على جميع العناصر في التغذية الخاصة بك مع المسار أي {% for <your-item> in dataFetchResponse.<your-json-path> %}.

إذا كان لديك عنصر واحد فقط، فقد لا يكون هذا مطلوبًا

افتراضياً أن sample-data-feed هو اسم مصدر البيانات الخارجي و feed.items هو المسار في تغذية json للحصول على العناصر، فإنه سيظهر كالتالي:

{% datafetch "sample-data-feed" %}
{% for item in dataFetchResponse.feed.items %}

• بعد إضافة هذا، يمكنك إضافة أي عناصر صورة، نص، زر والإشارة إلى مصدر البيانات الخارجي كما يلي بافتراض هيكل sample-data-feed:

{{item.title}} - لعرض العنوان في عنصر نصي

{{item.description}} - لعرض الوصف في عنصر نصي

{{item.link}} - لإضافة رابط في عنصر زر

{{item.thumbnail}} - لإضافة مصدر URL الصورة في عنصر الصورة

• الآن أضف كتلة html أخرى لإنهاء جلب مصدر البيانات الخارجي ودالة for كما هو موضح أدناه

{% endfor %}
{% enddatafetch %}

لمعاينة بريدك الإلكتروني، يمكنك التبديل إلى المعاينة ورؤية كيف تبدو تغذية المحتوى الخاصة بك

ملاحظة: إذا كان لديك تغذية ثابتة، يمكنك تحديثها هنا يدويًا باختيار مصدر البيانات الخارجي تحت قائمة تحديث مصدر البيانات الخارجي المنسدل.