Scripts.Indisguise.Org - a hobbyist's blog and scripts archive

This plugin retrieves a random post/page/either one of them from your WordPress installation, used in much the same way as the get_posts() WordPress function. The plugin was based off from Gruppo Modulo’s Random Subpages plugin but extended because I needed much more than subpages.

Installation

1. Download the plugin here.
2. Unzip it somewhere.
3. Upload ind_random_content.php into your wp-content/plugins directory.
4. Go to your WordPress Admin Panel > Plugins and activate the plugin.

Usage

To use the plugin to show a random post and/or page, you should open up your template file and use the following function:

ind_get_random_content( $arguments );

Possible arguments are:

show (string)

show only posts, or pages, or both

possible values: post | page | all | both

numberposts (integer)

number of posts/pages to return

parentpage (integer)

limits returned pages to subpages of parentpage

categories (integers, separated by commas)

limits returned posts to posts filed under categories found in arguments

exclude (integers, separated by commas)

limits returned posts to posts NOT filed under categories found in arguments

Sample Usage

To use the plugin to get and show one random post from categories with IDs 3, 4, and 5:

<?php
$myposts = ind_get_random_content( 'show=post&numberposts=1&categories=3,4,5' );
foreach( $myposts as $post ) {
	setup_postdata( $post ); 
?>
	<h1></h1>
	<p><?php the_content(); ?></p>
<?php
}
?>