##############################################################################
# Cliff's Counter Version 1.0                                                # 
# Copyright 1998 Shaven Ferret Productions                                   #
# Created 6/12/98                                                            #
# Available at http://www.shavenferret.com/scripts                           #
##############################################################################
# COPYRIGHT NOTICE                                                           #
# Copyright 1998 Shaven Ferret Productions All Rights Reserved.              #
#                                                                            #
# This script can be used\modified free of charge as long as you don't       #
# change this header thing.  By using this script you agree to indemnify     #
# me from any liability that might arise from its use.  In simple English,   #
# if this script somehow makes your computer run amuck and kill the pope,    #
# it's not my fault.                                                         #
#                                                                            #
# Redistributing\selling the code for this program without prior written     #
# consent is expressly forbidden.                                            #
##############################################################################

Hello.  These are the instructions for how to install the counter.
You should have the following files...

        * count.cgi ----- the counter script
        * count.html ---- the log file
        * readme.txt --- the file you're reading now

If you're missing any of these files, you can download them from
http://www.shavenferret.com/scripts/count

First, open the count.cgi file with a text editor.  If perl is not located
at /usr/bin/perl, change the first line to #!(location of perl).  Scroll
down to line 23, and enter the PATH (not the URL) of the count.html file.
Now scroll down to line 27.  If you want the counter to display the number
of hits, leave this line alone.  Otherwise, delete it.  Scroll down to line
31, and enter the minimum number of digits to display.  For example, if you
set this to 7, and the counter is at 42, it will display 0000042.

Next, upload the count.cgi and the count.html files to your server.  chmod
the count.cgi file to 755, and the count.html file to 777.  Congratulations,
you now have a working counter!

Now you'll probably want to add the counter to your site.  To do so, add the
following to the html: <!--#exec cgi="/cgi-bin/count.cgi" --> (assuming that
you've uploaded the count.cgi file to /cgi-bin.  You may also have to rename
whatever files you add the counter to so that their extension is .shtml.
If everything is working, and you left line 27 alone, when you view the page
you should see a number where you put the <!--#exec cgi="/cgi-bin/count.cgi" -->
line.  If you deleted line 27, you shouldn't see anything.  You can now
find the stats for your pages in the count.html file.

******************************************************************************
* Troubleshooting                                                            
******************************************************************************

* When I go to a page using the script it says an error occurred.
        * Make sure you've changed the first line of count.cgi to #! and
          then the path to perl on your system
        * Make sure you've uploaded count.cgi as ascii, not binary.
        * Make sure you've set the permissions for count.cgi to 755.

* I added <!--#exec cgi="/cgi-bin/count.cgi" --> to the page I wanted, but it
  doesn't generate an add.
        * Go to the uploaded page and view the source.  See if the
          <!--#exec cgi="/cgi-bin/count.cgi" --> is still there. 

        * If it is:
                * Try renaming the file from whatever.html to whatever.shtml
                * You may not have SSI.  Ask your system administrator.

        * If it isn't:
                * Make sure that you've added at least one banner.

* The script doesn't count.
        * Make sure that you've entered the correct server path to your
          count.html.  Your server path ends the same way as your URL, but
          begins differently.  If you don't know your server path, ask your
          system administrator.
        * Make sure that you've set count.html's permissions to 777.

******************************************************************************

                        If you still need help, go to
                http://www.shavenferret.com/scripts/help.shtml
