[packages/apache1-mod_ometer.git] / counter.html



<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE html 
     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
     "DTD/xhtml1-transitional.dtd">

<html lang="en-US">
<head>
    <title>umweb: counter</title>

    <style type="text/css">
    <!-- 
a:link {
    color: #000066;
}
a:visited {
    color: #cc0000;
}
a:active {
    color: #cccc33;
    text-decoration: underline;
}
a:hover {
    color: #000000;
    background: #ffee00;
    text-decoration: underline;
}

a.titleImg:hover {
	background: #333366;
}
a.downloadImg:hover {
	background: #cccccc;
}

blockquote {
    font-family: arial, helvetica, sans-serif; 
    margin-top: 6pt; 
    margin-bottom: 6pt; 
}

body {
    margin-top: 0pt; 
    margin-bottom: 0pt; 
    margin-left: 0pt; 
    margin-right: 0pt; 
    background-color: #ffffff;
}

body.home {
    margin-top: 0pt; 
    margin-bottom: 0pt; 
    margin-left: 0pt; 
    margin-right: 0pt; 
    background-image: url( "images/blue-stripes.gif" );
}

div.tt, span.tt {
    margin-top: 0pt; 
    font-family: courier, courier new, monospace;
}

h1, h2, h3, h4 { 
    margin-top: 5pt; 
    margin-bottom: 5pt;
    font-family: arial, helvetica, sans-serif; 
}

h4 { 
    font-size: 0.95em; 
    font-weight: bold;
}

li { 
    margin-bottom: 4pt; 
    margin-top: 0pt; 
    font-family: arial, helvetica, sans-serif; 
    font-size: .9em;
}

p { 
    margin-top: 0pt; 
    font-family: arial, helvetica, sans-serif; 
    font-size: .9em;
}

p.cell {
    margin-bottom: 0pt;
}

p.footer {
    font-size: .75em;
    color: #333333;
    margin-top: 15pt;
    margin-right: 100pt;
}

p.footer-home {
    font-size: .75em;
    color: #cccccc;
    margin-top: 15pt;
    margin-right: 100pt;
}

p.hedr {
    font-weight: bold;
    color: #000066;
    font-size: 1.1em;
    margin-bottom: 3pt;
}

p.hedr-home {
    text-align: center;
    font-weight: bold;
    color: #000066;
    margin-bottom: 0pt;
}

p.label, span.label {
    font-family: arial, helvetica, sans-serif; 
    font-weight: bold;
    color: #000066;
    font-size: .8em;
    margin-bottom: 3pt;
}

p.margins, pre.margins { 
    margin-top: 4pt; 
    margin-right: 10pt; 
    margin-left: 10pt; 
    margin-bottom: 4pt; 
}

p.menu { 
    color: #000000;
    font-family: verdana, arial, helvetica, sans-serif;
    font-size: 0.8em;
    line-height: 1.5em;      
    margin-top: 0pt;
    margin-bottom: 3pt;
}

p.small { 
    margin-left: 12pt;
    font-size: .8em;
}

p.submenu { 
    color: #000000;
    font-family: verdana, arial, helvetica, sans-serif;
    font-size: 0.7em;
    line-height: 1.4em;      
    margin-left: 18pt;
    margin-top: -3pt;
    margin-bottom: 4pt;
}

pre,tt { 
    margin-top: 4pt; 
    margin-bottom: 4pt; 
    font-family: courier, courier new, monospace;
    font-size: 0.9em; 
}

span.err {
    color: #990000;
    font-weight: bold;
}

table.flume { 
	border: 1px solid black;
	width: 100%;
}

td.flume, th.flume { 
	font-family: arial, helvetica, sans-serif; 
	background-color: #bbcbff;
}

th.flume {
	color: #000066;
	font-weight: bold;
	font-size: 1.1em;
	text-align: left;
	margin-bottom: 3pt;
	width: 33%;
}

 -->
    </style>

    
</head>

<body

    >


<!-- ITCS header -->
<table width="100%" border="0" cellpadding="0" cellspacing="0">
    <tr>
	<td align="left" bgcolor="#333366">
	    <a href="http://www.itd.umich.edu/" class="titleImg"><img src="http://www.itd.umich.edu/images/itcs-banner.gif" width="455" height="20" border="0" alt="information technology central services at the university of michigan" /></a>
	</td>

	<td align="right" bgcolor="#333366">
	    <img src="http://www.itd.umich.edu/date/Thursday.gif" alt="Thursday" /><img src="http://www.itd.umich.edu/date/April.gif" alt="April" /><img src="http://www.itd.umich.edu/date/24.gif" alt="24" /><img src="http://www.itd.umich.edu/date/2003.gif" alt="2003" />
	</td>
    </tr>
