EZVOBO - easy voting booth generator, by manny juan 5/2/2000

EZVOBO INSTALLATION INSTRUCTIONS
----------------------------------
unzip ezvobo.zip to a work directory

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 your voting booths in a subdirectory called 'vote'

then you should do the following:

SETUP
        1. in the example above, 'vote' will become the value of variable '$userdir'
        2. create the subdirectory 'vote' under the home base directory and chmod to 777
        3. copy the logo, mjmall.jpg into the subdirectory 'vote' 
        4. copy the color scheme graphic, ezpalette.gif into the subdirectory 'vote' 

INDEX.HTML
        1. supply correct URL for the logo 
                (ie. IMG SRC=http://www.isp.com/website/vote/mjmall.jpg)
        2. supply correct URL for the cgi script.  for example:
                <form action="http://www.isp.com/website/cgi-bin/ezvobo.pl" method="POST">
        3. supply the correct value for userdir for 'new page' button.  for example, 
                <input type="hidden" name="userdir" value="vote">
        4. do above two more times for the 'edit page' and 'delete page' buttons.
        5. keep the <!--begin--> line in the page. DO NOT REMOVE!
        6. install in subdirectory 'vote' and chmod to 777

DATA.TXT (SEE NOTE BELOW)
        1. (initially empty)

EZVOBO.PL (voting booth generator 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. supply value of $cgi (what file type  - cgi, pl - is used for cgi scripts?)
                $cgi = "pl";    (or $cgi = "cgi";)
        3. supply value of $base_dir (complete path,  not URL, to the voting booth directory)
                $base_dir = "/home/htdocs/your.isp.com/website/$userdir";
        4. supply value of $cgiurl (URL of the directory where cgi scripts reside)
                $cgiurl = "http://www.isp.com/website/cgi-bin";
        5. supply value of $imageurl (web accessible URL where the logo and color scheme file are kept)
                $imageurl = "http://www.isp.com/website/$userdir";
        6. supply value of $indexpage (complete path to the index list of voting booths)
                $indexpage = "/home/htdocs/your.isp.com/website/$userdir/index.html";
        7. supply value of $data (the full path, not URL, to the login data file.  
           you should rename this file. see more notes below regarding the use of this file)
                $data = "$base_dir/data.txt";
        8. where is your email program
                $sendmail = '/usr/sbin/sendmail';
        9. your email  (use apostrophe not quote)
                $myemail = 'email@isp.com';
        10. install this script in cgi-bin and chmod to 755

EZVOTE.PL (THE voting booth script)
        1. supply value of $data_path (path to the directory for new page $pagename)
                $data_path = "/home/htdocs/your.isp.com/website/$userdir/$pagename";

        2. supply value of $ezvote_url (URL too the voting booth directory)
                $ezvote_url = "http://www.isp.com/website/$userdir/";


NOTE: the file DATA.TXT contains three fields used for validating the identity of the user: 
namely login-id, email-id and pagename.  in order to prevent others from obtaining 
login information by reading this file with such a common name, it is recommended that 
you change the name of this file to xcmdsfe.wsz or some other rubbish but valid file name.  
if you do rename this file, then you should also change the variable $data in the ezvobo 
script.

ezvote.pl was derived from vote.pl with minor modifications to show color and to work with ezvobo.
the script vote.pl may be found at chris(tm)'s perl script site at www.shavenferret.com/scripts

----------
manny@jps.net
http://www.inet-images.com/manny
5/2/2000