##########################################################################
###                    StatWWW 3.0  for Eggdrop 1.3.x                  ###
###             © Goblet 1997-1999  email: goblet@goblet.net           ###
###                                                                    ###
###   READ ALL THE DOCUMENTATION FIRST!   Use with your own risk :)    ###
###     GET THE NEWEST VERSION via http://www.goblet.net/scripts/      ###
###                                                                    ###
###  This is free to use and modify, but please don't remove the info  ###
###  about the author. You only show your lameness that way because so ###
###  many people still know who wrote the original StatWWW.            ###
##########################################################################
### NOTES: -This script uses flag 5 (E) so it WILL interfere with      ###
###         other scripts using that!                                  ###
###  Please send me email and tell the url where your stats are        ###
###  running, but DON'T ASK HELP! You're on your own!                  ###
##########################################################################
 
  HISTORY

 V3.0 
    -Finally converted for Eggdrop version 1.3.x
    -Made some little optimizations.

 V2.x
    -Ported by somebody else, not me. I won't give any more comments ;-)

 V1.6
    -Removed WHEN-command because of uselessness. Use seen if needed!
    -Changed 'Last on' to use chanrecords
    -Optimized almost everything. Now takes MUCH less CPU-time!
    -Added stylesheet usability.
    -Added comment lines before procs :-)
    -People with 0 words aren't shown on web or any other lists.


 V1.52
    -Fixed several non-fatal bugs and made some little "pitchings".
    -Changed the layout a little. 

 V1.51
    -Never published, was just on own use.

 V1.5 
    -Now StatWWW works with Eggdrop version greater than 1.2.0  only.
    -Added multichannel support.
    -Fastlog feature removed because in multichannel use you should have   
     so many logfiles and to reduce taking CPU-time.
    -Lynxfile (plain txt-file) feature removed also for same reason.
    -Removed flag 2 usage and changed locking to flag o (oper)
    -Changed usage of flag 1 to flag 5
    -Changed totally the stats' saveformat in userfile.
    -Added WEED-command. (Idea from Alikki)
    -Removed autodeletion of users with less of 3 pubs 'cos of WEED-cmd
    -Noticed that getlaston & setlaston with channel attribute don't work
     if the user has no flags on that channel, so included last-on-times
     in channel specific stat-records.
    -Added PLACE-command

 V1.4
   -If somebody parts/quits and has less than 3 comments, the bot deletes
     that user because it's very big possibility that he just came to say
     "hello" and won't ever be back. That prevents userfile getting huge.
   -Added DOSTATS dcc-command, see below

 V1.3
   -Fixed bug with words/pubs, no more division by zero.
   -Fixed bug with auto_adduser
   -People can now ask somebody else's stats, see below
   -Added TOPTEN command, see below

 V1.2
   -STAT-command tells also idletime if user is on channel.
   -Fixed some little bugs in several places
   -Added words/publics section (Suggested by Luosto)
   
 V1.1
   -Fixed bug with actions, they go to the logs now.
   -Fixed some little bugs in several places
   -Fixed bug with count_words, no more errormsg with nonexistent users


##########################################################################
## ================== DCC COMMANDS TO HANDLE THE STATS ================ ##
##########################################################################
                      (only masters can use these)
 CLRUSER <handle>
    Sets somebody's all stats to 0 
 SUMUSER <handle1> <handle2>
    Adds handle2's hostmask(s) and stats to handle1 and deletes handle2
 DOSTATS
    Instantly creates the new html-file(s).
 WEED <words>
    Deletes users who have less than <words> words on ALL separate 
    channels except if they have master, op or voice flag.

##########################################################################
## ============================ MSG COMMANDS ========================== ##
##########################################################################
                        (everybody can use these)
 STAT
    Sends a notice to the user and tells his/her statistics
 WHEN <nick> <channel>
    Sends a notice to the user and tells when <nick> was last on channel
 TOPTEN <channel>
    Says top ten talkers on <channel> and their wordcounts.
 PLACE <channel>
    Tells user's place on list and wordcount on <channel>.
##########################################################################
## ========================== PUBLIC COMMANDS ========================= ##
##########################################################################
                        (everybody can use these)
 !STAT [nick]
    Tells user's (or nick's if given) statistics on current channel.
 !WHEN <nick>
    Tells when nick was last on current channel.
 !TOPTEN
    Says top ten talkers and their wordcounts on current channel.
 !PLACE [nick]
    Tells user's (or nick's if given) place on list and wordcount
    on current channel.

 ================ SPECIAL FLAGS USED BY THIS SCRIPT: ===================
 5 = Do not include this user to the html and !topten output. 
     This uses channel specific flag, so it must be set for all channels
    (counting still works so they can use STAT-command)

More documentation on comment lines in the script's settings-section.