=== Easy Random Posts ===
Contributors: christopherross,thisismyurl
Plugin URI: http://thisismyurl.com/downloads/easy-random-posts/
Tags: wordpress,easy,random,posts,theme,php,code,sidebar,list posts,  plugin, post, posts
Donate link:  http://thisismyurl.com/
Requires at least: 3.2.0
Tested up to: 4.1.0
Stable tag: 2.1.4

An easy to use WordPress function to add random posts to any theme.

== Description ==

This easy to use WordPress plugin is designed to add a new feature for theme developers. Used on many of my own websites as well as those of my clients, the plugin allows me to quickly add a collection of random posts to any theme element.

To add random posts to your website, simply add the code <?php thisismyurl_easy_random_posts();?> to your element. This will generate a list of random posts to your website.

This plugin is maintained by Christopher Ross, http://thisismyurl.com or you can find him on Twitter at http://twitter.com/thisismyurl/

== Installation ==

To install the plugin, please upload the folder to your plugins folder and active the plugin.

== Screenshots ==

1. Screenshot of Widget

== Updates ==
Updates to the plugin will be posted here, to [Christopher Ross](http://thisismyurl.com/downloads/easy-random-posts/)

== Frequently Asked Questions ==

= How do I display the results? =

Insert the following code into your WordPress theme files:

= General results =
Without passing any parameters, the plugin will return ten results or fewer depending on how many posts you have.

 thisismyurl_easy_random_posts('count=10');

= Altering the before and after values =
By default the plugin wraps your code in list item (&lt;li&gt;) tags but you can specify how to format the results using the following code:

 thisismyurl_easy_random_posts('before=&lt;p&gt;&amp;after=&lt;/p&gt;');

= The Order =
You can now change the order of the results using ASC, DESC or RAND to return the results in ascending, descending or random order of date published.

 thisismyurl_easy_random_posts('order=ASC;');

= Nofollow =
You can set if the link is displayed as a nofollow link for SEO optimization using the new nofollow option.

 thisismyurl_easy_random_posts('nofollow=true;');


= Echo vs. Return =
Finally, if you'd like to copy the results into a variable you can return the results as follows:

 thisismyurl_easy_random_posts('show=false');


== Donations ==
If you would like to donate to help support future development of this tool, please visit http://thisismyurl.com/


== Change Log ==

= 2.1.4 =

* Fixed random setting

= 2.1.2 = 

* Added thumbnail option
* Added excerpt option
* Added optional credit link

= 2.0 =

* Tested up to WordPress 3.2
* Added controls to Widget
* Renamed functions for compatibility
* Reduced font size on credit link


= 1.7 =

* Added shortcode
* Replaced widget code with WP_Widget class
* Added comments option to filter


= 1.6.6 =

* Cleaned up code for 3.0.3
* Fixed credit line to work reliably
* Removed RSS feed


= 1.6.5 =

* Added new widget controls

= 1.5.5 =

* Updated RSS links
* Code optimizations

= 1.5.2 =

* Fixed documentation
* Updated Links

= 1.5.1 =

* Added widget

= 1.5.0 =

* Rewrote common functions
* Removed options page (no options)
* Added credit option to plugin

= 1.1.5  =

* WP2.8.6 Compatibility Review, documentation fixes

= 1.1.0   =

* WP2.8 Compatibility Fixes

= 1.0.0 =

* Official Release

= 0.1.0 =

* Added admin menus