=== WP Flickr Background ===
Contributors: myatu
Tags: flickr, photo, theme, background
Requires at least: 2.8
Tested up to: 2.9.1
Stable tag: 1.0.2

WP Flickr Background is a WordPress plugin that allows you to display a photo
from Flickr as the theme background.

== Description ==

WP Flickr Background is a simple to use WordPress plugin that allows you to 
display a photo from Flickr as the theme background, without the need to 
modify any files.

All you need to do is create one or more galleries within the plugin's settings, 
each containing a collection of photos from Flicker that you have chosen, and WP 
Flickr will randomly select a photo from the active gallery to display as the
theme background.

You can also customise a gallery by adding CSS styling code that will be loaded 
along with the photo, allowing you to color match the Wordpress theme to 
the particular photo displayed or for other use.

= Features =

* Decide how often the background image should change (ie., every day, once
  per browser session, etc.)
* Stretch a background photo horizontally and/or vertically
* Align background photos according to the visitor's screen layout
* Optionally disable the original theme's background
* Optional Javascript compression
* Support for WordPress caches such as WP Super Cache
* Multiple galleries
* Custom CSS style sheet per gallery, loaded with the theme if it's active

= Browser Compatibility =

WP Flickr Background has been tested and known to work with the following browsers:

* Google Chrome 3+
* Opera 10+
* Firefox 3+
* Microsoft Internet Explorer 7+
* Safari 4+
* Lynx

= License =

[GNU GPL version 3](http://www.gnu.org/licenses/)


== Installation ==

1. Upload the contents of the ZIP file to the `/wp-content/plugins/` directory
1. Activate the plugin through the 'Plugins' menu in WordPress
1. Access the plugin's configuration through the 'Settings/WP Flickr Background' menu to:
    * Configure options
    * Add galleries and photos
    * Read more detailed help

= Requirements =

* WordPress version 2.8 or better
* PHP version 4.2.3 or better
* A browser with Javascript support enabled

	
== Screenshots ==

1. Editing a gallery
2. Overview of available galleries
3. Main configuration screen, with tooltips
4. An example of a Flickr photo used as a WordPress theme background


== Frequently Asked Questions ==

= How do I create a new gallery? =

1. Access 'Settings/WP Flickr Background' from the WordPress Administration 
1. Select the 'Galleries' submenu
1. Click the 'Add New Gallery' button

= How do I add photos to a gallery? =

After you create or edit a gallery, visit [Flickr](http://www.flickr.com/ "Flickr") and
start searching for photos that interest you. Once you have found a photo, click on it to
view details about it. You can copy the URL (web address, usually found at the top of your 
web browser) and paste it in the field next to the 'Add Photo' button. Click the 
'Add Photo' and it should be added to the gallery.

Examples of valid URLs are:

* `http://www.flickr.com/photos/bees/155761353/` 
* `http://www.flickr.com/photos/bees/155761353/sizes/o/`
* `http://farm1.static.flickr.com/2/1418878_1e92283336_m.jpg`

After you have added photos, click the 'Add Gallery' or 'Edit Gallery' button found at
the bottom of the page.

*Tip!* Many web browsers allow you to drag a photo directly onto the field next to the
'Add Photo' button, making it very simple to add photos!

= My website seems slower now, why? =

There are several ways to speed up WP Flickr Background:

1. Access 'Settings/WP Flickr Background' from the WordPress Administration
1. Under the 'Advanced Configuration' heading:
    * Disable the theme background by checking/ticking 'Theme Backround'
    * Enable 'Javascript Compression'
    * Enable 'Cacheable'
	
Or you create a file named '.confighash' in the `/wp-content/plugins/wp-flickr-background/`
directory and make it writable. On Linux or similar operating systems this can be
done with:

1. `touch .confighash`
1. `chmod 666 .confighash`

= The browser has become sluggish, why? =

A few browsers have difficulty rendering large images overlaid by other content. There
are a few options you could try:

* Disable both horizontal and/or vertical image stretching
* Choose images which list the largest available size as smaller than 2048 x 1536

= Some visitors complain about Javascript errors, what can I do? =

You may wish to turn off the Javascript compression used by the plugin:

1. Access 'Settings/WP Flickr Background' from the WordPress Administration
1. Uncheck/untick the 'Javascript Compression' under the 'Advanced Configuration' heading
1. Save the changes

== Changelog ==

= 1.0.2 =
* Moved plugin to beta stage
* Corrected description regarding chmod and the .confighash file

= 1.0.1 =
* Initial alpha release

== Credits ==

A special thank you to the OVH UK customers and employees who helped me debug the very first 
version of WP Flickr Background (in no particular order):

* Razakel
* gregoryfenton
* Andy
* NickW
* Jonlewi5
* Fozle
* Ashley 
* Neil

And of course YOU!