TomaWeb - FREE GIF Button Generator

TomaWeb Counter
v e r s i o n 1 . 0

Thank You
for downloading the FREE software from TomaWeb. Make sure you get back to our website from time to time and find out what else you can get for FREE.

Disclaimer
TomaWeb may not be held liable for any damages in any form resulting from the use of this software, tool or utility. You may use it at your own risk. By downloading or using any of the files contained with or on this page, you are agreeing to this statement.

Installation
The only file you need to install on your web server is "twcounter.exe". This file is a WIN-CGI and therefore must be installed and run on a Windows machine running a web server that supports this format. Make sure that it has execute privilages on the web server or when executed, it will think the user wishes to download the file.

Usage
To use the counter, all you need to do is to insert an image tag in your HTML Code with its source pointing to the twcounter.exe on your web server. You can change the look of the counter by adding a few parameters.

For example: ... <img src="http://www.yoursite.com/cgi/twcounter.exe?minchar=6&color=#FFFF00"&countername=home> <img src="http://192.168.0.127/twcounter.exe?minchar=6&color=#FFFF00"&countername=home> ... The previous html code when inserted into your code would render a 6 digit counter, on a yellow background, named home. The counter has many more possible parameters than the previous example shows and all of them have default values. This next section will explain all of the parameters.

Counter Parameters To pass parameters to the counter, simply add a ? after the twcounter.exe in the image source, followed by the parameter name an equal sign and the parameter value. To pass multiple parameters, seperate them with an &. The example above illustrates how.

Parameter Name	Possible Values	Default Value	Usage
countername	Any text string	Default	The countername parameter will be used to differenciate between counters. TWCounter.exe will create a DAT file of the same name on the server, in which it will store that counters current value.
width	Integer > 0	Automatic	If you do not want TWCounter.exe to resize your counter image automatically according to the width of the text, you may fix a size with this parameter.
height	Integer > 0	Automatic	If you do not want TWCounter.exe to resize your counter image automatically according to the height of the text, you may fix a size with this parameter.
minchar	Integer > 0	Automatic	If you want to have a minimum string of characters to be displayed, set this value and TWCounter.exe will pad the front of the strng with the appropriate number of zeros.
color	HEX-RGB color	DCDCDC	Set this value to change the color of the counter's background.
hasborder	0 or 1	0	Set this value to 1 if you wish to ahve a 1 pixel border around your counter.
fontname	Any font installed on the server where TWCounter.exe is installed.	Arial	Set this value to changet the font used by the counter.
fontcolor	HEX-RGB color	000000	Set this value if you want to change the color of the counter characters.
fontsize	Integer > 0	10	Set this value to change the size of the text that makes up the counter image.
isbold	0 or 1	0	Set this value to make the text appear bolded.
isitalic	0 or 1	0	Set this value to make the text appear italicized.
isunderlined	0 or 1	0	Set this value to make the text appear underlined.
stats	pie	None	Instead of returning a counter gif, TWCounter.exe will return a GIF displaying the number of impressions and a pie chart showing the percentages of all counters.
month	1 to 12	Current Month	This value is only used in combination with the stats parameter.
year	Integer > 0	Current Year	This value is only used in combination with the stats parameter.

Getting the Counter Values
The TomaWeb Counter will generate DAT files in the folder in which it is installed. On file for each distinct countername used. The first line of those files contains the counter's current value. The second contains the year and month. On the first hit after the turn of a month, the counter will create a backup copy of this file. You may use these files to generate stats when and where the page impressions were made.