readme.txt

=== Random Images ===
Contributors: designsimply
Tags: images, random images, shortcode
Requires at least: 2.8
Tested up to: 3.6
Stable tag: 0.7.1
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

The [random_images] shortcode displays random attached images.

== Description ==

The `[random_images]` shortcode will display a simple set of random images.

It was originally designed to be used by theme developers, so the styling is very simple. It was also released as a shortcode so people could use it in content areas if they'd like. You can enable your theme to display the `[random_images]` shortcode in a text widget by adding a snippet of code to the `functions.php` file in your theme or child theme. See the [FAQ](http://wordpress.org/plugins/random-images/faq/ "Random Images FAQ") for more info.

It uses any attached image in the blog for the source images.

Using `[random_images]` will display 6 images at thumbnail size linked to attachment pages by default.

To change the number of images and the size:

`[random_images total=4 size=medium]`

To make the links point to image files instead of attachment pages:

`[random_images link=file]`

If you have any questions, please ask in the [support forum](http://wordpress.org/support/plugin/random-images "Random Images Support Forum").

== Installation ==

1. Download archive and unzip in wp-content/plugins or install via Plugins - Add New.
1. Start using the `[random_images]` shortcode in your content.

== Frequently Asked Questions ==

= How can I use the random_images shortcode text widgets? =

To enable the random_images shortcode in text widgets, add this to the `functions.php` file in your theme or child theme.

`/**
 * If the Random Images plugin is active, allow the random_images shortcode to work in text widgets
 **/
if ( method_exists( 'Random_Images_Plugin', 'random_images' ) )
	add_filter('widget_text', 'Random_Images_Plugin::random_images');`

= How can I use random images in a WordPress theme? =

This example will display a set of random images from a theme file:

`if ( method_exists( 'Random_Images_Plugin', 'random_images' ) )
   echo Random_Images_Plugin::random_images( array( 'size' => 'thumbnail', 'total' => 9 ) );`

== Screenshots ==

1. Set of eight random thumbnail images.

== Changelog ==

= 0.7.1 =
* Switch to using the class as a namespace so it can be called directly in theme files.
* Update code example in readme.txt, move to FAQ.
* Add an option to link directly to files instead of attachment pages.

= 0.7 =
* First version