##############################################################################
# Garibaldi's AddBanner Version 1.0                                          #
# Copyright 2000 Euro-Net                                                    #
# Created 8/28/2000                                                          #
# Available at http://handwritingfonts.virtualavet.net/scripts/              #
##############################################################################
# COPYRIGHT NOTICE                                                           #
# Copyright 2000 Euro-Net       All Rights Reserved.                         #
#                                                                            #
# This script can be used free of charge as long as you don't change this    #
# header thing, and until you start to earn money with this script. When you #
# want to use this script in commercial ways to show commercial banners and  #
# earn money on your website please mail me at garibaldi@mindless.com, and I #
# will ask from you credits for my work in ammount of 10 US$ (realy isnt too #
# much for hours of learning how to write scripts and you can earn more      #
# using this script).                                                        #
#                                                                            #
# The programmer will not be held responsible for any use of                 #
# this script or any modified version of this script. Your actions are       #
# your own and are in no way influenced by me so don't blame me if for       #
# some reason this script crashes a computer (which I'm sure it won't        #
# unless modified; but who can tell for sure) or anything similar as         #
# a result of the use of this script.                                        #
#                                                                            #
##############################################################################

Well here are some instructions for installing AddBanner. This script is very
easy for install.
This package comes with 3 files
banner.cgi - the script that rotates the banners
banneradmin.cgi - script for everything else
and this file that you read right now.

If you're missing any of these, go to 
http://handwritingfonts.virtualave.net/scripts/

Installation                                                            

Open banner.cgi and banneradmin.cgi in a text editor. If perl is not 
located at /usr/bin/perl on your system, change the first line to the 
location of perl. 
If you don't know where perl is, ask your system administrator. 

I prefer to create directory under cgi-bin for every script.
It is the cleanest and finest way for heaving many scripts, 
so I suggest work on that way.
Well create directory banners under cgi-bin.
This is the directory where we will upload .cgi files.
Under directory banners well create directory data for all files 
generates by script.
In both files you have line $datadir which supose to reflect to directory
you create for files generated by script. In this case directory data.
Now change line $datadir that reflect your server path (not the URL) to
the data directory.
Change $your_e_mail to your E-mail.

Connect to your server and go to cgi-bin directory.
Create directory banners.
Open banners directory.
Upload both .cgi files as ascii,and set the permissions for both to 755.
Create data directory and set directorys permissions to 777.

Thats all.
In your browser open banneradmin.cgi. When you firs time run this script
it will generate the password file with default password and notify.
Default password is admin.
Now you can change your password and start using script.
Add some banners.

Open the html file(s) that you want to use this script with.  Find the part
of the page where you want to add the banner, and enter the following text:
<!--#exec cgi="/cgi-bin/banner/banner.cgi" -->
or
<!--#include virtual="/cgi-bin/banner/banner.cgi" -->

If script doesnt work in one way try the other.
You may have to change the extension of the html file to .shtml

 FAQ                                                            

- Script returns 500 Internal Server Error, or when I go to a page using the
  script it says an error occurred.
      - Make sure you've changed the first line of both .cgi files to #! and
        then the path to perl on your system
      - Make sure you've uploaded the .cgi files as ascii, not binary.
      - Make sure you've set the permissions for the .cgi files to 755.

- When I add a banner, it comes up on the confirmation screen, but isn't added
  to the admin page.
      - Make sure that you've entered the server path (not the URL) to the
        data directory in both .cgi files.
      - Make sure that you've set the permissions for the data directory to
        777.

- I added <!--#exec cgi="/cgi-bin/banner.cgi" --> to the page I wanted, but it
  doesn't generate an add.

  - If you receive a message like this [error proccessing this directive]
    on the place you want banner be sure that you enter the correct path 
    to banner.cgi on your server.

  - Go to the uploaded page and view the source.  See if the
    <!--#exec cgi="/cgi-bin/banner.cgi" --> is still there. 

  - If it is:
     - Try renaming the file from whatever.html to whatever.shtml
     - You may not have SSI.  Ask your system administrator.

  - If it isn't:
     - Make sure that you've added at least one banner.

