EZGUESTBOOK INSTALLATION INSTRUCTIONS   
-------------------------------------
V1.30 3/1/2000
(see upgrading notes below)

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 create a guestbook directory, say gb, off your home base directory such
    that new guestbook pages will be created there
        path=   /home/htdocs/your.isp.com/website/gb
        URL=    http://www.isp.com/website/gb

        note: the logo is expected to reside inside 'gb' with the name 'mjmall.jpg'
        URL=    http://www.isp.com/website/gb/mjmall.jpg

then you should do the following:

SETUP
    1. in the example above, gb is known as variable 'userdir'
    2. create subdirectory 'gb' as illustrated above and chmod to 777

MJMALL.JPG
    1. copy the logo, mjmall.jpg in 'gb'
    2. the 2 scripts look for this logo image inside the 'gb' directory

EZPALETTE.GIF
    1. copy the color selection image, ezpalette.gif to 'gb'

INDEX.HTML
    1. supply correct URL for the logo (ie. IMG SRC=...)
    2. supply correct URL for the cgi script.  for example:
    <form action="http://www.isp.com/website/cgi-bin/ezguest.pl" method="POST">
    3. supply the correct value for userdir.  for example
    <input type="hidden" name="userdir" value="gb">
    4. do above two more times for the 'edit page' and 'delete page' buttons.
    5. supply correct URL for the cgi script to the lost-password link.
        <center>Forgot password?
        click <a href="http://www.isp.com/website/cgi-bin/ezpwgb.pl">here</a>
        </center>

    6. keep the <!--begin--> and <!--end--> lines in the page. DO NOT REMOVE!
    7. install in 'gb' and chmod to 777

DATA.TXT  (YOU SHOULD RENAME THIS TO SOMETHING ONLY YOU SHOULD KNOW!)
    1. (initially empty)
    2. install in 'gb'and chmod to 777

DATE.PL (generalized date routines)
    1. no change, install in cgi-bin and chmod to 755

EZGUEST.PL (guestbook generator script)
    1. supply value of $base_dir (complete path to the guestbook directory)
        $base_dir = "/home/htdocs/your.isp.com/website/$userdir";
    2. supply value of $baseurl (URL for $base_dir)
        $baseurl = "http://www.isp.com/website/$userdir/";
    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
        $sendmail = '/usr/sbin/sendmail';
    5. your email
        $myemail = 'manny@jps.net';
    6. install in cgi-bin and chmod to 755

EZGUESTA.PL (add-guestbook-entry script)
    1. URL address of the guestbook ($userdir and $gbfile are evaluated at run time)
        $guestbookurl = "http://www.isp.com/website/$userdir/$gbfile.html";
    2. complete path notation to the guestbook 
        $guestbookreal = "/home/htdocs/your.isp.com/website/$userdir/$gbfile.html";
    3. supply value of $cgiurl (URL of the actual guestbook script)
        $cgiurl = "http://www.isp.com/website/cgi-bin/ezguesta.pl";
    4. where is your date command
        $date_command = "/bin/date";
    5. where is your email program
        $mailprog = '/usr/sbin/sendmail';
    6. install in cgi-bin and chmod to 755

EZPWGB.PL (lost password script for ezguest)
    1. name of the script 
        $ezpgm='EZGUEST';
    2. your name
        $myname = 'yourname';
    3. your email id
        $myemail = 'your@email.id';
    4. URL to the guestbook
        $mysiteurl = "http://www.isp.com/website/gb";
    5. path to sendmail
        $sendmail = '/usr/sbin/sendmail';
    6. path to data file (containing user's login info)
        $datafile = "/path/to/gb/datafile.txt";
    7. install in cgi-bin and chmod to 755

UPGRADING EZGUEST TO ADD CAPABILITY TO DELETE GUESTBOOK ENTRIES
if you've got your guestbook already configured, it's simple to upgrade it so it will
allow deletion of guestbook entries (by admin only).  

1. insert this line 
   $cgi='pl';

   somewhere at the start of the script (after the $win95= setting would be fine).


2. locate the build_edit_form subroutine and change

FROM THIS...

sub build_edit_form {
    ... (code not shown)

    print "Name of HTML file: <b>$pagename</b><br><br>\n";
    print "<input type=hidden name=\"pagename\" value=\"$pagename\">\n";
    &build_form_content($usrname, $email, $headline, $content, $pagename, $colorset, $gbparms);
    print "<P><input type=submit value=\"update page\">\n";
    print "</form>\n";

    print "</body></html>\n";
    }

 TO THIS...

sub build_edit_form {
    ... (code not shown)

    print "Name of HTML file: <b>$pagename</b><br><br>\n";
    print "<input type=hidden name=\"pagename\" value=\"$pagename\">\n";
    &build_form_content($usrname, $email, $headline, $content, $pagename, $colorset, $gbparms);
    print "<P><input type=submit value=\"update page\">\n";
    print "</form>\n";

# inserted code begins here
    print "<hr><form action=\"$cgiurl/ezguestd.$cgi\" method=POST>\n";
    print "<p><font face=\"Arial, Geneva\"><h2>Update Guestbook</h2></font></p>\n";
    print "Press this button to delete guestbook entries.\n";
    print "<input type=hidden name=\"userdir\" value=\"$userdir\">\n";
    print "<input type=hidden name=\"pagename\" value=\"$pagename\">\n";
    print "<input type=hidden name=\"action\" value=\"delgbitm\">\n";
    print "<P><input type=submit value=\"delete items\">\n";
    print "</form>";
# inserted code ends here

    print "</body></html>\n";
    }
----------
manny@jps.net
http://www.inet-images.com/manny
2/15/1999