عنصر <item> لـ RSS

يمكن لتقديم <item> تحديد مقال أو "قصة" في وسم RSS.

<item> العنصر

يرجى النظر في وثيقة RSS أدناه:

<?xml version="1.0" encoding="ISO-8859-1" ?>
<rss version="2.0"><channel>
  <title>CodeW3C.com Home Page</title>
  <link>http://www.codew3c.com</link>
  <description>Free web building tutorials</description>
  <item>
    <title>RSS Tutorial</title>
    <link>http://www.codew3c.com/rss</link>
    <description>New RSS tutorial on CodeW3C.com</description>
  </item>
</channel></rss>

كما ذكرنا سابقًا، يمكن لكل عنصر <item> تعريف مقالًا أو قصة في feed RSS.

يملك عنصر <item> ثلاثة عناصر ضرورية:

  • <title> - يحدد عنوان المشروع. (مثل تعليمات RSS)
  • <link> - يحدد رابط يصل إلى المشروع. (مثل http://www.codew3c.com/rss)
  • <description> - يصف هذا المشروع (مثل تعليمات RSS لـ CodeW3C)

إضافة إلى ذلك، هناك عدة عناصر فرعية اختيارية لـ <item>، سنقوم بشرح أكثرها أهمية فيما بعد.

عنصر <author>

يستخدم عنصر <author> لتعريف عنوان بريد الكتروني للكاتب لمشروع.

ملاحظة:لمنع البريد غير المرغوب فيه، قد لا يستخدم بعض المطورين عنصر <author> هذا.

قد يكون الكاتب في RSS المذكور أعلاه هو:

<author>service@codew3c.com</author>

عنصر <comments>

يسمح عنصر <comments> بربط مشروع مع التعليقات المتعلقة به.

التعليقات في مشاريع RSS المذكورة أعلاه قد تكون مثل:

<comments>http://www.codew3c.com/comments</comments>

عنصر <enclosure>

يسمح عنصر <enclosure> بتحميل ملف وسائط إلى عنصر.

عنصر <enclosure> يحتوي على ثلاثة خصائص ضرورية:

  • رابط - يحدد URL يشير إلى هذا ملف الوسائط
  • طول - يحدد طول هذا ملف الوسائط (حروف)
  • نوع - يحدد نوع ملف الوسائط

في مستند RSS المذكور أعلاه، قد تكون الملفات الوسائطية المضمنة في العنصر مثل هذه:

<enclosure url="http://www.codew3c.com/rss/rss.mp3" length="5000" type="audio/mpeg" />

دليل مرجعي لـ RSS <item>

العنصر الوصف
<author> اختياري. يحدد عنوان بريد إلكتروني للكاتب للمشروع.
<category> اختياري. يحدد فئة واحدة أو أكثر للمشروع.
<comments> اختياري. يسمح بربط المشروع بالتعليقات المتعلقة به (ملف).
<description> مطلوب. يصف المشروع.
<enclosure> اختياري. يسمح بإدخال ملف وسائط إلى العنصر.
<guid> اختياري. يحدد معرفًا فريدًا للمشروع.
<link> مطلوب. يحدد رابطًا إلى المشروع.
<pubDate> اختياري. يحدد تاريخ إصدار المشروع الأخير.
<source> اختياري. يحدد مصدر ثالث لهذا المشروع.
<title> مطلوب. يحدد العنوان为此 المشروع.