EZNEWSPG - easy newspage maker, by manny juan 2/23/2001

EZNEWSPG 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 newspages in a subdirectory called 'newscrol'.
        note: each newspage will be a subdirectory beneath 'newscrol'.

then you should do the following:

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

MJMALL.JPG      - keep in 'newscrol', logo for ez newspage maker
NOTEPAPER.JPG   - keep in 'newscrol', available image choice for background
DIFF_FUNCTION.JS - keep in 'newscrol', required javascript subroutines

BACKGROUND1.GIF - keep in 'newscrol', available image choice for background

EZNEWSPG.PL (easy newscrol page 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 four random letters and/or numbers to become the "gSalt" for the 
        crypt function. you will also need this in newscroll.cgi
                $gSalt = "a1Mj";
        3. you might not need to change this: is your server win95? (my win95 server
        cannot handle file locking, so i set this to 1)
                $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 newspages will reside
                $basedir = "/home/htdocs/your.isp.com/website/newscrol";
        6. URL of the directory where the newspages will be stored
                $baseurl = "http://www.isp.com/website/newscrol";
        7. what is the complete path of the index list of newspages? (not normally changed)
                $indexpage = "$basedir/index.html";
        8. what is the complete path of the user list? (not normally changed, 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

NEWSCROLLER.CGI (news scrolling engine)
        1. make sure first line of script points to location of perl program
        2. you might not need to change this: is your server win95? (my win95 server
        cannot handle file locking, so i set this to 1)
                $win95 = 0;
        3. supply the full path to the directory where the newspages will reside
                $basedir = "/home/htdocs/your.isp.com/website/newscrol";
        4. URL of the directory where the newspages will be stored
                $baseurl = "http://www.isp.com/website/newscrol";
        5. supply value of $cgiurl (URL of the directory where cgi scripts reside)
                $cgiurl = "http://www.isp.com/website/cgi-bin";
        6. set the randomizer "salt" (ie. seed) that was defined in eznewspg.pl
                $gSalt = "a1Mj";
        7. update the list of backgrounds if necessary
                @bkgd=split(",","background1.gif,notepaper.jpg");
        8. install this script in cgi-bin and chmod to 755

ADMINISTRATION
--------------
a new index.html page is created for every newspage created which features a working demo
of the newspage and also offers an option for updating the news.  select this option for
doing administration tasks.  a button is also provided (marked Show HMTL) to display the
HTML needed for installing the newspage scroller to your site.

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 eznewspg.pl and newscroller.cgi scripts.

CREDITS
-------
NOTE: EZNEWSPG was written by lawrence lam (mail@upoint.net) from UPOINT dotNET 
(www.upoint.net/cgiscripts.updn) and he retains full copyright to newscroller.cgi.
please respect these copyrights.  please do not remove any name and/or links to 
newscroller.cgi and/or UPOINT dotNET.

thank you.

----------
manny@jps.net
http://mannyjuan.com
2/23/2001
