                      WHO'S CALLED TODAY    Version 3.0
                      =================================

                               Copyright 1996
                                 CR Software
                             All Rights Reserved

January 20, 1997


Table of Contents
=================

1.	Introduction.

2.	Setting up Who Called Today - Dial up (ANSI) version.

3.	The Configuration File Options - Dial up (ANSI) version.

4.	Setting up Who Called Today - HTML version.

5.	Using MAIN.WCX - (both versions)

6.	Benefits of Registering!



1.	INTRODUCTION
	============

	WHO'S CALLED TODAY is for WildCat! 5 ONLY!! 
	It WILL NOT run on WildCat! 4.x systems!
	
	WHO'S CALLED TODAY is a wcCODE program that lists the caller's
	to your BBS for the day. The list is reset automatically each
	day.

	You, as sysop, may choose from 1 to 8 different categories to
	be displayed in the ANSI version, as well as the color each category
	is to be displayed in.

	WHO's CALLED TODAY will detect user's who drop carrier, and
	the words "DROPPED CARRIER" will appear in the "From" field in the
	list, and "0" in the 'Time On' field (if chosen).

	With this version, Navigator calls are listed as "Navigator" in the
	"From" field. (See USING MAIN.WCX, section 5, below).

	Also,Sysops, and anyone with sysop status are not listed, since 
	sysops call their own boards so frequently.




2.	SETTING UP WHO'S CALLED TODAY - ANSI Version
	============================================

	WHO'S CALLED TODAY may be set up in two ways. You may choose 
	either, or both ways.


	SETTING UP AS PART OF LOGON SEQUENCE
	====================================

	To have WHO'S CALLED TODAY run as part of your logon sequence,
	you may simply use the "logon.wcx" file provided with this
	package. Or, if you wish to place WHO'S CALLED TODAY in a 
	different location in your logon sequence, modify your 
	"logon.wcc" file, if you have one, and recompile. It currently
	runs after checking for new mail, immediatey prior to the
	Main Menu.

	To run in the logon sequence, WHO'S CALLED TODAY *** REQUIRES ***
        the /G command line parameter, so your line in logon.wcc would look
	like: run ("A1WCT", "/G")


	SETTING UP AS A MENU SELECTION
	==============================

	To set up as a menu selection, set WHO'S CALLED TODAY up as any
	other .wcx program on your menu. 

	Again, you *** MUST *** use the "/G" command line switch.


	

	LOG OFF SEQUENCE
	================

	A subroutine of WHO'S CALLED TODAY is set to run at log off 
	in the enclosed postcall.wcx file. 

	If you wish to alter the postcall file, and you have the 
	wcCODE compiler, place the "run A1WCT" command anywhere in your
	postcall.wcc file. However.... DO NOT USE ANY COMMAND LINE
	SWITCHES!!!
	
	Simply: "run A1WCT". 

	REMEMBER: Only use the "/G" command line switch when the caller
        will be VIEWING the information, NOT AT LOG OFF!!

	Also, the postcall.wcx is fully compatible with CR Software's
	A1 Callback Verifier.


3.	THE CONFIGURATION FILE OPTIONS - ANSI VERSION ONLY
	==================================================

	This is really where WHO'S CALLED TODAY shines! What to dis-
	play, and what colors to use, is entirely up to you!	

	You may have WHO'S CALLED TODAY display any or all of the
	following fields:

	Caller's Name, Where called from, Node they logged on to,
	The time they logged on, Time spent online, Number of files
        uploaded, Number of files downloaded, and Number of messages
	left.

        To choose these, simply modify the whocalld.cfg file as described
        next.

        Note: DO NOT CHANGE THE ORDER OF THE FOLLOWING ENTRIES 
        in whocalld.cfg!
        
        *** The WHOCALLD.CFG file  MUST be placed in your
        WC5\DATA subdirectory. 


        A sample whocalld.cfg file may look like: (it may be upper or lower
        case - either is fine)

        NAME = BRIGHT WHITE     // display this field in bright white
        FROM = BRIGHT BLUE      // display this field in bright blue
        NODE =                  // don't display this field
        TIME ON = CYAN          // display in cyan
        MINUTES =  RED          // display in red
        UPLOADS =               // don't display
        DOWNLOADS =             // same
	MSGS = BRIGHT MAGENTA	// display in bright magenta

	As you can see, by specifying a color after the field, it will
	be displayed in that color. Specifying nothing after the = sign
	means that the field will not be displayed. Simplicity itself!!

	Who's Called Today automatically scales the output to cover an
	80 character wide screen.

	The colors you may use are: Blue, Green, Cyan, Red, Magenta,
	Yellow, and white. To make these "bright", use the word BRIGHT
        before the color!

	Note: Yellow used without the word BRIGHT, actually looks kind of
          brown, or orangey.



