عنصر <item> RSS

هر <item> عنصر می‌تواند یک مقاله یا "story" در 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> می‌تواند یک مقاله یا داستان در 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" />

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

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