=== Random Posts ===
Contributors: RobMarsh
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=donate%40rmarsh%2ecom&item_name=Rob%20Marsh%27s%20WordPress%20Plugins&item_number=Random%20Posts&no_shipping=1&cn=Any%20Comments&tax=0&currency_code=GBP&lc=GB&bn=PP%2dDonationsBF&charset=UTF%2d8
Tags: posts, random, random posts, post-plugins
Requires at least: 1.5
Tested up to: 2.5.1
Stable tag: 2.5.0

Displays a list of random posts.

== Description ==

Random Posts displays a list of randomly chosen posts. The output can be customised in [many](http://rmarsh.com/plugins/post-options/) ways. 

This plugin **requires** the latest version of the *Post-Plugin Library:* [download it now](http://downloads.wordpress.org/plugin/post-plugin-library.zip).

== Installation ==

1. IMPORTANT! If you are upgrading from a previous version first deactivate the plugin, then delete the plugin folder from your server. 

1. Upload the plugin folder to your /wp-content/plugins/ folder. If you haven't already you should also install the [Post-Plugin Library](http://wordpress.org/extend/plugins/post-plugin-library/)></a>.

1. Go to the **Plugins** page and activate the plugin.

1. Put `<?php random_posts(); ?>` at the place in your template where you want the list to appear or use the plugin as a widget.

1. Use the **Options/Settings** page to adjust the behaviour of the plugin.

[My web site](http://rmarsh.com/) has [full instructions](http://rmarsh.com/plugins/random-posts/) and [information on customisation](http://rmarsh.com/plugins/post-options/).

== Version History ==

* 2.5.0
	* {image} has new post, link, and default parameters
	* new {imagesrc} tag
	* fix to empty category bug
	* excluded posts bug fix
	* fix for intermittent bug with 'omit current post' option
* 2.5b26
	* reverted thumbnail serving (speed)
	* fix current post after extra query
* 2.5b25
	* option to sort output, group templates
	* removed 'trim_before' option added more logical 'divider'
	* {date:raw}, {commentdate:raw}, etc.
	* fix for {image} resizing when <img > and not <img />
	* {image} now serves real thumbnails
* 2.5b24
	* fix for recursive replacement by content filter
	* fix to {gravatar} to allow for 'identicon' etc.
	* fix to {commenter} to allow trimming
	* fix a warning in safe mode
* 2.5b23
	* new option to filter on custom fields
	* nested braces in {if}; condition now taggable
	* improved bug report feature
	* better way to omit user comments
* 2.5b22
	* fixes for tag bugs
	* show_pages option can now show only pages
* 2.5b19
	* fix for content replacement filter
* 2.5b18
	* fix output filter bug
	* new conditional tag {if:condition:yes:no}
* 2.5b16
	* fix for {php}
* 2.5b15
	* fix bugs, add 'included posts' setting
* 2.5b14
	* fix file-encoding, installation error, etc.
* 2.5b11
	* some widget fixes
* 2.5b9
	* clarifying installation instructions

* [previous versions](http://rmarsh.com/plugins/random-posts/)