|
Counter
An Overview
The
System Counter is a system counter, that you can use it to
measure the hits in your pages.
The counter use the counter.exe
script in the cgi-sys system directory.
The format using the script is
http://cgi.hostingkey.com/cgi-sys/counter.exe?link=mydomain.com/page.html&style=led
and the HTML code is
<img src="http://cgi.hostingkey.com/cgi-sys/counter.exe?
link=mydomain.com/page.html&style=led">
link=Your
page URL
style=The Style
Name
Table Of Contents
A main feature of this counter is the ability to use many different styles
of digits.
|
Style
Name
|
Example
|
|
led
|
|
|
blue
|
         
|
|
green
|
         
|
|
grey
|
         
|
|
odometer
|
|
|
lcd
|
|
|
speckled
|
|
|
noisy
|
|
|
cyan
|
|
|
eggs
|
|
|
halloween
|
|
|
curly
|
|
|
timex
|
|
|
red
|
|
|
orange
|
|
|
chalk
|
|
|
scoreboard
|
|
|
neat
|
|
|
beach
|
|
|
electric
|
|
|
fancy
|
|
|
frozen
|
|
|
handwriting
|
|
|
oldstyle
|
|
|
sf
|
|
Usage Instructions
Now has come the time to use the counter in your HTML files. The
counter is called like this in your HTML:
<img src="http://cgi.hostingkey.com/cgi-sys/counter.exe?
arg1=value1&arg2=value2&...&argn=valuen">
where the arguments are:
|
Argument
(* means required)
|
Possible Values
|
Meaning
|
|
link*
|
anything that doesn't contain a
space
|
Uniquely
identifies the page calling the counter. This is
case-sensitive. See examples below.
|
|
width
|
0,1,2,3,4,5,6,7,8 or 9
|
The width of
the resulting image in digits. Extra zeros will be added to
the beginning. If the width is too short for the number to be
displayed, it is lengthened so that all digits may be
displayed. Default is 4.
|
|
style*
|
any directory name under the /digits
directory, for example, led, or the reserved value simple.
Should not contain spaces
|
Specifies the
set of digits to use in constructing the final image, or
specifes the use of the simple style 1.
Should be all lower-case
|
|
ord
|
yes or no
(must be lowercase).
|
If ord=yes,
an ordinal number will be outputted 2.
An ordinal number is a number like 345th, 10871st, 22nd, etc.
The default is no
|
|
bgcolour
|
RRGGBB or trans
|
When using the simple
style, specifies the background color of the image, or if trans
is used, specifies a transparent background. RRGGBB should be
3 2-digit hex values in one string, similar to the HTML
command
This argument
has no meaning when style does not equal simple. The
default is 000000 (black).
|
|
fgcolour
|
RRGGBB
|
When using the simple
style, specifies the foreground colour of the image. Same
format as bgcolour. The default is FFFFFF
(white).
|
|
inc
|
0, 1, 2, 3, 4, or 5
|
Determines how
much to increment the counter. Using 0 means the counter will
not increment. Using a value less than 0 will result in no
increment. Using a value greater than 5 will result in an
increment of 5.
|
Notes:
1The simple style looks like this: 
This style requires less disk I/O and thus (should) execute more
quickly.
2To use ordinal numbers, you need to
have GIFs called th.gif, st.gif, nd.gif and
rd.gif in your /digits/X/ directory, where X is the
style name. Only the LED style comes with these extra GIFs: you will
have to create some for the other styles. If you use the simple style,
you can always use ordinal numbers if you wish.
Examples
Here are some examples of using the counter.
<img src="http://cgi.hostingkey.com/cgi-sys/counter.exe?
link=mydomain.com/myhomepage.html&style=led">
<img src="http://cgi.hostingkey.com/cgi-sys/counter.exe?
link=mydomain.com/page2&style=odometer&width=7">
<img src="http://cgi.hostingkey.com/cgi-sys/counter.exe?
link=mydomain.com/page3&style=simple&bgcolour=00FFFF&fgcolour=FF0000">
<img src="http://cgi.hostingkey.com/cgi-sys/counter.exe?
link=mydomain.com/page4&style=led&width=0&ord=yes">
<img src="http://cgi.hostingkey.com/cgi-sys/counter.exe?
link=mydomain.com/anotherpage&style=simple&fgcolour=00FF88&ord=yes">
FAQ
How can I keep track of hits without having a visible
counter?
A: Not sure why people want to do this, but anyway:
In your <img src="...">, put height=1
width=1.
How can I get my web page to load faster when I'm using a
counter?
A: You should specify the height and width of the image. Each digit
in these style are 15x20, so width = 15*(# of digits displayed) and
height = 20. Now put this in your HTML: <img height=20 width=X
src="http://cgi.hostingkey.com/cgi-sys/...">
I'm using the simple style, but I can't change the
background/foreground color?
A: 1) Did you spell bgcolour and fgcolour correctly? (Americans
note the U).
2) If it uses the default colour (black for background, white for
foreground) then you didn't specify 3 two-digit hex numbers. Remember
that it goes RRGGBB (Red, Green, Blue).
How accurate is the counter?
The counter increments every time it is loaded. It is not loaded
when:
-
People with non-graphical browsers see your page.
-
People are not auto loading images
-
People hit "Stop" before it gets loaded.
-
People look at your page with certain browsers that do not like
.exe files in img tags.
-
Someone on the [No-Increment-For] list looks at the page.
|
