EZCALEND - easy calendar generator, by manny juan 3/15/2000 EZCALEND INSTALLATION INSTRUCTIONS ---------------------------------- unzip ezcalend.zip with restore-directory option 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 calendars in a subdirectory called 'calend' the ideal set up for ezcalend consists of the following: 1. a WEB ACCESSIBLE directory to contain the index (ie. index.html) of calendars eg. path= /home/htdocs/your.isp.com/website/calend URL= http://www.isp.com/website/calend 2. a NON WEB-ACCESSIBLE directory to contain the calendar data. as its name implies, this directory should not be accessible from the web. the files in this directory contain login information, administration passwords and user lists and should be secure from curious eyes and should not be readable (or downloadable) simply by typing a URL on a browser! eg. path= /home/nonhtdocs/calend if it is not possible to obtain such a directory, then you should create a subdirectory TWO levels beneath your home base eg. path= /home/htdocs/your.isp.com/website/SECRET/calend where the first level (SECRET) is a name only you should know and should not reveal to anyone. then you should do the following: SETUP 1. in the example above, 'calend' will become the value of variable '$userdir' 2. create the subdirectory 'calend' under the respective NON-WEB parent directory and chmod to 777 3. create subdirectory 'calend' under the WEB parent directory and chmod to 777. 4. install the images subdirectory (and contents) under the WEB ACCESSIBLE 'calend' directory and chmod the images subdirectory to 777 5. copy the logo, mjmall.jpg into the WEB ACCESSIBLE 'calend' 6. copy the color scheme graphic, ezpalette.gif into the WEB ACCESSIBLE 'calend' INDEX.HTML 1. supply correct URL for the logo (ie. IMG SRC=http://www.isp.com/website/mjmall.jpg) 2. supply correct URL for the cgi script. for example:
3. supply the correct value for userdir for 'new page' button. for example, 4. do above two more times for the 'edit page' and 'delete page' buttons. 5. keep the and lines in the page. DO NOT REMOVE! 6. install in 'WEB calend' and chmod to 777 DATA.TXT (SEE NOTE BELOW) 1. (initially empty) 2. install in the NON WEB-ACCESSIBLE 'calend' and chmod to 777 EZCALEND.PL (calendar 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 $cgiurl (URL of the directory where cgi scripts reside) $cgiurl = "http://www.isp.com/website/cgi-bin"; 4. supply value of $base_dir (complete path, not URL, to the NON WEB-ACCESSIBLE directory) $base_dir = "/home/nonhtdocs/$userdir"; 5. supply value of $data (the full path, not URL, to the NON-WEB-ACCESSIBLE login file. you should rename this file. see more notes below regarding the use of this file) $data = "$base_dir/data.txt"; 6. supply value of $imageurl (web accessible URL where the logo and color scheme file are kept) $imageurl="http://www.isp.com/website/$userdir"; 7. supply value of $indexurl (web accessible URL to access the index of calendars) $indexurl="http://www.isp.com/website/$userdir"; 8. supply value of $indexpage (web accessible path equivalent to above) $indexpage="/home/htdocs/your.isp.com/website/$userdir/index.html"; 9. where is your email program $sendmail = '/usr/sbin/sendmail'; 10. your email $myemail = 'yourid@your.isp.com'; 11. install this script in cgi-bin and chmod to 755 CALENDAR_CONFIG.PM 1. supply value of $base (path to the NON WEB-ACCESSIBLE base) $base = "/home/nonhtdocs"; 2. where do the cgi scripts reside (URL to cgi scripts) $cgi_dir = "http://www.isp.com/website/cgi-bin"; 3. supply the suffix for calendar data files (ie. file extension) $DATA_FILE_SUFFIX = ".txt"; 4. supply the URL for the index of calendars $indexurl="http://www.isp.com/website/$userdir"; 5. supply the URL for the images associated with calendar (keep trailing slash!) $IMAGE_DIRECTORY = "http://www.isp.com/website/$userdir/images/"; CALENDAR_UTIL.PM 1. (no change needed) 2. upload to cgi-bin and chmod to 755 CALENDAR.PL 1. make sure first line of script points to location of perl program #!/usr/bin/perl 2. upload to cgi-bin and chmod to 755 CALENDAR_DAY.PL 1. make sure first line of script points to location of perl program #!/usr/bin/perl 2. upload to cgi-bin and chmod to 755 CALENDAR_ADDEDITDELETE.PL 1. make sure first line of script points to location of perl program #!/usr/bin/perl 2. upload to cgi-bin and chmod to 755 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 ezcalend script. the following scripts are the property of david lozinski of lozinski calendars (http://www.davelozinski.com/scripts/calendar/calendar.html) and should not be modified except for variable definitions needed for setup configuration. calendar_config.pm calendar_util.pm calendar.pl calendar_day.pl calendar_addeditdelete.pl ---------- manny@jps.net http://www.inet-images.com/manny 3/15/2000