Showcase Home
Activation
Support
Stats
Frequently Asked Questions
Resources
Change your Information
Downloads
Showcase Script Installation Instructions
This page contains instructions for installing and using netINS provided scripts on your website. Instructions for the following applications are available:
Web page counters
Standard counter and Monthly counter

  1. Acquire the source code - All netINS provided software is always available for download at:

    http://showcase.netins.net/1-800-205-1110/downloads/

    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.

  2. 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.

  3. 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:

    <!--#exec cgi= "/web/[YOUR_AREA_NAME]/cgi-bin/[COUNTER_NAME]" -->

    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.

  1. Download the config file from the downloads page - You will need to unpack it, just like you did for the counter.

  2. 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:

    http://showcase.netins.net/1-800-205-1110/resources/counter_types.cgi

  3. 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

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

  1. Download the date source code from the downloads page - You will need to unpack it, just like you did for either of the counters.

  2. 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

  3. 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:

    <!--#exec cgi= "/web/[YOUR_AREA_NAME]/cgi-bin/date.cgi" -->

    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.