عنصر <item> RSS

هر عناصر <item> می‌تواند یک مقاله یا "story" را در فید RSS تعریف کند.

<item> عناصر

لطفاً مستند RSS زیر را مشاهده کنید:

<?xml version="1.0" encoding="ISO-8859-1" ?>
<rss version="2.0"><channel>
  <title>صفحه اصلی CodeW3C.com</title>
  <link>http://www.codew3c.com</link>
  <description>آموزش‌های رایگان ساخت وب‌سایت</description>
  <item>
    <title>آموزش RSS</title>
    <link>http://www.codew3c.com/rss</link>
    <description>آموزش جدید RSS در CodeW3C.com</description>
  </item>
</channel></rss>

همانطور که قبلاً ذکر شد، هر عنصر <item> می‌تواند یک مقاله یا داستان در RSS feed را تعریف کند.

عنصر <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 - تعریف URL به این فایل رسانه‌ای
  • length - تعریف طول این فایل رسانه‌ای (بایت)
  • type - تعریف نوع فایل رسانه‌ای

در مستند RSS بالا، فایل‌های رسانه‌ای شامل در پروژه ممکن است به این شکل باشد:

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

دستورالعمل مرجع <item> RSS

عنصر توصیف
<author> اختیاری. آدرس ایمیل نویسنده پروژه را مشخص کنید.
<category> اختیاری. یک یا چند دسته برای این پروژه تعریف کنید.
<comments> اختیاری. اجازه دهید پروژه به نظرات مرتبط با آن متصل شود (فایل).
<description> ضروری. این پروژه را توصیف کنید.
<enclosure> اختیاری. اجازه دهید یک فایل رسانه‌ای به یک عنصر اضافه شود.
<guid> اختیاری. یک شناسه منحصر به فرد برای این پروژه تعریف کنید.
<link> ضروری. لینک به این پروژه را تعریف کنید.
<pubDate> اختیاری. تاریخ آخرین انتشار این پروژه را تعریف کنید.
<source> اختیاری. یک منبع سوم برای این پروژه مشخص کنید.
<title> ضروری. عنوان این پروژه را تعریف کنید.