</table>
<!-- end ITCS header -->

<table width="100%" border="0" cellpadding="3" cellspacing="0">
    <tr>
	<td bgcolor="#000066"
	    background="../../images/blue-stripes.gif"
	    valign="bottom"><img
		src="../../images/umweb-small.gif"
		width="350" height="71" alt="um web services"
		border="0" class="logo" />
	</td>
    </tr>
</table>


<table width="100%" border="0" cellspacing="3">
    <tr>
    <!-- Menu column -->
    <td width="125" align="center" valign="top">
        <table width="125" cellpadding="1" border="0">
        <tr>
            <td bgcolor="#000000" width="125">
            <table width="125" cellspacing="0" cellpadding="3" border="0">
<tr>
    <td width="125" bgcolor="#dddddd" align="left">
	
	    <p class="menu">
	    
		<a href="../..">home</a><br />
	    

		<a href="../../faq/">FAQ</a><br />
	    

		&rarr;
	    
	    
		<a href="../../how-to/">how-to</a><br />
	    

		</p>
		<p class="submenu">

    
    <a href="../../how-to/homepage.html">homepage</a> <br />
    

    &rarr; <a href="../../how-to/cgi-scripts/">cgi scripts</a> <br />
    

    <a href="../../how-to/weblogin.html">weblogin</a> <br />
    

    <a href="../../how-to/sql.html">SQL</a> <br />
    
</p>

		<p class="menu">
	    

		<a href="../../services/">services</a><br />
	    

		<a href="../../software/">software</a><br />
	    

	    <!-- commented out until it is ready: clunis 8/13
	    

		<a href="../../statistics/">statistics</a><br />
	    
	    -->

	    
		<a href="../../team/">team</a><br />
	    

		<a href="../../contact/">contact</a> <br />
	    
	    </p>
	
    </td>
</tr>
</table>


            </td>
        </tr>
        </table>
    </td>

    <!-- left inner margin -->
    <td width="5">
        <img src="../../images/trans.gif"
            width="5" alt="" />
    </td>

    <!-- main body column -->
    <td width="600" valign="top">
        <!-- ====== header and breadcrumbs ==== -->
        
        <table cellpadding="0" cellspacing="8" border="0" width="90%">
            <tr>
            
                <td>
                    <h2>
                        counter
                    </h2>
                </td>
            

            <td align="right">
                <!-- ======
                    this is formatted tight to avoid whitespace and wrapping
                    ====== -->
                <p>
                <a href="../..">home</a>&nbsp;/&nbsp;<a href="../../how-to/">how-to</a>&nbsp;/&nbsp;<a href="../../how-to/cgi-scripts/">cgi-scripts</a>&nbsp;/&nbsp;<b>counter</b>
                </p>
            </td>
            </tr>
        </table>
        

<table cellpadding="6" cellspacing="4" border="0" width="90%">

<tr>
    <td bgcolor="#dddddd">
        <p class="hedr">Counter - an approximate count of hits on your page</p>
    </td>
</tr>

<tr>
    <td>
        <p class="margins">
        <a href = "./counter-faq.html">Counter</a> allows
        you to display an image representing an access counter on a
        given page. To put a counter on a page, include a tag
        like:
        </p>

<pre class="margin">
&lt;img src="http://cgi.www.umich.edu/counter?link=
http://www.umich.edu/~umweb/index.html"&gt;</pre>

        <p class="margins">
        <b>Note:</b> This line must appear in your html
        document on only one line.  If you copy and paste any
        of the counter examples from this page to your own
        document, be sure to edit the file and remove any line
        breaks in the counter link.
        </p>
    </td>
</tr>

<tr>
    <td bgcolor="#dddddd">
        <p class="hedr">Counter options</p>
    </td>
</tr>

