=== Random Image widget ===
Tags: WordPress, WordPress Plugin, widget, images, photos, sidebar
Contributors: mproulx
Requires at least: 2.0
Tested up to: 2.3
Stable tag: trunk

== Description ==

The Random Image widget displays a user-selectable number of random photos from a directory on the web server in the sidebar of a WordPress blog.


== Installation ==

1. Download and unzip `random-image.zip`.
2. Place `random-image.php` in your blog's plugin subdirectory (e.g., `/wp-content/plugins/`).
3. Create a new subdirectory to hold your images (`random-image` is the recommended name for this directory).
4. Activate the plugin from the Plugins tab of your blog's administrative panel.
5. Go to the Widgets page from the Presentation tab.
6. If you would like to have multiple copies of the widget on your blog, use the selection box at the bottom of the page to add more.
7. Drag the Random Images widget (or widgets) onto the pseudo-sidebar.
8. Use the blue 'settings' box (on the widget's placeholder) to open the settings form.
9. Use the form to adjust any of the visual settings to fit your theme and preferences and save the sidebar settings.  Be sure the directory folder points to the folder you are using to store your images.
10. Click the Save Changes" button. You should be able to see the sidebar on your front page.

== Frequently Asked Questions ==

= I installed the plugin but can't see it.  What's wrong? =

If the widget doesn't show up on the Sidebar Widgets page:
* Check to make sure the plugin was uploaded to the widgets subdirectory.
* Check to make sure both the widgets plugin and the photos plugin are activated.

If the widget doesn't appear on the sidebar once the plugin has been added:
* Make sure the plugin has been dragged to the sidebar.
* Be sure to save changes on the plugin page.
* Make sure the directory name is entered correctly on the settings page

If the widget title appears but no photos appear below it:
* Make sure the directory name is entered correctly on the settings page

= I can't change the settings on the plugin.  What's wrong? =

The popup settings form should work as expected when using Firefox but can be a little touchy when using Internet Explorer or other browsers.  The link to open the form is located on the right side of the rectangle representing the widget.  If it doesn't open when you click, try to click again.

= The widget doesn't work with my theme.  How can I fix this? =

This widget has been tested on a number of themes and is compatible with all truly widget-ready themes.  However, certain formatting settings are "locked" in the code.  

The code isn't locked in stone, however.  You may be able to edit the PHP file to adjust things to your particular code.  You may also contact the plugin author for suggestions; these may result in a better plugin in the future.

== Homepage ==

[http://www.district30.net/random-image-widget](http://www.district30.net/random-image-widget)