
This software is distributed under LGPL, see the header of the file
adbanner.pike for details.

Adbanner is Copyright to Darryl Fuller, 1999.

This work is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
General Public License for more details.

PREAMBLE
--------

Adbanner is an Ad banner rotation module for the Roxen Challenger web
server.  It has the following features:

	- Random adbanner rotation.
	- Ad banner hit count.
	- Ad banner reference ("click through") count.
	- A "subdirectory" mechanism for having distinct groups
	  of Ad banners.
	- A cheesy web based administration interface.

The discerning reader of code will notice that Adbanner is a bit of a hack.
I whipped it together over the course of a week to satisfy my own Adbanner
requirements.  I don't really have a heck of a lot of time to maintain it
or ad features, so if *you* are feeling bright-eyed and busy-tailed and 
would like to take over this codebase, please let me know.

INSTALLATION NOTES
------------------

This module requires an up-to-date Roxen Challenger web server.

Add this as a Roxen module (ie, either copy the adbanner.pike file to
your roxen modules/ directory, or add the current path where you
unpacked this archive to your Roxen global module search path). 

Create a directory for Adbanner to store adbanners in, setting
permissions on it so that the webserver has read and write access to
it.  Then add this module to the webserver you are running with Roxen's
administration interface, and fill in the exposed variables.

Create a web page for the administration interface, and put the
tag <adbanner cmd="admin"> on it.  Use the web interface supplied by
that to create your Ad banners.  If you want some of your pages to have
different sets of adbanners than other pages, put those ad banners into
separate subdirectories.

On pages where you want adbanners to appear, put the tag <adbanner>.

On pages where you want adbanners in particular subdirectories to appear,
(in this instance, ad banners in a subdirectory "fubar") put the tag
<adbanner subdir="fubar">.

To create pages where customer can check their statistics, create a page
with the tag <adbanner cmd="stats" company="foo">, where "foo" matches
the company name field specified in the ad banner.  To restrict access
to the stats, put the tag on a page with access restricted by some other
Roxen security and user id module.

UPDATES
-------

Mail any problems, source code updates and questions to darryl@lvwr.com
although, as previously noted, I have regretably little time to devote
to this software.

The current version of this software can be found at:
	http://stomp.lvwr.com/software/adbanner/