<tr>
    <td>
        <p class="margins">
        The <b>link=</b> argument specifies the URL to be counted. It is
        required. Additional arguments must be separated from each other by
        ampersands (&amp;)
        </p>

        <p class="margins">
        The <b>ignore=</b> argument specifies IP
        addresses (141.211.164.2) or domain names
        (terminator.cc.umich.edu) that are forbidden from
        incrementing the counter.
        </p>

        <p class="margins">
        The <b>font=</b> argument specifies a font to use instead of
        the counter's default.  If you have a freely available
        truetype font that you would like to see added to this
        list please submit download information, author's name,
        and contact information to webmaster.  We will not be
        able to add every font that is submitted.
        </p>

        <p class="margins">
        The <b>width=</b> argument specifies how many digits are
        displayed &amp; has a maximum of ten. If you specify a
        width that is too small for the number being displayed,
        the counter will use only as many digits as it needs.
        If you specify too large a width, the counter will pad
        the number being displayed with zeros.
        </p>

        <p class="margins">
        The <b>rand=</b> argument will cause the counter to display a
        different random number everytime your page loads.
        </p>

        <p class="margins">
        The <b>reset=</b> argument allows you to reset the counter to
        a specific value.
        </p>

        <p class="margins">
        The <b>text=</b> argument allows you to set the font color
        using the "web color" scheme. For instance, to get a
        counter with black text, set "text=000000". Note that "#"
        is interpreted as an anchor by the browser, and as such
        must be ommitted. "text=#000000" will not behave as you
        expect.</p>

        <p class="margins">
        The <b>bgcolor=</b> argument allows you to set the background
        color using the "web color" scheme. For instance, to get
        a counter with a white background, set "bgcolor=ffffff".
        Note that "#" is interpreted as an anchor by the browser,
        and as such must be ommitted. "bgcolor=#ffffff" will not
        behave as you expect.</p>

        <p class="margins">
        The <b>point=</b> argument allows you to set the point size
        of the counter.  Note this will only work in conjunction
        with the font= argument, as the default font cannot be
        sized.</p>

        <p class="margins">
        The <b>image=</b> argument allows you to make the counter
        generate PNG images rather than the default image format,
        JPEG.  JPEG has been chosen as the default image format
        because, being rendered internally by most browsers, JPEG
        images appear to load more quickly and match the other
        colors presented by the browser better than PNG files.
        However, the image quality of JPEGs is lower than that of
        PNG.  PNG appears to be slower on some browsers ( those
        that use a helper application to render the images may
        appear to "hang" for a moment when loading the counter
        image ) but the quality is superb.
        </p>

    </td>
</tr>

<tr>
    <td bgcolor="#dddddd">
        <p class="hedr">Counter options</p>
    </td>
</tr>

