==================================================================
Snippet-title:		top_commenters v1.3
Creator:		Graham Keellings
E-mail:			pivot@keellings.com
Website:		http://www.keellings.com/software/pivot.php
Creation date:		18 Sep 2006, Singapore
==================================================================

Content of zipped file:
-----------------------
snippet_cat.php
readme_cat.txt (this file)


Usage:
------
1) unpack this package in your extensions/snippets/ folder.
2) place a [[top_commenters]] tag, with the appropriate parameters, 
   in a template file, whereever you want the output to appear

   
Description:
------------
* A snippet to those who comment most often on your blog, with, optionally, a
* link to their website.



Parameters:
-----------
* @param  int     maxCommenters - show this many top commeters (dafault = 10)
* @param  string  weblog     - pass '.'for the current blog, '*' for
*                              all blogs, or a blog title like my_blog
* @param  string  author     - pass an author's name to restrict 
*                              selection, or '*' for all authors (default),
*                              or '.' for 'author of current entry' (for
*                              use in your entrypage_template.html
* @param  string  category   - consider only entries of the given category, or
*                              all categories if omitted or set to *.
* @param  string  formatText - if specified, this text will be used to format 
*                              the output details of each commenter. 
*                              Default = '%url% (%num% comments)'
*                              The following tags will be substituted:
*                                %name% the commneter's name
*                                %url% the commenter's url, if he left one, with
*                                   his name as text. 
*                                     E.g this might expand to 
*                                        <a href="http:xyz.com>XYZ</a> 
*                                     or just to XYZf he left no URL.
*                                     NOTE: if there was no url, this will be
*                                     treated as %name, so do not use both
*                                     %url% and %name%                                     
*                                %num% the number of comments which the commenter made
*                                   (I am willing to add more on request, like
*                                    the total number of all comments, and this
*                                     commenter's total expressed as a percentage 
*                                     of the grand total, etc)
*                                e.g   <h4>%name% has commented %num% times</h4>
*                                      <h4>%url% has commented %num% times</h4>
* @param  string  exclude    - a list of commenters names, seperated by | who 
*                               should not be included.E.g   graham|admin
* @param  int     sort       - Whether or not ro show commenters who did not
*                              leave their URL:
*                                 0 (default) show those who did give a URL, 
*                                    until "maxCommenters" entries. If there
*                                    are less, list is shorter.                               
*                                 1 show those who did give a URL, 
*                                    until "maxCommenters" entries. If there
*                                    are less, then next show those who 
*                                    did not give a URL.                               
*                                 2 don't distuinguish between who did and did not
*                                    give a URL. Just sort by number of comments.
* @return The requested HTML, as specified by the parameters.


Example: [[top_commenters:5:.:*:te