WWW Counter Configuration


Minimum required to display the Counter

Put a line like this in your HTML document:

<img src="/cgi-bin/counter?df=sample.dat">

Use the counter data file name given to you instead of sample.dat.

Options to the Counter

All options to the counter must be in the form:

<img src="/cgi-bin/counter?options&options&df=sample.dat">

Use the file name given to you instead of sample.dat.

Each of the options specified must be separated with an amperstand, &.
The options can be any or all of the following table.

Example:

Suppose you wanted to use digit style "77" with a red border (frame) around your digit display, needed a maximum of 5 digits (this will accomodate 99999 acesses), and were told your counter file had been set up with the name sgtc.dat. The following img line inserted wherever you want your counter to appear in your page will do the trick!

<img src="/cgi-bin/counter?ft=5|frgb=255;0;0|md=5|dd=77|df=sgtc.dat">

Options for Your Web Page Counter

optionNameDescriptionExamples Default
ft=X Frame Thickness You can wrap the counter in an ornamental frame of X pixels thick. Use 0 for no frame. Values over 5 make a nice 3-D effect.
ft=7
ft=0
No frame
frgb=R;G;B Frame Color Specifies the color of the frame in RGB (red/green/blue) format. Each color component, R, G, and B is specified as a value between 0 and 255. If you use ft=# without a frgb= option, the default color is used.

If you specify a frgb= without a ft=#, then the frame thickness defaults to 5. All the examples show ft=5.

Refer to the rgb.txt for various color values.


frgb=69;139;50

frgb=255;0;0

Default
frgb=100;139;216
Cyan
tr=B Transparency On/Off You can specify if your counter image will have a transparent color with the Boolean B. So tr=Y means there will be a transparent color; and tr=N means there will not. It does not matter if the GIF files used for the digits are "transparent"; as is shown next, you must specify explicitly which color to make transparent.

If you specify a trgb=, then you do not need to specify tr=Y.

Valid values for B are Y, N, T, F, 1, or 0.


tr=N

tr=Y
tr=N
No transparency
trgb=R;G;B Transparent Color Here you specify the color to render as transparent, given in red/green/blue format.

When you provide a trgb=, you can skip the tr=Y; it is automatically turned on for you.

For additional info regarding RGB (red/green/blue) format, refer to the rgb.txt.


trgb=0;255;0
(green)

trgb=0;0;0
(black)
frgb=0;0;0
Black
md=X Max Digits Defines maximum number of digits to display. Any value between 5 and 10 inclusive are permitted. Padding with leading zeros is automatically done for you; longer counts are truncated to the given X.
md=5

md=5
Truncation of 9 digit value
md=10
Without padding
pad=B No Padding Turn padding on/off in conjunction with md= setting.

Valid values for the Boolean option B are Y, N, T, F, 1, or 0.

(There are some bugs in the padding feature, as shown in the examples. These will be fixed shortly.)


pad=Y
With default md=10

md=5&pad=N
No padding value shorter than max 5.

md=5&pad=N
Truncation of 9 digit value without padding.
pad=N
Without specification of a md= value


pad=Y
With specification of a md= value

dd=A Digits Dir Denotes what style digits will be used. The examples show all those currently installed.
dd=A

dd=B

dd=C

dd=D

dd=E

dd=F

dd=G

dd=24

dd=43

dd=66

dd=77

dd=57chevy

dd=86

dd=colors

dd=fatpt

dd=katt009

dd=katt154

dd=redbtn

dd=square
dd=A
st=X Start count Used to set the initial value of the counter to some number X. This is only valid if you are allowed to create a new counter file. (This space intentionally left blank.) st=1
Count starts at one
sh=B Show digits Used to turn display of digits on or off according to the Boolean B. When sh=T, digits are shown as in most of the examples given here. If sh=F no digits will show, but the counter will still increment; instead of digits a transparent 1x1 GIF is displayed.

Valid values for the Boolean option B are Y, N, T, F, 1, or 0.


An invisible counter is above!
sh=Y
Display digits
df=file Data File for counting Specifies the name of the file for storing the count in. The file must be allocated to you as was mentioned in the "Authorizations" section above. You can use df=sample.dat for testing and so on, but of course the value in it is not reliable.

One special use of the option is df=RANDOM. This returns a random number using the fractional portion of the host's time of day clock as a seed for the generator.

Unlike all other WWWcounter options, the file name provided is case-sensitive, except for the value random. Or Random, or rANDOM, etc.


A random number
df=RANDOM
Roll of the dice!
incr=B Increment count Makes it possible to display the current count without incrementing the count. This can be used to examine the count for reporting or other purposes without adding to the count.

Valid values for the Boolean option B are Y, N, T, F, 1, or 0.


incr=F&df=sample.dat

incr=F&df=sample.dat
The count does not go up, unless due to someone else accessing the counter at the same time as you are.
incr=T
Increment count on each invocation.
lit=X Display literal Makes it possible to display a given, predetermined value.

Valid values for the string X are digit.


lit=1000001
Almost all the examples on this page are made with lit=X
None


HOME | SEARCH | E-MAIL | CATALOG | SCHEDULE | LIBRARY | HELP

webhelper@csuchico.edu