Web Page Hit Counters

Adding Counters to Your Web Page

To add a counter to your web page hosted at BAM, simply add this HTML code to your web page:

<IMG SRC="/cgi-bin/counter.cgi?df=username">

The "username" should be the same as your mailbox account name (baxxxx).

That's all you need for a basic installation! If you would like to customize the colour or style of your counter or add other features such as the current date and time into your web pages then please read the section below...

Advanced Configuration

To change the default properties of the counter, simply add a | symbol (the shift-backslash) and the added parameters for all the properties you are changing, for example:

<IMG SRC="/cgi-bin/counter.cgi?df=username|ft=0|pad=N">

As you will see in the chart below, this changes the frame thickness to zero (ft=0), or otherwise removing the frame. It also turned the leading zero padding off. (pad=N)

Another example shown below shows how to add a hidden counter by making its colours transparent. Please note that although the example appears on two lines, that in your code it should be all on one line:

<IMG SRC="/cgi-bin/counter.cgi?df=username|ft=0|dd=E|pad=N|
comma=Y|tr=Y|trgb=FFFFFF|srgb=0;0;0|prgb=255;255;255">

Available Properties and Parameters

Property	Option	Description
Digit style	dd=A	This parameter allows you to change the style of digits used in your counter or clock. For style E it is suggested that you also select to make the digits transparent. You will be able to change the colour of the digits with another option. Style A Style B Style C Style D Style E Click here for a complete list of digit styles available.
Display type	display=counter	A valid string can be specified with display= parameter to display counter, clock or date. The valid values are counter,clock or date however if using counter you can omit this option as it is the default.
Time Format	tformat=12	If you are using the counter program to display the current time, then you can use this to specify between 12 and 24 hour format.
Date Format	dformat= MMDDYY .	If you are using the counter program to display the current date then you can choose the date format using MM, YY and DD. For example you can use DDMMYY, YYMMDD or MMDDYY
Frame Thickness	ft=6	This specifies the frame thickness for your counter. To disable the frame, choose 0 as your value. Frame values over 5 give a 3D impression.
Frame Color	frgb=100;139;216 or frgb=648bd8	Specifies the color of the frame in RGB (red/green/blue) format. Each color component, red, green, and blue is specified as a value between 0 and 256, or if you know the hex format you can use it instead.
Transparency	tr=N	If you wish the counter background to be transparent then you should specify tr=Y instead of the default setting of off. You should also specify what colour should be made transparent using the trgb option, by default if tr is specified without trgb then the colour converted to transparent is black. The trgb parameter follows the same usage as the Frame Color option.
Digits	md=6	This defines the maximum number of digits to display. Any value between 5 and 10 inclusive is permitted.
Padding	pad=Y	You can turn off the leading zero padding by specifying pad=N here, otherwise the counter will be zero padded to the maximum digit length.
Commas	comma=N	If you want to place the appropriate commas in the counter, then you can do so by selecting comma=Y, you must turn off padding with the pad=N option in order for the commas to work.
Change Colours	srgb=R;G;B prgb=R;G;B	This allows you to change the colour of any colour in an image to another colour. The R;G;B settings are used the same as the trbg option. The srgb option is the source colour you wish to change and the prgb value is the colour you want to change it to. For example: srgb=0;255;0|prgb=0;255;255 will change the colour green (0;255;0) to the colour cyan (0;255;255).
Rotate	degrees=0	You can rotate the counter image either 90, 180 or 270 degrees.

Hidden Counters

You can also create a hidden counter by using the following parameter combination:

<IMG SRC="/cgi-bin/counter?df=username|prgb=0;0;0|srgb=255;255;255|dd=e|ft=0|tr=y">

...this will allow you to create a transparent counter for the page that you want to track hits on, then you can use a regular display for the counter on another special page that only you know about to let you view the counter value. If you want your other counter to not increment when you view it, just add incr=0 to your list of parameters.