rss feed creation tool
logo
FeedForAll RSS Feed Creation Site Map Contact FeedForAll
Welcome!

Simple Lists (Microsoft)

Extension: Simple List Extensions

Extension Name: cf

Purpose: The Simple List Extension has two purposes. The primary purpose is to illustrate that a feed is a list. The secondary purpose of the list extension is to allow publishers to mark up the lists to note which item properties the user may be interested in sorting or grouping by.


Declaration:
The name space for Simple Lists is defined at http://msdn.microsoft.com/windowsvista/building/rss/simplefeedextensions/ though the specification references the following url for the definition.

<rss version="2.0" xmlns:cf ="http://www.microsoft.com/schemas/rss/core/2005 ">

Elements:
<cf:treatAs> is a sub-element of the <channel> tag.

<cf:listinfo> is a sub-element of the <channel> tag and contains <cf:sort> and <cf:group> tags which define the sorting and grouping capabilities off the feed.

The <cf:sort> tag can either specify a name for the default sort, the order the items as provided in the feed or it can provide the information necessary to resot the items in the feed. To do this it tells the tag name, the name space the tag is in, what type of data is in the tag and a name for the sort.

The <cf:group> tag specifys a way to group the items in a feed. It specifies the tag, namespace and a label.


Example:
<!-- Snipped for Brevity -->
<?xml version="1.0" encoding="UTF-8"?>
<rss xmlns:cf=
http://www.microsoft.com/schemas/rss/core/2005" xmlns:birds="http://www.birds.xml/birdsDTD/" version="2.0">
<channel>
<title>
Bird Watchers Blog</title>
<description>
This is a blog of the birds I have seen. </description>
<link>
http://www.mysite.com/birds.htm</link>

<cf:listinfo>
<cf:sort ns=
"http://www.birds.xml/birdsDTD" element="wingspan" data-type="number" label="Wingspan" default="no"/>
<cf group ns=
"http://www.birds.xml/birdsDTD/" element="songbird" label="Songbirds"/>
</cf:listinfo>

<item>

<title>The Robin</title>
<link>http://www.mysite.com/birds.htm</link>
<description>The red breasted Robin</description>
<pubDate>
Thu, 15 Dec 2005 12:16:12 -0500</pubDate>
<birds:wingspan>20</birds:wingspan>
<birds:songbird>
yes</birds:songbird>
<birds:eggs>
4</birds:eggs>
</item>

<item>

<title>The Raven</title>
<link>http://www.mysite.com/birds.htm</link>
<description>The black Raven</description>
<pubDate>
Thu, 15 Dec 2005 12:16:12 -0500</pubDate>
<birds:wingspan>120</birds:wingspan>
<birds:songbird>
no</birds:songbird>
<birds:eggs>
6</birds:eggs>
</item>


<item>

<title>The Scarlet Rosefinch</title>
<link>http://www.mysite.com/birds.htm</link>
<description>The Scarlet Rosefinch</description>
<pubDate>
Thu, 15 Dec 2005 12:16:12 -0500</pubDate>
<birds:wingspan>24</birds:wingspan>
<birds:songbird>
yes</birds:songbird>
<birds:eggs>
5</birds:eggs>
</item>

<!--Snipped for Brevity-->


Example #2:
<!-- Snipped for Brevity -->
<?xml version="1.0" encoding="UTF-8"?>
<rss xmlns:itunes
="http://www.itunes.com/dtds/podcast-1.0.dtd" xmlns:cf="http://www.microsoft.com/schemas/rss/core/2005" version="2.0">
<channel>
<title>
My favorite music</title>
<description>
Songs I like</description>
<link>
http://www.mysite.com/music.htm</link>
<itunes:owner>
<itunes:email>
support@feedforall.com</itunes:email>
<itunes:name>
FeedForAll Mac OS Team </itunes:name>
</itunes:owner>


<cf:listinfo>
<cf:sort ns=
"http://www.itunes.com/dtds/pdocast-1.0.dtd" element="explicit" data-type="text" label="Explicit Songs" default="no"/>
<cf:sort element
="category" data-type="text" label=Song Category" default="no"/>
</cf:listinfo>

<item>

<title>Twinkle, twinkle little star </title>
<description>popular childrens song</description>
<link>http://www.mysite.com/song.htm</link>
<category>Childrens Songs</category>
<enclosure url=
"http://www.mysite.com/twinkle.mp3" length="23432" type="audio/mpeg"> </enclosure>
<pubDate> Thu, 15 Dec 2005 12:16:12 -0500</pubDate>
<itunes:subtitle>
Twinkle, twinkle littel star</itunes:subtitle>
<itunes:duration>3.30</itunes:duration>
<itunes:explicit>no</itunes:explicit>
</item>

<item>
<title>Gangsta Killing</title>
<description>rap music</description>
<link>http://www.mysite.com/song.htm</link>
<category>Gangsta Rap</category>
<enclosure url=
"http://www.mysite.com/gangsta.mp3" length="43432" type="audio/mpeg"> </enclosure>
<pubDate> Thu, 15 Dec 2005 12:16:12 -0500</pubDate>
<itunes:subtitle>
Gangsta Killingr</itunes:subtitle>
<itunes:duration>2.35</itunes:duration>
<itunes:explicit>yes</itunes:explicit>
</item>

<!--Snipped for Brevity-->