EZGIFTPG - easy gift page generator, by manny juan 3/20/2001

EZGIFTPG 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 gift pages in a subdirectory called 'gifts'.
        note: each gift page will be a subdirectory beneath 'gifts'.

then you should do the following:

SETUP
        1. create the subdirectory 'gifts' under the home base directory and chmod to 777
        2. unzip ezgiftpg into this directory
        3. ezgiftpg.pl and ezgiftvu.pl 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/gifts/mjmall.jpg)
        2. supply correct URL for the cgi script.  for example:
                <form action="http://www.isp.com/website/cgi-bin/ezgiftpg.pl" method="POST">
        3. do above two more times for the 'edit gift page' and 'delete gift page'
        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 'gifts' and chmod to 777

EZPALETTE.GIF   - keep in 'gifts', color scheme selection graphic
MJMALL.JPG      - keep in 'gifts', logo for ez gift page generator

EZGIFTPG.PL (easy gift page 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. come with four random letters and/or numbers to become the "gSalt" for the 
        crypt function. you will also need this in ezgiftvu.pl
                $gSalt = "a1Mj";
        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 gift pages will reside
                $basedir = "/home/htdocs/your.isp.com/website/gifts";
        6. URL of the directory where the gift pages will be stored
                $baseurl = "http://www.isp.com/website/gifts";
        7. what is the complete path of the index list of gift pages? (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

EZGIFTVU.PL (the gift page engine)
        1. make sure first line of script points to location of perl program
                #!/usr/bin/perl
        2. you might not need to change this: is your server win95? (my win95 server
        cannot handle file locking)
                $win95 = 0;
        3. supply value of $cgiurl (URL of the directory where cgi scripts reside)
                $cgiurl = "http://www.isp.com/website/cgi-bin";
        4. supply the full path to the directory where the gift pages will reside
                $basedir = "/home/htdocs/your.isp.com/website/gifts";
        5. URL of the directory where the gift pages will be stored
                $baseurl = "http://www.isp.com/website/gifts";
        6. what is the full name of your gift page service?
                $gName = "EZ Gift Page";
        7. give a short name (nickname) of your gift page service?
                $gShortName = "Gift Page";
        8. what is the URL needed to call the script (not just the cgi-bin url)
                $gForm = "$cgiurl/ezgiftvu.pl";
        9. what is the path to the list of users? (same as $data in ezgiftpg script)
                $users = "$basedir/data.txt";
        10. if your system supports crypt, set this to 1.  do NOT change after the system
        is working
                $gCrypt = 1;
        11. repeat the "salt" you used in ezgiftpg script here
                $gSalt = "a1Mj";
        12. install this script in cgi-bin and chmod to 755

LICENSE.TXT - keep in 'gifts' , it's the GPL license in full

ADMINISTRATION
--------------
after the gift page is created, the owner can administer it by clicking on the 
appropriate link in the index listing then by supplying the correct password.  
only the owner can add and/or delete gift items.  

a complete URL is always available from the administration page that may be distributed
(use cut and paste only!) to the owner's friends and relatives.  (this link should not
be posted in a public place to prevent unauthorized and probably false claims of gifts).

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 ezgiftpg.pl and ezgiftvu.pl scripts.

NOTE: EZGIFTPG was written by Matt Riffle as dreamlist.pl and may be downloaded from
his site at http://www.pingpackets.com - the script is released under the GPL license and
therefore EZGIFTPG is also released under the same conditions.  please respect these 
copyrights.  please do not remove any of the links and copyright information from any of 
the scripts or from the generated pages.

thank you.

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