Cooliris Embed

Flickr API Support

We know a lot of you are photographers, but do not have the time to construct a Media RSS feed of your photos to display on your Cooliris Wall. Now, you can simply point the embeddable wall to your Flickr sets to show off your artistic side! If you use Picasa Web, click here.

Copy and paste this embed code onto your webpage:


<object id="o" classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000" width="760" height="450">
    <param name="movie" value="http://apps.cooliris.com/embed/cooliris.swf" />
    <param name="flashvars" value="feed=api://www.flickr.com/?user=hsunaqua" />
    <param name="allowFullScreen" value="true" />
    <param name="allowScriptAccess" value="always" />
    <embed type="application/x-shockwave-flash" src="http://apps.cooliris.com/embed/cooliris.swf" width="760" height="450"
        flashvars="feed=api://www.flickr.com/?user=hsunaqua" allowFullScreen="true" allowScriptAccess="always"></embed>
</object>

The custom api:// scheme supports three parameters (user, album, and search). The user parameter tells the api to retrieve photos from a particular user. With the Flickr API, you can use your Flickr username or NSID. To find your Flickr NSID, which looks like 11071871@N05, go here and submit your Flickr homepage's URL (e.g., http://www.flickr.com/photos/krispyzelda/).

For example, the next two feed parameters both load photos from the same user (although 11071871@N05 loads faster, as it saves us the lookup).

api://www.flickr.com/?user=hsunaqua

api://www.flickr.com/?user=11071871@N05

The album parameter loads photos from a particular Flickr set: http://www.flickr.com/photos/hsunaqua/sets/72157602254201805/. Notice how the album parameter matches the identifier in the Flickr set's URL.

api://www.flickr.com/?album=72157602254201805

Finally, the search parameter loads photos from a a web search:

api://www.flickr.com/?search=puppy

Search over Metadata

The embeddable app now supports search within the wall! Try typing search terms like "surf" or "zoo" into the example gallery. Currently, we search over title and description tags, so make sure to add more metadata to your Media RSS feeds.

<?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>
    <item>
        <title>Searchable Title</title>
        <link>http://www.sanjosesabercats.com/</link>
        <guid isPermaLink="false">d59f51a0-7e04-11dd-ad8b-0800200c9a66</guid>
        <description>This description text is also searchable!</description>
    </item>
</channel>
</rss>

Customizing the UI

Light / White Background

Your site may have a light background color, so a dark wall might stand out a bit too much. :-\ You can now specify a style parameter to choose a light or white background:

<param name="flashvars" value="style=white&feed=api://www.flickr.com/?user=hsunaqua" />

or

<param name="flashvars" value="style=light&feed=api://www.flickr.com/?user=hsunaqua" />

Hide Search and Embed Controls

Maybe you are not a fan of search. Perhaps you don't want other people embedding your wall of photos on their own blogs. We totally understand. :-) That's why you can turn off these components with the following parameters (you may use one or both of them):

<param name="flashvars" value="showEmbed=false
&showSearch=false&feed=api://www.flickr.com/?user=hsunaqua" />

Please send your feedback or bug reports to bugs@cooliris.com. Alternatively, you may post feedback on the Developer's Forum: http://developer.cooliris.com/dev_forum/.

Media RSS Support

If you host your photos and videos on your own website, you will be interested in reading up on how to enable your site with Media RSS.