Installation docs for The Ultimate Ad Tracker
##################################################
##    Install (C)1999-00 Wes Blaylock           ##
##################################################
##                                              ##
##                                              ##
##    		Ultimate Ad Tracker             ##
##                                              ##
## 			                        ##
##						##
##				                ##
##						##
##			                        ##
##						##
## All violaters will be prosecuted.		##
##						##
## This program is distributed "as is" and 	##
## without warranty of any kind, either express	##
## or implied.  (Some states do not allow the	##
## limitation or exclusion of liability for 	##
## incidental or consequential damages, so this	##
## notice may not apply to you.)  In no event 	##
## shall the liability of Wes Blaylock for any 	##
## damages, losses and/or causes of action 	##
## exceed the total amount paid by the user for	##
## this software.				##
##						##
##                                              ##
## Usage:                                       ##
##                                              ##
##  require "io.msm";                           ##
##  &error("Error Message Here");               ##
##  &Header("Title","Page Title","Sub-Title");  ##
##  &Footer;                                    ##
##  &postparse;                                 ##
##  &getparse;                                  ##
##                                              ##
##################################################

This script may look difficult to install to you because
it has a lot of files. Well, its not. Most of the files
you will never have to touch. Just take it one step at a
time.

Ok first off, make sure the path to perl is set correct
in the first lines of admin.cgi,io.pl,tracker.cgi, and
variables.pl

Now all you have to do is set some paths in variables.pl
and that is all the editing you need.

Before you do that, create a directory somewhere on your
server that is able to run CGI scripts. Example cgi-bin/track.

Using "track" as an example, create a directory inside that called
"data". Now the path will look like cgi-bin/track/data

Onto the variables.pl file. In the file, there are these 2 lines:

use constant TOP => '/home/www/muchsuccess/cgi-bin/track';
use constant HOME => 'http://www.muchsuccess.com/';

The first one should be the path to the directory you created
to run CGI scripts. In the above example, again we use "track".

The second line should be the URL to your homepage. Or any page
you want for that matter, this line isn't really that important.

The rest does not have to be edited at all unless your going a different
route then these installation instructions. If you are, then you
probably know what to do. Just make sure the paths point to the 
right file/directory.

Now upload all of the files to the directory you created to run CGI
scripts. Chmod all .cgi files to 755 and all .pl to 744.

755 = owner= read,write,execute
      group= read,execute
      other= read,execute

744 = owner= read,write,execute
      group= read
      other= read

Now run the admin.cgi file by typing it into your web browser. You will
be prompted to set a password. This will create the password file. Once
its set, you will only have to enter it once next time you go. To change 
your password, just login to your server and go to the data directory and 
erase the adps.txt file.

Go ahead and create a "test" account to try it out. If the you name the
account "test", then the URL to track it would be
http://www.yourdomain.com/cgi-bin/track/tracker.cgi?test

This will then record the hit, and send you on to the URL you specified
for that account. So again, to track an URL, create an account for it,
then add tracker.cgi?accountname to the end of the directory where all
the files are.

Note - you must send a hit to the account before you can check the "view stats"
button. It has to create a hit file first. So if you just create an account
and then try to view stats, it will give you an error. So send a hit to it
by using the tracker URL for that specific account.

Problem?
The only problem we have found in this script is that on some servers, it
will not create the accts.dat file. If you try to login for the first time
and you get that error, just create the file and throw it in the directory
with all of the .cgi and .pl files. Make sure it is a blank file.

Last thing, in the view stats area of the script, the light blue bars are
the unique hits and the light blue + dark blue combined are the total hits.


Oh, and Congrats!!
You now have detailed statistics about each ad you place.

Happy Tracking :)







