=== Flickrpress ===

Donate link: http://michael.tyson.id.au/wordpress/plugins/flickrpress/
Tags: flickr
Requires at least: 2.6
Tested up to: 2.7.1
Stable tag: 0.3

Display Flickr items in the sidebar. Supports Flickr RSS, photostream, multiple photosets, favorites, filtering by tag and displaying random photos.

== Description ==

This is a widget to display items from Flickr in the sidebar.  This widget supports:

 * Flickr RSS feeds
 * Photostream
 * Filtering by tag
 * One or more photosets
 * Favorites
 * Displaying random items
 * Use as a shortcode function, or a PHP function on its own

Other features:

 * Choose from three different thumbnail types
 * Lightbox/Thickbox are supported
 * Data is cached locally to lower server load
 * Secure Flickr API used, to eliminate the risk of damage to your server, unlike some other Flickr widgets
 * Flickrpress is a multi-widget, so you can use more than one instance (e.g., one in your sidebar, one in your footer)

Flickrpress uses the excellent phpFlickr library.

== Installation ==

1. Unzip the package, and upload `flickrpress` to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Add the 'Flickr Widget' to your sidebar and configure

== Styling ==

Flickrpress comes with CSS styling, but if you wish to modify its appearance, simply style the "`flickrpress-container`" class.  See `style.css` for more.

== Use outside of the sidebar ==

For use as a shortcode or a PHP function (both called 'flickrpress'), the following parameters are available:

 * *type*        One of: 'rss', 'photostream', 'sets', 'favorites'
 * *url*         URL for RSS feed
 * *api_key*     API Key for types other than RSS
 * *account*     Account name, email or ID
 * *sets*        Comma-separated list of photoset titles
 * *tags*        Comma-separated list of tags to filter by (for photostream view)
 * *view*        One of: 'squares' (view as squares), 'proportional' (proportional thumbnails) , 'large' (large thumbnails)
 * *count*       Number of thumbnails to display
 * *random*      'true' to display randomly
 * *lightbox*    'true' to use Lightbox
 * *css*         'true' to add CSS styling
 
Example shortcode use:

`[flickrpress type="rss" url="http://api.flickr.com/services/feeds/photos_public.gne?id=55051746@N00&lang=en-us&format=rss_200"]`


== Changes ==

* 0.3: Support for use outside of sidebar
* 0.2.1: Bugfix for displaying random favourites
* 0.2: Now able to be styled as described in http://www.webdesignerwall.com/tutorials/css-decorative-gallery/. See style.css for more info.
* 0.1.1: Bugfix for when only 1 random image shown
* 0.1: Initial release

== Screenshots ==

1. Photoset configuration
2. Flickr RSS feed configuration
3. Plugin display