Media RSS feeds give you the most flexible and powerful way to control what and how content should display on your Cooliris Wall. An open standard for syndicating multimedia content, Media RSS was created by Yahoo!, who maintains complete documentation on its website.
For any particular item in your wall, Media RSS lets you define the media item's source, display dimensions, metadata, link out URL, and much more. Media RSS is what allows Cooliris to understand which thumbnails link to which high-resolution images.
Setting up your own Media RSS feed for Cooliris requires only two steps:
- Create a Media RSS feed.
- Enable cross-domain access for Adobe Flash support.
Create your media rss feed
Below is a sample Media RSS feed that contains an image and a video. You can use this as a template to create and extend your own feed. Simply cut and paste the code, edit it as needed, and save it as an .xml file (such as mymedia.xml) to create your Media RSS feed.
<?xml version="1.0" encoding="utf-8" standalone="yes"?> <rss version="2.0" xmlns:media="http://search.yahoo.com/mrss/" xmlns:atom="http://www.w3.org/2005/Atom"> <channel> <title>Feed title</title> <description>Feed Description</description> <link>http://www.example_url.com</link> <item> <title>Picture A</title> <media:description> This one's my favorite.</media:description> <link>pl_images/A.jpg</link> <media:thumbnail url="http://example.com/pl_thumbs/A.jpg"/> <media:content url="http://example.com/pl_images/A.jpg"/> </item> <item> <title>Video B</title> <link>http://example.com/pl_images/B.jpg</link> <media:thumbnail url="http://example.com/pl_thumbs/B.jpg"/> <media:content type="video/x-flv" url="http://example.com/pl_images/B.flv"/> </item> </channel> </rss>
In the Media RSS sample above, note how it requires a <item> tag around each photo or video to appear in the Cooliris Wall. The <media:thumbnail> and <media:content> tags specify the locations of the thumbnail and full-size image content. For videos, ensure that the <media:content> tag includes type="video/x-flv".
In properly formatted HTML and Media RSS feeds, there are certain characters that must be displayed as code or else they will cause problems. These characters are:
& => & < => < > => > ' => ' " => "
We highly recommend you run your Media RSS through the online Feed Validator tool to see any escaped characters you have not caught. It'll also catch any syntax errors. Make sure those pesky devils stay out of your Media RSS!
If you are an advanced user, you can use scripting to dynamically generate Media RSS feeds from a database of images or videos. Feed URLs with ampersands (&) need to be encoded (check out our tool that makes this easy).
Once your Media RSS feed is created, set the value of the feed FlashVar to point to the URL of your Media RSS feed as the source for your content.
Enable cross-domain access for flash
In order for Adobe Flash objects to display within the embeddable Cooliris Wall on your site, you'll need to create an crossdomain.xml file and publish to the root of your website, for example, http://www.mysite.com/crossdomain.xml.
Your crossdomain.xml file should look like this:
<?xml version="1.0"?> <!DOCTYPE cross-domain-policy SYSTEM "http://www.macromedia.com/xml/dtds/cross-domain-policy.dtd"> <cross-domain-policy> <allow-access-from domain="*.cooliris.com" secure="false" /> </cross-domain-policy>
Simply copy, paste, and save the file as crossdomain.xml and then upload it.
For more information, read about Adobe's cross-domain policy file specification.
Advanced features, such as multiple gallery integration and dynamic feeds, require adding the atom namespace in your RSS. To do so, add the highlighted text to your opening <rss> tag:
<rss version="2.0" xmlns:media="http://search.yahoo.com/mrss/" xmlns:atom="http://www.w3.org/2005/Atom"
Instead of having one large Media RSS feed of content, you can page it into many individual feeds. In your Media RSS feed, just link each feed with <atom:link rel="previous"/"next".../> tags inside the <channel> element like this:
<channel> ... <atom:link rel="previous" href="http://mysite.com/feed1.rss" /> <atom:link rel="next" href="http://mysite.com/feed2.rss" /> ... </channel>
You can even link feeds from different domain names, if you'd like:
<channel> ... <atom:link rel="previous" href="http://mysite.com/photos.rss" /> <atom:link rel="next" href="http://myothersite.com/photos.rss" /> ... </channel>
Note that for these feeds to work properly in the embeddable Cooliris Wall, all the domain names must have a crossdomain.xml file set up.