Traffic Source Documentation

1. Requirements
2. Installation Instructions
3. How to use Traffic Tracker

1. Requirements

Your own standard cgi-bin directory.
This is the directory where the cgi scripts are executed from. An example of a standard cgi-bin directory:
http://www.yourdomain.com/cgi-bin

Perl Ver 5+

FTP access to transfer files and to set permissions of files and directories.

A MySQL database with user name and password to access the MySQL database.

Linux/Unix based host/server

2. Installation Instructions

Traffic Source comes with an installation interface that has been created to make the installation of it as easy as possible. If this is the first time you install a CGI Script we would highly recommend you read our CGI Tutorials. It should give you a better idea of what CGI is and how it works, enabling you to easily install any CGI Script.

Follow the steps below exactly as described and you should have Traffic Source serving you in a couple of minutes. Do the steps as you read through them. The setup instructions looks lengthy but it could actually have been explained in a couple of lines. The reason for it being a lot of text, is that we are trying to cover all possible situations when doing the setup and to explain it thoroughly to avoid any setup problems. If you experience problems after the installation, refer to our installation trouble shooter for help.

Step 1. (Extract the .zip archive)

Extract the files with their directories that came in the download .zip archive.

Step 2. (Create a directory called 'html')

Create a directory called 'html' or anything else you would like to call it. This directory should be inside your public html directory. This directory will hold images used by Traffic Source.

Step 4. (Transfer files to the 'html' directory)

The installation .zip archive will contain directories inside it. These directories are 'cgi', and 'html'

Now transfer (via FTP) the files inside the 'html' directory of the .zip archive to the 'html' directory you have created.

Step 5. (Transfer files to your 'cgi-bin' directory)

The .zip archive will contain directories inside it. These directories are 'cgi', and 'html'

Transfer (via FTP) the files in the 'cgi' directory of the .zip installation archive to your 'cgi-bin' directory. You could place the files in for example: http://www.yourdomain.com/cgi-bin/tsource/

Step 6. Set Permissions of .cgi and .pm files

Set the permissions of the .cgi and .pm files to the permission setting of 755.

Step 7. (Set config.cgi to the permission setting of 777)

Assign the permission setting of 777 to config.cgi - config.cgi is one of the files that you copied into your cgi-bin directory.

Step 8. (The setup interface)

Load setup.cgi in your browser and follow the instructions from there. setup.cgi is in your 'cgi-bin' directory where you have copied the .cgi and .pm files.

It should be located at, for example:
http://www.yourdomain.com/cgi-bin/tsource/setup.cgi

3. How to use Traffic Source

The use of Traffic Source should be easy. Simply log into the Control Panel. Create a tracker by supplying a tracker name. After the tracker has been created, get the HTML code and paste the HTML code into your web pages to start tracking referrers. Go back to the Control Panel after a while to see who referred traffic to the pages that has the HTML code. You can set up as many trackers as you wish.