4.	SETTING UP WHO CALLED TODAY - HTML VERSION
	==========================================

	This HTML version of Who Called Today will automatically generate
	an HTML file listing the callers to your BBS. It is automatically
	reset each day. It lists the Caller's Name, where they called from, 
	when they logged on, how long they were on, the number of messages 
	written, the number of uploads, and the number of downloads.


                              SPECIAL THANKS:
                              ===============

	Special thanks to Christopher Weis of Vandoran's BBS, in
        Bedford, Texas,(817-858-0965) for the design of the HTML
        pages and gif images used in Who Called Today! You can check
        out the registered version there!



                          Setup of Who Called Today
                          =========================

        The setup of Who Called Today is easy! Please pay careful attention
	to the DIRECTORIES listed in the first 3 steps. Each step uses a
	different directory.

	1) Place the WCTHTML.WCX file, and the POSTCALL.WCX file in your \WC5\
	   directory. Note: The POSTCALL.WCX file is compatible with the 
	   previous version of Who Called Today, AND with versions 1 and 2 of 
           CR Software's A1 Callback Verifier. There is no need to worry about
           overwriting your old POSTCALL.WCX file.

	2) Place the supplied .htm and .gif files in a directory of your choice, 
	   the default being  \WC5\HTTP\PUBLIC\WCT\  for example.  Who Called 
	   Today is set up to use this as a default directory. IF YOU DO NOT USE 
	   THIS DIRECTORY, YOU WILL NEED TO MODIFY 2 OF THE INCLUDED HTML FILES. 
	   (see below)

	3) Create a one line ASCII text file in your \WC5\DATA\ subdirectory,
	   called WCTHTML.DIR, with the location of the directory from step 2.
	   For example, your wcthtml.dir file would simply be the line:
	   C:\WC5\HTTP\PUBLIC\WCT\ <enter>. 

	4) Establish the link on your Web page to the file WCTHTML.HTM, which
           will be created by Who Called Today *** in the directory you spec-
           ified in step  2.***  This is the actual HTML page that will be
           displayed.


	   That's it!


          Modifying the HTML and GIF files used in Who Called Today
          =========================================================

	If you wish to modify the directory used by Who Called Today, or the
	.gif images used in Who Called Today, do the following:

	1) !!! MAKE A BACKUP OF THE FOLLOWING 2 FILES!!!:
	   WCTHTMLA.HTM, WCTHTMLB.HTM

	2) Modify the above 2 files (your copies, not the originals), replacing
	   ALL occurences of the references to the default .gif files listed, 
	   with the directory, and/or gifs you wish to use. DO NOT, I repeat,
	   DO NOT alter, in any way, the line spacing, etc. of these files!
	   Simply change the .gif image and/or the directory references.

        For instance, if you wish to use the \WC5\HTTP\PUBLIC\WCT\IMAGES\ 
        directory, replace all occurences of "/public/wct/redwal.gif" with
        "/public/wct/images/redwal.gif (or the .gif you wish)


	I realize this may be a little confusing and complicated, but I wanted to
	make it as configurable as possible for you.
	

5.      USING THE ENCLOSED MAIN.WCX FILE
        ================================

        If you do not use the enclosed main.wcx file, Navigator callers
        will not be recorded until the next dial-up (ANSI) caller runs
        Who Called Today, either as part of the logon sequence, or by
        a menu command. However, by using the main.wcx file, Navigator
        callers are listed, but by name only. Their time on-line, messages,
        etc. will all say 0. This is because Navigator callers don't run
        postcall.wcx on exit. Main.wcx simply runs a1wct.wcx prior to
        beginning the Navigator session. As such, there is no record of
        their messages, time on-line, etc.

        At present, I realize this is a bit awkward. Some may run other
        programs that require their own main.wcx file, and therefore could
        not substitute the main.wcx file that comes with Who Called Today.

        So the choice is yours. Who Called Today still functions without the
        main.wcx file, but as noted above, Navigator callers aren't logged until
        the next non-Navigator caller.


6.	BENEFITS OF REGISTERING
	=======================

	The most obvious benefit: The caller's real name will appear in 
	the "From" field. In the unregistered version, it will simply
	say "BBS Caller".

	That alone should be worth the huge sum of $6.00 to register this
	program!!

	To register, fill out the form REGISTER.TXT, and mail it in with
        your $6.00 (U.S. Currency only, please) to:

		 	CR Software
			591 Cypress Ave.
			San Jacinto, Ca.
			92583


        Thank you, and enjoy WHO'S CALLED TODAY!

        If you have questions, you may contact me at MSI. Leave a message
        for Chris Ibbeson.

        or at: ibbeson@telis.org


>>END
