N4R Most Commented Posts Wordpress Plugin v1.0 
Last revision: June 5th 2007
First released: June 4th 2007
Nick Ramsay http://www.nice4rice.com/2007/06/03/most-commented-wp-plugin/

READ ME
-------

INSTRUCTIONS:
-------------

1) Unzip most_commented_posts.zip
2) Open the most_commented_posts folder and upload most-commented-posts.php to your plugins folder in wp-content.
3) Activate N4R Most Commented Posts in Plugins in Wordpress Admin. 
4) Place the following function call wherever you want the list of most commented posts to appear.

<?php n4r_most_commented_posts(); ?>


CONFIGURATION:
--------------

Parameters:

n4r_most_commented_posts($no_posts, $count, $before, $after)

$no_posts - sets the number of random posts to display

$days - comments posted within the last X days. Default is 'all' meaning all comments.

$count - if 'true' then the number of comments will show beside each post title, otherwise 'false'.

$before - text to be displayed before the link to the random post

$after - text to be displayed after the link to the random post


Default behavior: 

n4r_most_commented_posts() 

is the same as: 

n4r_most_commented_posts(10, 'all', 'true', '<li>', '</li>')


EXAMPLES:
---------

Default (see above):

<ul>
<?php n4r_most_commented_posts(); ?>
</ul>

Show 6 random posts instead of the default 10:

<ul>
<?php n4r_most_commented_posts(6); ?> 
</ul>

Show 8 posts, without a comment count:

<ul>
<?php n4r_most_commented_posts(8, 'all', 'false'); ?> 
</ul>

Show 10 posts from with the last 90 days:

<ul>
<?php n4r_most_commented_posts(10, '90'); ?> 
</ul>

Show 10 posts from with the last 90 days, without a comment count:

<ul>
<?php n4r_most_commented_posts(10, '90', 'false'); ?> 
</ul>

Don't use a list, just line break after each one:

<?php n4r_most_commented_posts(10, 'all', 'true', '', '<br />'); ?>