NAME cgicount - stores an incremented number in an owner's directory and returns
an 'odometer' image of the number to a client's browser. SYNOPSIS
<IMG SRC='/cgi-bin/cgicount?<filename>[+[options]]'>
where <filename> is a counter name composed of any alphanumeric,
- (hyphen), or . (period) characters, and where 'options' includes any
order of the characters [+]. Brackets [] are used in this document to
denote optional values and are not used in the actual syntax. AVAILABILITY
http://www.eiu.edu • http://www.ux1.eiu.edu • http://www.research.eiu.edu
DESCRIPTION The script will create a counter file in the same directory as the HTML
file that requests the script. An incremented number is stored in this
counter file each time the HTML page (the script) is accessed. The script
then returns an 'odometer' image of the count as an XBM-format graphic.
The count displayed is actually the number of clients that have accessed
the page and not the number of times the page has displayed. The file
containing the count must be in the same directory as the web page that
requests it. You can edit the file to change the count, or you can delete
or rename the file to reset the count to zero. OPTIONS Any combination of options is prefixed by a single '+' and includes any
order of the following case-sensitive letters.
|
++ |
Display the current documentation and disable
all other actions of the script. |
USAGE Adding a a counter in your HTML page requires the same procedure that
you use to insert an image. To create a counter file called record.count
in your web directory you will need to enter the following source address
for the image.
<IMG SRC='/cgi-bin/cgicount?record'>
With this type <IMG SRC=...> tag, your web page will
display the following 'odometer' graphic of the current number in the
record.count file.
FILES A counter file will be created with a name of '<filename>.count'
in the same directory as the HTML page that presents the counter image.
The <filename> is the same filename used in the SRC part of the
image tag. SEE ALSO CGI Suite (Collection of General Purpose Scripts) DIAGNOSTICS cgicount was developed to handle all types of user-, owner-, and server-related
errors. The script will send back to the client an 'odometer' image of
 for
all errors that are detected. WARNINGS Permissions (600) to the counter file are only read/write accessible
by the owner of the account. NOTES cgicount has been tested without problem on Windows NT Workstations with
Netscape Communicator 4.x and Microsoft Internet Explorer 3.x web browsers.
Older versions of these and other browsers that do not support JavaScript
and Cascading Style Sheets will not display the response messages and
documentation as fully designed. This browser limitation, however, has
no effect on the function of the script. BUGS There are no known bugs in the current version. AUTHOR Gerald Charles Wagner and Sebastien Flacher. Version 2.0 (Release February
1999). |
