-
Count.cgi is
a CGI perl script that interfaces the server-side include
text counter, which is our preferred method of
counting.
Since the graphical counter is only a front end to the text counter, the count is the same for both the text and graphical counters. In other words, the count of a web page will change using either a text or graphical counter, and these two types of counters are interchangable.
NOTE:
The graphical counter, unlike the text counter, doesn't use server side includes; therefore you don't need to worry about setting your file to be parsed by the server (i.e. a .htaccess file is not necessary).A graphical counter is an image CGI, so it is referenced with the following tag (you should add a similar tag to your Web page file in order to display the counter):
<IMG SRC="/cgi-bin/Count.cgi?option=value&option=value">where- one of the option=value statements must be the digit style.
Please see
the graphical counter example page
for examples of different digit styles.
- and the other
option=value statements are parameters that you can set
(e.g. you can set the frame thickness and the frame color of your counter).
You can add as many parameters as you want as long as
they are separated by an
&. For a list of parameters and their corresponding descriptions,
please go to parameters.
Note: For department web pages the above tag should be
<IMG SRC="http://www.personal.psu.edu/cgi-bin/Count.cgi?option=value&option=value">An example of a graphical counter with two parameters is<IMG SRC="/cgi-bin/Count.cgi?dd=odb&ft=10&frgb=180;0;0">where dd=odb is the counter and ft=10 and frgb=180;0;0 are the parameters. This tag will display the following counter to your Web page:If you want a counter to count the number of hits on a Web page (call it count.html), but you want the count displayed on a different Web page (call it display.html), you need make sure that *EACH* of these pages contains a counter tag and that the counter tag in display.html includes the personal_url tag.
The personal_url tag, however, will increment the count for both pages every time display.html is accessed, which is not want we want. Since we only want the count for count.html incremented when count.html is accessed (and not when display.html is accessed), an incr=0 tag needs to be added to the personal_url counter tag.
For example, if you want to display the count of count.html on count.html as well as on display.html using the graphical counter dd=emboss and assuming your URL is http://www.personal.psu.edu/abc100, you need to: - Add the tag
<IMG SRC="/cgi-bin/Count.cgi?dd=emboss&personal_url=/users/a/b/abc100/
count.html&incr=0"> to display.html
- Add the tag <IMG SRC="/cgi-bin/Count.cgi?dd=emboss">
to count.html
Remember, in order for this to work, you MUST include a counter tag in count.html AND in display.html. Additionally, you must add your own personal_url, and you can use any graphical counter you wish.
Note:
If you want the count of count.html displayed ONLY on display.html and NOT on count.html, add this tag <IMG SRC="/cgi-bin/Count.cgi?sh=F"> to count.html and NOT the tag in the above example.For departmental pages the personal_url should be specified as /dept/dept_name/page1.html
You can also add the following parameters to your graphical counter tag:
Parameter Name Description Default display=X Specifies what to display. A valid string can be specified with display= parameter to display counter, clock, date or number. The valid value for the string parameter X is counter,clock,number or date To use a counter of www.personal.psu.edu this option should be omitted. display=number value=X Value of the number display. This is the number to display with the "display=number" option. value=888888 timezone=X Display time/date of the specified timezone. The parameter timezone= is only significant with display=clock or display=date. Use this parameter if you want to display time or date of another timezone. The timezone must be specified with a negative or positive four digit offset from GMT, for example: timezone=GMT-0500 or timezone=GMT+0000 or timezone=GMT+0530. The routine to display time of various timezones are written in a generic way. Therefore, the unix machines will not be aware of daylight saving time because of the way the routine is written. For example, if daylight saving time is on, to display time of NY, the timezone will be timezone=GMT-0500 instead of timezone=GMT-0400. If the clock displays your local time wrong, specify your timezone with that parameter in order to display the correct time.
None. tformat=X [new in this release]
Time format in 12 or 24 hour. This parameter can be used to display time in 12 or 24 hour format. The valid values for the parameter X is 12 or 24. tformat=12 dformat=X Specifies date format. This parameter is only significant with display=date. The valid value for the string parameter X is any combination of MMDDYY (Month-Day-Year). For example, dformat=ddmmyy, dformat=YYMMDD. dformat=MMDDYY istrip=B [new in this release]
Use of image strip On/Off The boolean value of istrip specifies whether to use image strip or not. If you specify istrip=F, the program will look for the individual digit image files in the digits/style directory. The valid values for the Boolean parameter istrip are Y, N, T, F, 1 or 0. istrip=T ft=X Frame Thickness You can wrap the counter in an ornamental frame of X pixels thick. Use 0 for no frame. Values over 5 make a nice 3-D effect. ft=6 frgb=R;G;B Frame Color Specifies the color of the frame in RGB (red/green/blue) format. Each color component, R, G, and B is specified as a value between 0 and 256. If you use ft= without a frgb= param, the default color is used. If you specify a frgb= without a ft=, then the frame thickness defaults to 5. All the examples show ft=5. The color can be specified as hex string or a name. Do not use a # before the hex string as Netscape. For example, if you want to specify white in hex, use frgb=ffffff. You also can use a color name (e.g. frgb=blue) if the counter configured to do so (look at the cfg file). Look at the color name mapping database for some hints about color name database.
frgb=100;139;216 or
frgb=648bd8tr=B Transparency On/Off You can specify if your counter image will have a transparent color with the Boolean B. So tr=Y means there will be a transparent color. It does not matter if the GIF files used for the digits are "transparent"; you must specify explicitly which color to make transparent. If you specify a trgb=, then you do not need to specify tr=Y. If you specify tr=Y and do not specify trgb=, then the default color black will be transparent. The valid values for B are Y, N, T, F, 1, or 0. tr=F
No Transparencymd=X Max Digits Defines maximum number of digits to display. Any value between 5 and 10 inclusive are permitted. Padding with leading zeros is automatically done for you; longer counts are truncated to the given X. md=6
Without paddingpad=B Padding with 0's Turn padding on/off in conjunction with md= setting. Valid values for the Boolean parameter B are Y, N, T, F, 1, or 0. pad=N
Without specification of a md=valuepad=Y
With specification of a md=valuedd=A Digit Directory To see examples of digits installed, check the graphical counter example page. dd=A
My green led digitsimage=gif_file [new in this release]
Display this GIF file You can display any GIF image specified with this parameter. The location of this file is determined by the dd= parameter. All attributes of the counter applies to the image. None comma=B [new in this release]
Display comma after every 3rd digit from right. The boolean value of parameter comma specifies whether to display comma after every 3rd digit from right. If you use this parameter as true, the left padding with zeros will be turned off. comma=F srgb=R;G;B
prgb=R;G;B[new in this release]
Change a color of the image to a target color on the fly. Any one color of the image can be changed to a different color on the fly. srgb stands for source color, that is the color to change. prgb stands for pen color, that is the target color. The values for srgb and prgb can be colon separated color components (e.g, srgb=255;0;0), a hex value (e.g. srgb=ff0000) or a color name (e.g. srgb=red). The color name can be used if you configured the counter to do so (look at the cfg file). srgb=00ff00
(0;255;0 green)prgb=00ffff
(0;255;255 cyan)With chcolor=T
chcolor=B Change a color of the image. This parameter is usually used to change the default green color to cyan. That is if you specify chcolor=T, and you want to change green to cyan, then you do not need to specify srgb and prgb parameters. 1x1 GIF is displayed. The valid values for the Boolean parameter B are Y, N, T, F, 1, or 0 chcolor=F st=X
Disabled on www.personalStart Count This parameter is used to set the initial value of the counter to some number X. This is only valid if you decided to allow automatic datafile creation. It is a bad practice to allow automatic datafile creation, however it makes site maintaining easier. The automatic datafile creation option is specified in configuration file and can be changed at run time. Note that this parameter has no effect if the datafile already exists. If you want to change the counter value in a existing datafile, hand edit the file. The minimum value for st is 1. st=1
Count starts at 1sh=B Show digits Used to turn display of digits on or off according to the Boolean B. When sh=T, counter will be displayed and incremented, this is the default behavior. If sh=F no digits will show, but the counter will still increment; instead of digits a transparent 1x1 GIF is displayed. The valid values for the Boolean parameter B are Y, N, T, F, 1, or 0
sh=Y df=data_file
Disabled on www.personalDatafile to store count Specifies the name of the file for storing the count in. The file must be allocated to you as was mentioned in the "Authorizations" section above. You can use df=random to display a random number. One special use of the parameter is df=RANDOM. This returns a random number using the fractional portion of the host's time of day clock as a seed for the generator. Unlike all other WWWcounter parameters, the file name provided is case-sensitive, except for the value random. Or Random, or rANDOM, etc.
df=random
if no datafile is specifiedincr=B Increment Count Makes it possible to display the current count without incrementing the count. This can be used to examine the count for reporting or other purposes without adding to the count. Valid values for the Boolean parameter B are Y, N, T, F, 1, or 0. incr=T
Increment the counter on each invocationlit=X Display literal Makes it possible to display a given, predetermined string. The valid values for the string X are digits, a,p,: and - None negate=B Negate the color Makes it possible to negate the color of the counter digits. Note that the Frame is exempted from negating. Valid values for the Boolean parameter B are Y, N, T, F, 1, or 0. negate=F
Do not negatedegrees=X Rotate X degrees Makes it possible to rotate the counter image X degree. The possible values of X is 90, 180, 270 and 360. Note 360 is meaningless as the counter will come back to the original 0 degree. degrees=270
With rotate=Y and without degrees=X
rotate 270 degrees clockwiserotate=B Rotate On/Off The Boolean value B turns on or off rotating. If you use degrees= setting, rotate is not needed. Valid values for the Boolean parameter B are Y, N, T, F, 1, or 0. rotate=F
Do not rotate - one of the option=value statements must be the digit style.
Please see
the graphical counter example page
for examples of different digit styles.
-
This counter is a text counter, which will work with any browser on the
planet. There is also a graphical counter --
the text counter is the back end to the graphical counter.
In order to use a text counter, you MUST do two things.
-
A text counter is a server side include (SSI). For more information about
SSI, read the
advanced
Web FAQ - Server Side Includes.
In order to use server-side includes, you have to make sure that the
file type in which you put the server-side include tags is set to be parsed by the
server.
In other words, either
- add the following tag to your .htaccess file:
AddType text/x-server-parsed-html .html
- simply give the file a .shtml extension instead of the .html
extension.
- add the following tag to your .htaccess file:
-
You need to add the following tag to your
home page file:
<!--#exec cgi="/cgi-bin/counter_program"-->
where counter_program is one of the following counter programs:Program Name Description Example output counter Integer number, increment count, link 42 counter-nc Integer number, does not increment count, link 43 counter-nl Integer counter, increment count, no link 43 counter-nc-nl Integer counter, does not increment count, no link 44 counter-ord Ordinal counter, increment count, link 44th counter-ord-nc Ordinal counter, does not increment count, link 45th counter-ord-nl Ordinal counter, increment count, no link 45th counter-ord-nc-nl Ordinal counter, does not increment count, no link 46th
-
A text counter is a server side include (SSI). For more information about
SSI, read the
advanced
Web FAQ - Server Side Includes.
In order to use server-side includes, you have to make sure that the
file type in which you put the server-side include tags is set to be parsed by the
server.
In other words, either
- Please see the corresponding documentation.
-
This is a ph to html search engine. It accepts either the POST or the GET
method. For an example that uses the POST method, look at the source for the
root page of this server. An example of the GET method is below.
The script will us ph to search for a person/people, using the name of the variables passed as the field to search on, so <A HREF="/cgi-bin/ph.cgi?kerberos=chilly">My PH entry</A> would return the entry whose "kerberos" field matched "chilly".
-
This cgi will output the page from which your html page was requested from.
If
your html file is already set up to be server side interpreted, you only
need to add the line:
<!--#exec cgi="/cgi-bin/referer.cgi"-->to get the output. Example:
The last page you were at was [an error occurred while processing this directive]
-
This server side include is designed to echo the hostname in your page. If
your html file is already set up to be server side interpreted, you only
need to add the line:
<!--#exec cgi="/cgi-bin/remote_host.cgi"-->to get the output. Example:
Hello [an error occurred while processing this directive]