<tr>
    <td>

        <p class="margins">
        There is only one required argument in the counter: 
        <b>link=<i>URL</i></b>.  There are other, optional
        arguments, each of which needs to be separated by &amp;
        signs. All of the applicable arguments are listed below:
        </p>

        <table border="0" cellpadding="1" cellspacing="1">
        <tr>
            <th>Example</th>
            <th>default</th>
            <th>Example Image</th>
            <th>Description</th>
        </tr>

        <tr>
            <td>link=http://www.umich.edu</td>
            <td>none</td>
            <td><img src="http://cgi.www.umich.edu/counter?link=http://www.umich.edu" alt="" /></td>
            <td>The URL of the page using the counter.</td>
        </tr>

        <tr>
            <td>rand=true</td>
            <td>rand=false</td>
            <td><img src="http://cgi.www.umich.edu/counter?rand=true" alt="" /></td>
            <td>Whether or not to display a random number.</td>
        </tr>

        <tr>
            <td valign="top">font=gd</td>
            <td rowspan="16" valign="top">gd is the default font</td>
            <td><img src="http://cgi.www.umich.edu/counter?link=http://www.umich.edu/counter.html" alt="" /></td>
            <td rowspan="16">The digit style of the counter.</td>
        </tr>

        <tr>
            <td>font=transit</td>
            <td><img src="http://cgi.www.umich.edu/counter?rand=true&font=transit" alt="" /></td>
        </tr>

        <tr>
            <td>font=stylus</td>
            <td><img src="http://cgi.www.umich.edu/counter?rand=true&font=stylus" alt="" /></td>
        </tr>

        <tr>
            <td>font=steamer</td>
            <td><img src="http://cgi.www.umich.edu/counter?rand=true&font=steamer" alt="" /></td>
        </tr>

        <tr>
            <td>font=buff</td>
            <td><img src="http://cgi.www.umich.edu/counter?rand=true&font=buff" alt="" /></td>
        </tr>

        <tr>
            <td>font=zoinkfat</td>
            <td><img src="http://cgi.www.umich.edu/counter?rand=true&font=zoinkfat" alt="" /></td>
        </tr>

        <tr>
            <td>font=simpson</td>
            <td><img src="http://cgi.www.umich.edu/counter?rand=true&font=simpson" alt="" /></td>
        </tr>

        <tr>
            <td>font=adlibn</td>
            <td><img src="http://cgi.www.umich.edu/counter?rand=true&font=adlibn" alt="" /></td>
        </tr>

        <tr>
            <td>font=signboard</td>
            <td><img src="http://cgi.www.umich.edu/counter?rand=true&font=signboard" alt="" /></td>
        </tr>

        <tr>
            <td>font=arial</td>
            <td><img src="http://cgi.www.umich.edu/counter?rand=true&font=arial" alt="" /></td>
        </tr>

        <tr>
            <td>font=comic</td> 
            <td><img src="http://cgi.www.umich.edu/counter?rand=true&font=comic" alt="" /></td>
        </tr>

        <tr>
            <td>font=courier</td> 
            <td><img src="http://cgi.www.umich.edu/counter?rand=true&font=courier" alt="" /></td>
        </tr>

        <tr>
            <td>font=impact</td> 
            <td><img src="http://cgi.www.umich.edu/counter?rand=true&font=impact" alt="" /></td>
        </tr>

        <tr>
            <td>font=trebuchet</td> 
            <td><img src="http://cgi.www.umich.edu/counter?rand=true&font=trebuchet" alt="" /></td>
        </tr>

        <tr>
            <td>font=verdana</td> 
            <td><img src="http://cgi.www.umich.edu/counter?rand=true&font=verdana" alt="" /></td>
        </tr>

        <tr>
            <td>font=lumos</td> 
            <td><img src="http://cgi.www.umich.edu/counter?rand=true&font=lumos" alt="" /></td>
        </tr>

        <tr>
            <td>width=9</td>
            <td>width=0</td>
            <td><img src="http://cgi.www.umich.edu/counter?rand=true&width=9" alt="" /></td>
            <td>
                This setting determines how many digits are
                displayed &amp; has a maximum of ten.
            </td>
        </tr>

        <tr>
            <td>reset=1202</td>
            <td>none</td>
            <td><img src="http://cgi.www.umich.edu/counter?link=http://www.umich.edu/counter.html&reset=1202" alt="" /></td>
            <td>Used to reset the counter to a specific, non-negative value.  </td>
        </tr>

        <tr>
            <td>text=9933ff</td>
            <td>text=ffffff</td>
            <td><img src="http://cgi.www.umich.edu/counter?rand=true&text=9933ff" alt="" /></td>
            <td>Used to set the font color of the counter.</td>
        </tr>

        <tr>
            <td>bgcolor=ffffff</td>
            <td>bgcolor=000000</td>
            <td><img src="http://cgi.www.umich.edu/counter?rand=true&bgcolor=ffffff&text=000000" alt="" /></td>
            <td>Used to set the background color of the counter.</td>
        </tr>

        <tr>
            <td>point=36</td>
            <td>point=20</td>
            <td><img src="http://cgi.www.umich.edu/counter?rand=true&font=comic&point=36" alt="" /></td>
            <td>Used to set the point size of the counter font.</td>
        </tr>

        <tr>
            <td>image=png</td>
            <td>image=jpeg</td>
            <td><img src="http://cgi.www.umich.edu/counter?rand=true&font=comic&image=png" alt="" /></td>
            <td>Used to set the output format of the counter image.  </td>
        </tr>
        </table>

    </td>
    </tr>
</table>


    </td>

    <!-- right outer margin -->
    <td width="20">
        <img src="../../images/trans.gif"
            width="20" alt="" />
    </td>
    </tr>
</table>


    <p class="footer" align="right">


    Copyright &copy; 2001 - 2003
    Regents of the University of Michigan <br />

    
    Page last updated:
    Tuesday, 15 April 2003 <br />
    </p>

</body>
</html>
Commit	Line	Data
315a3c98 TO	1
	2
	3
	4
	5	<?xml version="1.0" encoding="iso-8859-1"?>
	6	<!DOCTYPE html
	7	PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
	8	"DTD/xhtml1-transitional.dtd">
	9
	10	<html lang="en-US">
	11	<head>
	12	<title>umweb: counter</title>
	13
	14	<style type="text/css">
	15	<!--
	16	a:link {
	17	color: #000066;
	18	}
	19	a:visited {
	20	color: #cc0000;
	21	}
	22	a:active {
	23	color: #cccc33;
	24	text-decoration: underline;
	25	}
	26	a:hover {
	27	color: #000000;
	28	background: #ffee00;
	29	text-decoration: underline;
	30	}
	31
	32	a.titleImg:hover {
	33	background: #333366;
	34	}
	35	a.downloadImg:hover {
	36	background: #cccccc;
	37	}
	38
	39	blockquote {
	40	font-family: arial, helvetica, sans-serif;
	41	margin-top: 6pt;
	42	margin-bottom: 6pt;
	43	}
	44
	45	body {
	46	margin-top: 0pt;
	47	margin-bottom: 0pt;
	48	margin-left: 0pt;
	49	margin-right: 0pt;
	50	background-color: #ffffff;
	51	}
	52
	53	body.home {
	54	margin-top: 0pt;
	55	margin-bottom: 0pt;
	56	margin-left: 0pt;
	57	margin-right: 0pt;
	58	background-image: url( "images/blue-stripes.gif" );
	59	}
	60
	61	div.tt, span.tt {
	62	margin-top: 0pt;
	63	font-family: courier, courier new, monospace;
	64	}
