__ __ .----..-----..-----..-----..-----.| |_ .---.-.| |_ .-----. | _|| -__|| || -__||__ --|| _|| _ || _||__ --| |__| |_____||__|__||_____||_____||____||___._||____||_____| for renegade 05-19.4 generik productions '04 . http://www.generik.ca [= what the hell is renestats? =] simply enough, it's an html statistics generator for renegade bbs. using template files, you can completely customize the look of de stats for your own site. renestats currently supports: . user list . bbs listings . last callers . current node usage . bbs history (total stats and daily usage) [= command line usage =] standard usage: RENESTAT this can be users, bbslist, lastcall, nodelist, history or all. /? will refresh your memory if needed ;) [= configuration =] running RENESTAT config will bring you into the configuration screen: Úú úÄÄÄú ú¿ ú renestats config ú Àú úÄÄÄú úÙ [A] path to RENEGADE.DAT : C:\RG\ [B] output stats files to: C:\WEBS\HTDOCS [C] template path : C:\RG\STATS\TEMPLATE\SINGLE [D] user template prefix : USERS [E] bbslist prefix : BBSLIST [F] last callers prefix : LASTCALL [G] last callers length : 10 [H] nodelist prefix : NODELIST [I] daily stats length : 7 [J] bbs history prefix : HISTORY help: [arrow keys]=move lightbar [enter/hotkey]=select item [esc]=quit menu the options should be mostly self-explainatory ;) the prefix options are what your template files (.HTT and .HTA) are called for each stat (and also what your output file will be called). when you're done editing the config, just hit [esc] to quit and/or save. [= template system =] the templates are relatively straightforward. they're treated as regular html files, with special tags for use with renestats. you've got two files for each stat, the page template (*.HTA) and the list template (*.HTT). the page template normally has only one tag, , which will start cycling through the list template. there's one exception which is the bbs history, it has additional tags you can add. more on this below. we've included 2 seperate default templates for you to try. you will need to select one or the other in renestats configuration (template path) to get started. the first one runs with individual pages for each stats, which is located in TEMPLATE\MULTIPLE. the other includes all stats on one page using either server side includes (SSI) or PHP, depending on which index you use. your web server needs to support at least one of those options for this template to work. for more info, check out README.1ST in the template's folder, which is located at TEMPLATE\SINGLE. *NOTE* due to the nature of html files, these tags are CASE SENSITIVE, so they should all be in lower case. ALSO, although your html files can be of any length, lines can't exceed 255 characters. If you've got some that do, cut em down a bit eh? these be your general tags. they can be used in any page template (.HTA): - the name of your board - your phone number - (hopefully) your name! - total system users - total system callers (currently broken in RG) - total minutes used - total message posts - total number of downloads - total number of uploads - total days the board's been online - when the stats were generated in mm-dd-yyyy keep in mind none of these will work in a list template (.HTT). those are below, and are specific for each stat generated: -user list- - user's alias - user's real name - user's city/state - user's birthdate (mm-dd-yyyy) - user's age in years - day the user was last on - user's gender (M/F) - user's gender (Male/Female) -bbs list- - pretty self explanatory, eh? - bbs sysop - telnet:// url - http:// url for bbs website - good old fasioned phone number - software the board runs - description field #1 - description field #2 -last callers- - which node the user logged onto - user's alias (or real name) - user's city/state - system caller # - caller's baudrate - user's logon time - user's logoff time - will display '*' if it's a new user -current callers (nodelist)- - node number - user's alias (or Empty if node is inactive) - user's city/state - user's age (in years) - user's gender (M/F) - user's gender (Male/Female) - time when user logged on -bbs history- - statistics date - total callers for the day - number of new users today - number of message posts today - total private emails sent today - total sysop feedback sent today - total errors (system malfunctions) today - total uploads today - total downloads today - total uploads today in KB - total downloads today in KB [= outro =] that should just aboot do it. if you're having problems, or want to send a suggestion or death threat, you can find me either on the support board, or via email: BBS: The Resurrection ú telnet://resbbs.ath.cx ú Email: resbbs@generik.ca eventually you'll also be able to check out the website (www.generik.ca) for updates and other BBS stuff. enjoy! doc, generik productions '04 *EoF*