*********************    WebAd 1.1    *********************       
Copyright (c) 1999, Mittenda AB. - All rights reserved
webmaster@finechoice.com
http://www.finechoice.com/wa
***********************************************************

Contents:
1. License Agreement
2. Description
3. System Requirements
4. Step by step installation

      

***********************************************************
1. License Agreement  
-------------------------------------------------------------------------
You should carefully read all of the following terms and conditions before
using this software. Your use of this software indicates your acceptance
of this license agreement and warranty.
This software is owned by Mittenda AB and is protected by copyright laws
and international treaty provisions. You may not remove the copyright
notice from any copy of the software or any copy of the materials
accompanying the software.

Permitted Uses
-------------------------------------------------------------------------
You may use the evaluation version only at one server for a time limited of 30 days. After that, however, you must either obtain a registered copy, or discontinue use of the product.
You may use the licensed version on one domain and on one server into a single cgi-bin directory only.

Evaluation Version Limitations
-------------------------------------------------------------------------
The evaluation version is limited to a maximum of 2 zones and will display
a banner back to the WebAd site every 25th time one of your banners are
supposed to be displayed.

Modification
-------------------------------------------------------------------------
You are not permitted to modify or copy any segment of the code provided,
except for the "config.h" file, without consent from Mittenda AB.

Distribution
-------------------------------------------------------------------------
You may not charge or request any form of payment from any copies you may
make of this program. You may not distribute this product alone or with any
other products without written permission from Mittenda AB.

Disclaimer of Warranty
-------------------------------------------------------------------------
THE INFORMATION AND CODE PROVIDED IS PROVIDED AS IS WITHOUT WARRANTY OF ANY
KIND, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO
EVENT SHALL MITTENDA AB BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING
DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR
SPECIAL DAMAGES, EVEN IF MITTENDA AB HAS BEEN ADVISED OF THE POSSIBILITY OF
SUCH DAMAGES.



***********************************************************
2. Description

Many webmasters rely on clickthrough banners to finance their websites. Usually you have the choice between many banners and it therefor very important to be able to follow up which spots that are the best and which banners that are best. By doing that you can easily remove the banners that are not so good and keep the best ones only. You can often increase your profits by 100% this way! Follow up the statistics and remove banners with, for example a clickthrough rate of less than 1.5%.
WebAd is a banner rotator written in C, which can handle very high volumes of traffic without putting a too high load on the server - something that a banner rotator written in the PERL language wouldnt be able to. This program has been tested with a traffic of 70000 unique visitors per day.
With WebAd installed you can easily add or remove a specific banner for the hole site. No need to go in and make changes to several html pages.
WebAd supports zoning which means that you can have several different sets of banners (or text links) in rotation on several pages and spots. You can then follow the statistics for each banner at each spot.



***********************************************************
3. System Requirements

* A UNIX based server with the access to run cgi scripts
* Possibility to use SSI (server side includes) ask your server support about that.

For installation you will need:
* A ftp program. WS_FTP works find and can be downloaded from:
http://www.frontiernet.net/~qpcsoft/
* a telnet program. QVT/Term works fine and can be found at:
http://www.ipswitch.com/

* To run the administrator program you will need a java capable browser.
Netscape 4.0 or Explorer 4.0 will work fine.


***********************************************************
4. Step by step installation

The following files should be included in the web-ad.zip
 admin.c
 adddispl.c
 adgoto.c
 config.h
 makefile
 readme.txt  (this file)
 code.dat

Unzip these files to temporary harddrive on your computer.

Now start your ftp program and log in to your server. Create the a subdirectory  where the log files, that the program uses, are stored. For higher safety and privacy, we suggest that you create this subdirectory out side the "public_html" area i.e. where they cant be reached from the www.
It should be something like:
"/usr/home/yourdomain/logs"

Now you have to set the file permissions for that directory. That could be done from WS_FTP by right clicking on the directory and selecting "chmod (UNIX)" and ticking all the boxes.
Or, you can log in with your telnet program and type "chmod 777 logs".

After this, you should create the subdirectory called "wa" under cgi-bin, where the cgi files should be run from. It should be something like:
"/usr/home/yourdomain/public_html/cgi-bin/wa"

Normally it shouldnt be, but it could be nessecary to set the permission to "chmod 777 logs" for this directory as well.

Use a normal text editor to edit the file called "config.h". Instructions for that can be found inside that file. Transfer all the files to the "wa" directory you created. You must use the "ASCII" option on your ftp program, not the "Binary".

Log in with you telnet program, navigate to the "wa" directory and type "make". Now the files should be compiled and you should be done!

Some basic tutorial for telnet:
To change a subdirectory, type "cd directoryname". "cd .." will change back. By typing "ls", all the file in that directory chould be listed.

---------------------------------------------------------------------------

Now you can try the admin program with your browser:
http://www.yourdomain.com/cgi-bin/wa/admin.cgi

Go to the "Create a new zone:" field and enter the name of the first zone. Lets call it "wyw", for example.

After this you should be able to see the new zone. Before you add any banners to this zone, you have to use the "Create a new banner:" field to put in data for some banners.

To make the banners in this zone appear on a page you have to enter the following to the html:
<!--#include virtual="cgi-bin/wa/addispl.cgi?z=wyw" -->

The last part (z=wyw) is the zone name. If you want to use another zone, just put the name of that zone there instead of "wyw".

This html page has to be a SSI (server side include) page. This means that it is possible to start a cgi script from there. Usually you need to call that file .shtml instead of html or htm. If you cant get this to work, please contact your server support to set the required permissions fot SSI.


GOOD LUCK!

