=== Random Background Image Per Session === Contributors: waffleguy4 Tags: background, backgrounds, bg, image, images, picture, pictures, random, header, theme plugin Requires at least: 2.0.2 Tested up to: 3.1.1 Stable tag: 1.1.0 Chooses a random background image for each site visitor, but remembers the chosen background on each sub-page for the entire visit session. == Description == This plugin makes it easy to have a random background image displayed from a folder of available images, such that every time a user visits your site they see a "fresh" new look to your site. Additionally, the image is saved in a temporary cookie so that the chosen background image remains the same for the entire visit of the user on your site. The next time they visit your site, and once the browser cookie has expired, a new image will be randomly chosen. This is usually every 6 hours, but may vary due to various reasons. The plugin automatically adds the background image code to the bottom of your page, and will be displayed full screen behind all the other content. A nice cool effect. Once installed and activated through the WordPress plugin manager, there are 2 options you need to configure in the admin part of your site. You will probably need FTP access to upload your folder of images, unless they are already on the server. More Info [Plugin Article](http://davetcoleman.com/blog/random-background-image-per-session) Thanks to kdmurray (kdmurray.at.kdmurray.dot.net) to who made a similar plugin that I based this off of. == Installation == 1. Install and activate through your Wordpress' Admin plugins page. 2. Within Admin, on the left "Settings" sub-menu, select the "Random Background" menu. 3. Fill in the 2 settings for your physical and http paths (see below) 4. (optional) Input an additional css style, for example if you need to specify the background max height. = Settings = * The server sub-folder path to where you would like to randomly pull the images from: (e.g. wp-content/uploads/bg-images/) * Background image height - sets the height of your image background. Default is 100% but this may look too stretched if you have long pages. We recommend having another background image defined in your style sheets that can repeat the whole page width, and the random background image defined to a certain pixel height, like 800px. Advanced (optional) * Custom CSS class - defined in your own style sheet. This class name is inserted into the img tag of the background image. * Disable session persistance - a new background image will be chosen everytime you refresh the page. = Notes = * It uses the default php session length, so for testing you will need to clear your cookies or disable session persistance on the setting page to see a new image be chosen. * You may need to do a little css tweaking of your style sheet to account for the fact that a full size background image doesn't always stretch the whole height of the page - ie add a matching background color, a secondary background image pattern to start below the main one, or a gradient on the bottom of the randomly chosen background images. == Changelog == = 1.0.0 = * Started project = 1.0.1 = * Tweaked documentation = 1.1.0 * Added BG height option * Added disable session persistance option * Removed relative path setting. Now based on Wordpress base path. Hopefully this won't break anything on other ppl's installs. * Improved documentation. == Feedback == davetcoleman@gmail.com