65
66	h1, h2, h3, h4 {
67	margin-top: 5pt;
68	margin-bottom: 5pt;
69	font-family: arial, helvetica, sans-serif;
70	}
71
72	h4 {
73	font-size: 0.95em;
74	font-weight: bold;
75	}
76
77	li {
78	margin-bottom: 4pt;
79	margin-top: 0pt;
80	font-family: arial, helvetica, sans-serif;
81	font-size: .9em;
82	}
83
84	p {
85	margin-top: 0pt;
86	font-family: arial, helvetica, sans-serif;
87	font-size: .9em;
88	}
89
90	p.cell {
91	margin-bottom: 0pt;
92	}
93
94	p.footer {
95	font-size: .75em;
96	color: #333333;
97	margin-top: 15pt;
98	margin-right: 100pt;
99	}
100
101	p.footer-home {
102	font-size: .75em;
103	color: #cccccc;
104	margin-top: 15pt;
105	margin-right: 100pt;
106	}
107
108	p.hedr {
109	font-weight: bold;
110	color: #000066;
111	font-size: 1.1em;
112	margin-bottom: 3pt;
113	}
114
115	p.hedr-home {
116	text-align: center;
117	font-weight: bold;
118	color: #000066;
119	margin-bottom: 0pt;
120	}
121
122	p.label, span.label {
123	font-family: arial, helvetica, sans-serif;
124	font-weight: bold;
125	color: #000066;
126	font-size: .8em;
127	margin-bottom: 3pt;
128	}
129
130	p.margins, pre.margins {
131	margin-top: 4pt;
132	margin-right: 10pt;
133	margin-left: 10pt;
134	margin-bottom: 4pt;
135	}
136
137	p.menu {
138	color: #000000;
139	font-family: verdana, arial, helvetica, sans-serif;
140	font-size: 0.8em;
141	line-height: 1.5em;
142	margin-top: 0pt;
143	margin-bottom: 3pt;
144	}
145
146	p.small {
147	margin-left: 12pt;
148	font-size: .8em;
149	}
150
151	p.submenu {
152	color: #000000;
153	font-family: verdana, arial, helvetica, sans-serif;
154	font-size: 0.7em;
155	line-height: 1.4em;
156	margin-left: 18pt;
157	margin-top: -3pt;
158	margin-bottom: 4pt;
159	}
160
161	pre,tt {
162	margin-top: 4pt;
163	margin-bottom: 4pt;
164	font-family: courier, courier new, monospace;
165	font-size: 0.9em;
166	}
167
168	span.err {
169	color: #990000;
170	font-weight: bold;
171	}
172
173	table.flume {
174	border: 1px solid black;
175	width: 100%;
176	}
177
178	td.flume, th.flume {
179	font-family: arial, helvetica, sans-serif;
180	background-color: #bbcbff;
181	}
182
183	th.flume {
184	color: #000066;
185	font-weight: bold;
186	font-size: 1.1em;
187	text-align: left;
188	margin-bottom: 3pt;
189	width: 33%;
190	}
191
192	-->
193	</style>
194
195
196	</head>
197
198	<body
199
200	>
201
202
203	<!-- ITCS header -->
204	<table width="100%" border="0" cellpadding="0" cellspacing="0">
205	<tr>
206	<td align="left" bgcolor="#333366">
207	<a href="http://www.itd.umich.edu/" class="titleImg"><img src="http://www.itd.umich.edu/images/itcs-banner.gif" width="455" height="20" border="0" alt="information technology central services at the university of michigan" /></a>
208	</td>
209
210	<td align="right" bgcolor="#333366">
211	<img src="http://www.itd.umich.edu/date/Thursday.gif" alt="Thursday" /><img src="http://www.itd.umich.edu/date/April.gif" alt="April" /><img src="http://www.itd.umich.edu/date/24.gif" alt="24" /><img src="http://www.itd.umich.edu/date/2003.gif" alt="2003" />
212	</td>
213	</tr>
214	</table>
215	<!-- end ITCS header -->
216
217	<table width="100%" border="0" cellpadding="3" cellspacing="0">
218	<tr>
219	<td bgcolor="#000066"
220	background="../../images/blue-stripes.gif"
221	valign="bottom"><img
222	src="../../images/umweb-small.gif"
223	width="350" height="71" alt="um web services"
224	border="0" class="logo" />
225	</td>
226	</tr>
227	</table>
228
229
230
231
232
233	<table width="100%" border="0" cellspacing="3">
234	<tr>
235	<!-- Menu column -->
236	<td width="125" align="center" valign="top">
237	<table width="125" cellpadding="1" border="0">
238	<tr>
239	<td bgcolor="#000000" width="125">
240	<table width="125" cellspacing="0" cellpadding="3" border="0">
241	<tr>
242	<td width="125" bgcolor="#dddddd" align="left">
243
244	<p class="menu">
245
246	<a href="../..">home</a><br />
247
248
249
250
251	<a href="../../faq/">FAQ</a><br />
252
253
254
255
256
257	→
258
259
260	<a href="../../how-to/">how-to</a><br />
261
262
263
264	</p>
265	<p class="submenu">
266
267
268	<a href="../../how-to/homepage.html">homepage</a> <br />
269
270
271
272	→ <a href="../../how-to/cgi-scripts/">cgi scripts</a> <br />
273
274
275
276	<a href="../../how-to/weblogin.html">weblogin</a> <br />
277
278
279
280	<a href="../../how-to/sql.html">SQL</a> <br />
281
282	</p>
283
284	<p class="menu">
285
286
287
288
289
290	<a href="../../services/">services</a><br />
291
292
293
294
295
296
297
298	<a href="../../software/">software</a><br />
299
300
301
302
303	<!-- commented out until it is ready: clunis 8/13
304
305
306
307	<a href="../../statistics/">statistics</a><br />
308
309	-->
310
311
312
313
314	<a href="../../team/">team</a><br />
315
316
317
318
319
320
321	<a href="../../contact/">contact</a> <br />
322
323	</p>
324
325	</td>
326	</tr>
327	</table>
328
329
330	</td>
331	</tr>
332	</table>
333	</td>
334
335	<!-- left inner margin -->
336	<td width="5">
337	<img src="../../images/trans.gif"
338	width="5" alt="" />
339	</td>
340
341	<!-- main body column -->
342	<td width="600" valign="top">
343	<!-- ====== header and breadcrumbs ==== -->
344
345	<table cellpadding="0" cellspacing="8" border="0" width="90%">
346	<tr>
347
348	<td>
349	<h2>
350	counter
351	</h2>
352	</td>
353
354
355	<td align="right">
356	<!-- ======
357	this is formatted tight to avoid whitespace and wrapping
358	====== -->
359	<p>
360	<a href="../..">home</a> / <a href="../../how-to/">how-to</a> / <a href="../../how-to/cgi-scripts/">cgi-scripts</a> / <b>counter</b>
361	</p>
362	</td>
363	</tr>
364	</table>
365
366
367
368
369	<table cellpadding="6" cellspacing="4" border="0" width="90%">
370
371	<tr>
372	<td bgcolor="#dddddd">
373	<p class="hedr">Counter - an approximate count of hits on your page</p>
374	</td>
375	</tr>
376
377	<tr>
378	<td>
379	<p class="margins">
380	<a href = "./counter-faq.html">Counter</a> allows
381	you to display an image representing an access counter on a
382	given page. To put a counter on a page, include a tag
383	like:
384	</p>
385
386	<pre class="margin">
387	<img src="http://cgi.www.umich.edu/counter?link=
388	http://www.umich.edu/~umweb/index.html"></pre>
389
390	<p class="margins">
391	<b>Note:</b> This line must appear in your html
392	document on only one line. If you copy and paste any
393	of the counter examples from this page to your own
394	document, be sure to edit the file and remove any line
395	breaks in the counter link.
396	</p>
397	</td>
398	</tr>
399
400	<tr>
401	<td bgcolor="#dddddd">
402	<p class="hedr">Counter options</p>
403	</td>
404	</tr>
405
406	<tr>
407	<td>
408	<p class="margins">
409	The <b>link=</b> argument specifies the URL to be counted. It is
410	required. Additional arguments must be separated from each other by
411	ampersands (&)
412	</p>
413
414	<p class="margins">
415	The <b>ignore=</b> argument specifies IP
416	addresses (141.211.164.2) or domain names
417	(terminator.cc.umich.edu) that are forbidden from
418	incrementing the counter.
419	</p>
420
421	<p class="margins">
422	The <b>font=</b> argument specifies a font to use instead of
423	the counter's default. If you have a freely available
424	truetype font that you would like to see added to this
425	list please submit download information, author's name,
426	and contact information to webmaster. We will not be
427	able to add every font that is submitted.
428	</p>
429
430	<p class="margins">
431	The <b>width=</b> argument specifies how many digits are
432	displayed & has a maximum of ten. If you specify a
433	width that is too small for the number being displayed,
434	the counter will use only as many digits as it needs.
435	If you specify too large a width, the counter will pad
436	the number being displayed with zeros.
437	</p>
438
439	<p class="margins">
440	The <b>rand=</b> argument will cause the counter to display a
441	different random number everytime your page loads.
442	</p>
443
444	<p class="margins">
445	The <b>reset=</b> argument allows you to reset the counter to
446	a specific value.
447	</p>
448
449	<p class="margins">
450	The <b>text=</b> argument allows you to set the font color
451	using the "web color" scheme. For instance, to get a
452	counter with black text, set "text=000000". Note that "#"
453	is interpreted as an anchor by the browser, and as such
454	must be ommitted. "text=#000000" will not behave as you
455	expect.</p>
456
457	<p class="margins">
458	The <b>bgcolor=</b> argument allows you to set the background
459	color using the "web color" scheme. For instance, to get
460	a counter with a white background, set "bgcolor=ffffff".
461	Note that "#" is interpreted as an anchor by the browser,
462	and as such must be ommitted. "bgcolor=#ffffff" will not
463	behave as you expect.</p>
464
465	<p class="margins">
466	The <b>point=</b> argument allows you to set the point size
467	of the counter. Note this will only work in conjunction
468	with the font= argument, as the default font cannot be
469	sized.</p>
470
471	<p class="margins">
472	The <b>image=</b> argument allows you to make the counter
473	generate PNG images rather than the default image format,
474	JPEG. JPEG has been chosen as the default image format
475	because, being rendered internally by most browsers, JPEG
476	images appear to load more quickly and match the other
477	colors presented by the browser better than PNG files.
478	However, the image quality of JPEGs is lower than that of
479	PNG. PNG appears to be slower on some browsers ( those
480	that use a helper application to render the images may
481	appear to "hang" for a moment when loading the counter
482	image ) but the quality is superb.
483	</p>
484
485	</td>
486	</tr>
487
488	<tr>
489	<td bgcolor="#dddddd">
490	<p class="hedr">Counter options</p>
491	</td>
492	</tr>
493
494	<tr>
495	<td>
496
497	<p class="margins">
498	There is only one required argument in the counter:
499	<b>link=<i>URL</i></b>. There are other, optional
500	arguments, each of which needs to be separated by &
501	signs. All of the applicable arguments are listed below:
502	</p>
503
504	<table border="0" cellpadding="1" cellspacing="1">
505	<tr>
506	<th>Example</th>
507	<th>default</th>
508	<th>Example Image</th>
509	<th>Description</th>
510	</tr>
511
512	<tr>
513	<td>link=http://www.umich.edu</td>
514	<td>none</td>
515	<td><img src="http://cgi.www.umich.edu/counter?link=http://www.umich.edu" alt="" /></td>
516	<td>The URL of the page using the counter.</td>
517	</tr>
518
519	<tr>
520	<td>rand=true</td>
521	<td>rand=false</td>
522	<td><img src="http://cgi.www.umich.edu/counter?rand=true" alt="" /></td>
523	<td>Whether or not to display a random number.</td>
524	</tr>
525
526	<tr>
527	<td valign="top">font=gd</td>
528	<td rowspan="16" valign="top">gd is the default font</td>
529	<td><img src="http://cgi.www.umich.edu/counter?link=http://www.umich.edu/counter.html" alt="" /></td>
530	<td rowspan="16">The digit style of the counter.</td>
531	</tr>
532
533	<tr>
534	<td>font=transit</td>
535	<td><img src="http://cgi.www.umich.edu/counter?rand=true&font=transit" alt="" /></td>
536	</tr>
537
538	<tr>
539	<td>font=stylus</td>
540	<td><img src="http://cgi.www.umich.edu/counter?rand=true&font=stylus" alt="" /></td>
541	</tr>
542
543	<tr>
544	<td>font=steamer</td>
545	<td><img src="http://cgi.www.umich.edu/counter?rand=true&font=steamer" alt="" /></td>
546	</tr>
547
548	<tr>
549	<td>font=buff</td>
550	<td><img src="http://cgi.www.umich.edu/counter?rand=true&font=buff" alt="" /></td>
551	</tr>
552
553	<tr>
554	<td>font=zoinkfat</td>
555	<td><img src="http://cgi.www.umich.edu/counter?rand=true&font=zoinkfat" alt="" /></td>
556	</tr>
557
558	<tr>
559	<td>font=simpson</td>
560	<td><img src="http://cgi.www.umich.edu/counter?rand=true&font=simpson" alt="" /></td>
561	</tr>
562
563	<tr>
564	<td>font=adlibn</td>
565	<td><img src="http://cgi.www.umich.edu/counter?rand=true&font=adlibn" alt="" /></td>
566	</tr>
567
568	<tr>
569	<td>font=signboard</td>
570	<td><img src="http://cgi.www.umich.edu/counter?rand=true&font=signboard" alt="" /></td>
571	</tr>
572
573	<tr>
574	<td>font=arial</td>
575	<td><img src="http://cgi.www.umich.edu/counter?rand=true&font=arial" alt="" /></td>
576	</tr>
577
578	<tr>
579	<td>font=comic</td>
580	<td><img src="http://cgi.www.umich.edu/counter?rand=true&font=comic" alt="" /></td>
581	</tr>
582
583	<tr>
584	<td>font=courier</td>
585	<td><img src="http://cgi.www.umich.edu/counter?rand=true&font=courier" alt="" /></td>
586	</tr>
587
588	<tr>
589	<td>font=impact</td>
590	<td><img src="http://cgi.www.umich.edu/counter?rand=true&font=impact" alt="" /></td>
591	</tr>
592
593	<tr>
594	<td>font=trebuchet</td>
595	<td><img src="http://cgi.www.umich.edu/counter?rand=true&font=trebuchet" alt="" /></td>
596	</tr>
597
598	<tr>
599	<td>font=verdana</td>
600	<td><img src="http://cgi.www.umich.edu/counter?rand=true&font=verdana" alt="" /></td>
601	</tr>
602
603	<tr>
604	<td>font=lumos</td>
605	<td><img src="http://cgi.www.umich.edu/counter?rand=true&font=lumos" alt="" /></td>
606	</tr>
607
608	<tr>
609	<td>width=9</td>
610	<td>width=0</td>
611	<td><img src="http://cgi.www.umich.edu/counter?rand=true&width=9" alt="" /></td>
612	<td>
613	This setting determines how many digits are
614	displayed & has a maximum of ten.
615	</td>
616	</tr>
617
618	<tr>
619	<td>reset=1202</td>
620	<td>none</td>
621	<td><img src="http://cgi.www.umich.edu/counter?link=http://www.umich.edu/counter.html&reset=1202" alt="" /></td>
622	<td>Used to reset the counter to a specific, non-negative value. </td>
623	</tr>
624
625	<tr>
626	<td>text=9933ff</td>
627	<td>text=ffffff</td>
628	<td><img src="http://cgi.www.umich.edu/counter?rand=true&text=9933ff" alt="" /></td>
629	<td>Used to set the font color of the counter.</td>
630	</tr>
631
632	<tr>
633	<td>bgcolor=ffffff</td>
634	<td>bgcolor=000000</td>
635	<td><img src="http://cgi.www.umich.edu/counter?rand=true&bgcolor=ffffff&text=000000" alt="" /></td>
636	<td>Used to set the background color of the counter.</td>
637	</tr>
638
639	<tr>
640	<td>point=36</td>
641	<td>point=20</td>
642	<td><img src="http://cgi.www.umich.edu/counter?rand=true&font=comic&point=36" alt="" /></td>
643	<td>Used to set the point size of the counter font.</td>
644	</tr>
645
646	<tr>
647	<td>image=png</td>
648	<td>image=jpeg</td>
649	<td><img src="http://cgi.www.umich.edu/counter?rand=true&font=comic&image=png" alt="" /></td>
650	<td>Used to set the output format of the counter image. </td>
651	</tr>
652	</table>
653
654	</td>
655	</tr>
656	</table>
657
658
659	</td>
660
661	<!-- right outer margin -->
662	<td width="20">
663	<img src="../../images/trans.gif"
664	width="20" alt="" />
665	</td>
666	</tr>
667	</table>
668
669
670	<p class="footer" align="right">
671
672
673
674	Copyright © 2001 - 2003
675	Regents of the University of Michigan <br />
676
677
678	Page last updated:
679	Tuesday, 15 April 2003 <br />
680	</p>
681
682	</body>
683	</html>
684