This page contains instructions for installing and using
netINS provided scripts on your website. Instructions for the following
applications are available:
It is helpful to have a copy of the counter on your hard
drive before continuing. Follow the instructions on the
download page for unpacking the distribution before returning
here.
Upload the file - If you are installing
the standard counter, your filename will be "counter.cgi".
If you are installing the monthly counter, your filename
will be "counter_monthly.cgi".
Start up your FTP application and log into your
Basic Showcase area on the netINS server. Change
into the "cgi-bin" directory and upload the file
( either counter.cgi or counter_monthly.cgi )
to the server. MAKE SURE you
are uploading as "ASCII text", not binary and
to "chmod" the file to make it executable.
"chmod"ing a file is simply telling the server
that the file is allowed to be executable. The
correct permissions on the file are 755 (
most FTP applications will reference the permissions
with a number. If yours does not, 755 means "owner:
read, write, execute; group: read, execute; everyone
or public: read, execute ).
If you do not successfully CHMOD the file, the server will be unable to run the counter. For assistance with the CHMOD function of common FTP clients, please click here.
Add SSI calls to .shtml
files - Now that you have
the code installed, you simply
need to make an entry into
those files you wish to track.
HTML files need to have a
.shtml extension or the server
will not know to check that
page for a counter.
Add this following line to your page
where you would like to see the counter:
replacing [YOUR_AREA_NAME] with
your actual area name and [COUNTER_NAME] with
the name of the counter you installed
( counter.cgi for the standard counter,
counter_monthly.cgi for the monthly counter
).
Save your page, upload it, and give
it a try. You may have to reload the
page one or two times to get the counter
file created and counting the first time.
Congratulations! You just installed a monthly web counter on your
web page!! The counter does not put any style or color tags around
the number it generates, so feel free to do so to customize it however
you would like.
Counter Configuration File (Basic
Showcase)
The counter configuration file is an optional component that can be added
to extend the basic functionality of the standard and monthly counters, but
it not necessary to install to make them functional. If you are content with
the basic counter, you do not need to install this file.
Do note that all the counter packages above should be accompanied by
the latest version of the configuration file. If it did, you may skip Step
#1 below, otherwise, feel free to grab a copy from the downloads page at
any time.
If you interested in some of the optional items the counters can do (
like repetitive IP blocking and formatting with commas ), follow the instructions
below to download and install the configuration file.
Download the config file from the downloads page -
You will need to unpack it, just like you did for the counter.
Edit the file - Turning on or off
elements of the counters is usually done by simply changing
a 0 to a 1 in the right location. The configuration file
describes each variable available. Please read these
instructions thoroughly before continuing.
Version 1.2 of the configuration file includes
the ability to display the counter as images.
For more information, please visit:
Upload the file -
As you did with the counters, open
your FTP application, log into
your Basic Showcase area on the
netINS server, and put the file "counter.config" in
your cgi-bin directory. MAKE
SURE you are uploading
as "ASCII text", not binary. It
is not necessary to make this file
executable.
That's it. Once the configuration file is uploaded successfully, the
counters will automatically notice it exists and incorporate it for you.
If at any time you want to turn on or off other features, simply download
the configuration file from your site, and repeat steps 2 and 3 above.
Date scripts
Date ( Basic & Enhanced Showcase
)
The 'date' script works a lot like either of the counters, in both its installation
and actual use. It displays the current date like this: Wed Jun
19 07:43:50 CDT 2002
Download the date source code from the downloads page -
You will need to unpack it, just like you did for either of the
counters.
Upload the file - Start up
your FTP application and log into your Basic
Showcase area on the netINS server. Change into
the "cgi-bin" directory and upload the file "date.cgi" to
the server. MAKE SURE you are
uploading as "ASCII text", not binary and to "chmod" the
file to make it executable.
"chmod"ing a file is simply telling the server
that the file is allowed to be executable. The
correct permissions on the file are 755 (
most FTP applications will reference the permissions
with a number. If yours does not, 755 means "owner:
read, write, execute; group: read, execute; other
or world: read, execute ).
You must perform this, otherwise the server
will not to run your date script when asked to
do so. If you need some assistance using CHMOD,
see if your client is listed here
Add SSI calls to
.shtml files - Now
that you have the code
installed, you simply
need to make an entry
into those files you
wish to display the date.
HTML files need to have
a .shtml extension or
the server will not know
to display the date on
that page.
Add this following line to your page
where you would like to see the date:
replacing [YOUR_AREA_NAME] with
your actual area name
Save your page, upload it, and give
it a try. You may have to reload the
page one or two times to get the counter
file created and counting the first time.
You have successfully installed the date script. To try it out, view
the page(s) you edited in Step #3 and see if it works. The code does
not format the output in any way, so feel free to add any color or
style tags around it as you see fit.