=== flickpress ===
Contributors: isaacwedin
Donate link: http://familypress.net/flickpress/
Tags: images, photos, flickr
Requires at least: 2.9
Tested up to: 2.9.2
Stable tag: 1.7

flickpress is a tool to find Flickr photos and insert them into your posts, plus a widget to display recent Flickr photos.

== Description ==

flickpress adds a button to the post editor to find and insert Flickr photos into WordPress posts. Add Flickr users by entering their usernames or email addresses. Previously-entered Flickr users are stored in a database table that can be managed at Tools:flickpress. Search for users' photos by keyword or browse tags, photosets, favorites, or recent photos. You can also search for Creative Commons, Flickr Commons, and government photos. Click through to a photo to insert a variety of sizes, adding a variety of caption information if desired.

== Installation ==

1. Extract the plugin archive in your `/wp-content/plugins/` directory, creating a 'flickpress' folder there.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Enter your Flickr API key at Settings:flickpress and configure other
options.
4. If you wish to use the caption function, your theme should include some caption-related style stuff - which it probably does - but see the WordPress default theme for an example if not.

== Widget ==

The widget just packages the template function in convenient widget form. To use it, activate it through the 'Plugins' menu in WordPress and add it to your sidebar through the 'Widgets' menu. It requires some things in the main plugin, so you'll need to have both activated.

Just like with the template function, you may specify a class for the images,
and text (such as HTML tags) to display before and after each image. Some tips:

* For a horizontal display, put nothing or just spaces before and after.
* For a vertical display, either use `<p>` before and `</p>` after or just a `<br />` after.
* Most themes include a class called "centered" that will center your images in the sidebar.

== Template Function ==

There is a simple template function available for use in your sidebar or other spots you'd like to include a few recent flickr photos. The function, its options, and the defaults are:

`flickpress_photos($email,$numphotos=3,$before='',$after='<br />',$fpclass='centered');`

== Notes ==

This plugin relies heavily on Dan Coulter's nice phpFlickr library ( <http://phpflickr.com/> ). Using more than one plugin based on the library can cause conflicts, so I renamed the class in the library included with flickpress. If you're considering creating a plugin based on flickpress I highly recommend getting the latest official version of phpFlickr instead of using this modified version.

== Changelog ==

= 1.7 =
* Fix for Flickr API change.
* Fixed extra Home link for commons search image page.
* Fixed popup style for WP 3.0.

= 1.6.1 =
* Fixed add user bug, added error handling.

= 1.6 =
* Added some error handling.
* Made navigation headings more consistent.
* Fixed warning for empty EXIF data, added reporting for empty EXIF and description.
* Added interesting photo browsing.
* Added older/newer links.
* Markup cleanup, should now pass validation.

= 1.5 =
* Renamed phpFlickr class and calls to eliminate plugin conflicts.
* Added favorites.
* Fixes error when inserting captions with funky characters.

= 1.4 =
* Added options to include photo description and EXIF info in photo captions.

= 1.3 =
* Added caption alignment class option.
* Updated phpFlickr to 2.3.1.

= 1.2 =
* Tested for WP 2.9.
* Moved things around on the photo insert page.
* Turned captions on by default when no option set.

= 1.1 =
* Changed popup.php to use wp-load.php instead of deprecated wp-config.php.

= 1.0 =
* Added widget options to display something (HTML tags) before and after each image.

= 0.9 =
* Added admin notice for missing Flickr API key.
* Set "edit_posts" as the default capability to use plugin.
* Added Flickr API key and capability checks to the settings page.
* Added option to turn captions on or off by default.
* Added jquery show/hide for license lists in the popup.
* Fixed "next page" bug for commons search.

== Upgrade Notice ==

= 1.7 =
* Fix for Flickr API change, fixed extra Home link for commons search image page, fixed popup style for WP 3.0.

= 1.6.1 =
* Fixes a bug in 1.6 where users couldn't be added.

= 1.6 =
* This version adds some error handling, makes the navigation headings more consistent, fixes empty EXIF warning, adds interesting photo browsing, adds a bunch of older/newer links, fixes markup validation issues.

= 1.5 =
* This version fixes a compatibility issue with other phpFlickr-based plugins, fixes a JavaScript error when inserting captions with funky characters, and adds favorites browsing.