EZBXGEN - easy banner exchange maker, by manny juan 5/7/2001

EZBXGEN INSTALLATION INSTRUCTIONS
----------------------------------

ASSUMPTIONS
        your home base directory is
                path=   /home/htdocs/your.isp.com/website
                URL=    http://www.isp.com/website

        your cgi url is:
                URL=    http://www.isp.com/website/cgi-bin

        you want to store the banner exchanges in a subdirectory called 'bp'.
        note: each banner exchange will be a subdirectory beneath 'bp'.

then you should do the following:

SETUP
        1. create the subdirectory 'bp' under the home base directory and chmod to 777
        2. unzip ezbxgen into this directory
        3. all the .cgi files will go your cgi-bin directory and chmoded to 755

INDEX.HTML
        1. supply correct URL for the logo 
                (ie. IMG SRC=http://www.isp.com/website/bp/mjmall.jpg)
        2. supply correct URL for the cgi script.  for example:
                <form action="http://www.isp.com/website/cgi-bin/ezbxgen.pl" method="POST">
        3. do above two more times for the 'edit banner exchange' and 'delete banner exchange'
        buttons.
        4. keep the <!--begin--> line in the page. DO NOT REMOVE!
        5. chmod to 777

DATA.TXT (list of users) 
        1. (initially empty)
        2. install in subdirectory 'bp' and chmod to 777

EZBXGEN.GIF     - keep in 'bp', ez banner exchange default banner
EZPALETTE.GIF   - keep in 'bp', color scheme selection graphic
HEY.GIF         - keep in 'bp', a tiny pic of an exclamation point
MJMALL.JPG      - keep in 'bp', logo for ez banner exchange maker

EZBXGEN.PL (easy banner exchange maker script)
        (you might have to change the extension to .cgi depending on your server)
        1. make sure first line of script points to location of perl program
                #!/usr/bin/perl
        2. come with two random letters to become the "salt" for the crypt function.
        you will also need this in bpvars.cgi
                $gSalt = "mj";
        3. you might not need to change this: is your server win95? (my win95 server
        cannot handle file locking)
                $win95 = 0;
        4. supply value of $cgiurl (URL of the directory where cgi scripts reside)
                $cgiurl = "http://www.isp.com/website/cgi-bin";
        5. supply the full path to the directory where the banner exchanges will reside
                $basedir = "/home/htdocs/your.isp.com/website/bp";
        6. URL of the directory where the banner exchanges will be stored
                $baseurl = "http://www.isp.com/website/bp";
        7. what is the complete path of the index list of banner exchanges? (not normally changed)
                $indexpage = "$basedir/index.html";
        8. what is the complete path of the user list? (see note below)
               $data = "$basedir/data.txt";
        9. where is your email program
                $sendmail = '/usr/sbin/sendmail';
        10. your email - email-id of the person giving this service - (duh, you!)
        (use apostrophe not quote)
                $myemail = 'email@isp.com';
        11. install this script in cgi-bin and chmod to 755

BPVARS.CGI (common variables definition)
        1. supply the full path to the directory where the banner exchanges will reside
                $basedir = "/home/htdocs/your.isp.com/website/bp";
        2. URL of the directory where the banner exchanges will be stored
                $baseurl = "http://www.isp.com/website/bp";
        3. supply value of $cgiurl (URL of the directory where cgi scripts reside)
                $cgiurl = "http://www.isp.com/website/cgi-bin";
        4. where is your email program
                $mailprog = '/usr/sbin/sendmail';
        5. come with two random letters to become the "salt" for the crypt function.
        you will also need this also in ezbxgen.pl
                $salt = "mj";
        6. you might not need to change this: is your server win95? (my win95 server
        cannot handle file locking, so i turn this to 1 while testing)
                $win95 = 0;
        7. install this script in cgi-bin and chmod to 755

BPADMMOD.CGI    - no change; install in cgi-bin and chmod to 755
BPCONF.CGI      - no change; install in cgi-bin and chmod to 755
BPGETCFG.CGI    - no change; install in cgi-bin and chmod to 755
BPJOIN.CGI      - no change; install in cgi-bin and chmod to 755
BPMEMBER.CGI    - no change; install in cgi-bin and chmod to 755
BPSUBS.CGI      - no change; install in cgi-bin and chmod to 755
BPWORK.CGI      - no change; install in cgi-bin and chmod to 755

ADMINISTRATION
--------------
after the banner exchange page is created, the admin panel may be reached by doing either of the
following:
1. edit the page and click on the link at the bottom of the page pointing to admin functions.
2. enter the URL of the banner exchange directory and append /bpadmin.html
(eg. if the user created a banner exchange called 'musicmax', the url for the admin function
can be entered as "http://your.isp.com/bp/musicmax/bpadmin.html"


NOTE: the file DATA.TXT contains fields used for validating the identity of the user.  you
may want to rename this file to a name that cannot be guessed easily.  if you do, make sure
you also change the ezbxgen.pl and bpvars.cgi scripts.


NOTE: EZBXGEN was written to work with scripts originally written by Drummond Miles 
(bplus@gadnet.com) of http://www.gadnet.com/bplus/ under the name of freeware bannerplus.  
please respect those copyrights.  please do not remove any of the links and copyright
information from any of the scripts of the generated pages.

thank you.

----------
manny@jps.net
http://www.inet-images.com/manny
5/7/2001
