counter.html

   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                 &rarr;
 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     &rarr; <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>&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>
 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 &lt;img src="http://cgi.www.umich.edu/counter?link=
 388 http://www.umich.edu/~umweb/index.html"&gt;</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 (&amp;)
 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 &amp; 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 &amp;
 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 &amp; 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 &copy; 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