EZCALEND - easy calendar generator, by manny juan 3/15/2000
Revised by Gregory Swofford 03/15/2001

EZCALEND INSTALLATION INSTRUCTIONS
----------------------------------
SETUP
        1. Upload ezcal.tar to /home/computer/www/cgi-local (see below).

	2.issue command 'tar xvpf ezcalend.tar' at the Linix ou UNIX command prompt
		where:	-x extract the named files
			-v verbose
			-p preserve file userid, groupid, file mode, access/mod times
		This will create all the /www directorie as below and write all the files
		with their proper permissions, etc.
	   
        3. Create directory /data and issue 'chmod 777 data' from above directory
		(in /home/computer).

	4. Create directory /data/calend and issue 'chmod 777 calend from above directory
		(in /home/computer/data).
		Upload:	data.txt (0777) (Create an empty text file)
			index.cgi (anti-hacker script) (0755)
			ani_skl.gif (image for index.cgi)

	
	5. Configure each file as detailed below.

        Directory Structure:

	/home/computer
		|
		|_____/www (WEB ACCESSIBLE directory)
		|	|
		|	|________/cgi-local (put ezcal.tar here)
		|			|
		|			|___/excal			
		|				|
		|				|_____/images
		|				|
		|			calendar_config.pm (0755)
		|			calendar_banner.pm (0755)
		|			calendar.cgi (755)
		|			calendar_day.cgi (0755)
		|			calendar_addeditdelete.cgi (0755)
		|			ezcalend.cgi (0755)
		|			index.html (0777)
		|			ad_index.html
		|
		|_____/data (0777) (NON WEB-ACCESSIBLE directory)
			|
			|________/calend (0777)
				     |
				     |
				data.txt (0777)
				index.cgi (anti-hacker script) (0755)
				ani_skl.gif (image for index.cgi)
				     |
				(calendar cfg files and data)
				(two files for each calendar)
				(created by scripts)
				     |
				i.e. your.cfg
				i.e. your_2001.txt


INDEX.CGI
	1. This is an anti-hacker script that records environmentals and emails
	a report to the webmaster

INDEX.HTML
	The script writes a list of calendars to this page.
        1. keep the <!--begin--> and <!--end--> lines in the page. DO NOT REMOVE!
        2. install in 'root' of cgi-local/ezcal and chmod to 777

AD_INDEX.HTML
	EZCALEND.CGI is called from this page with a form to ADD|edit|delete calendars.
        1. supply correct URL for the logo 
                (ie. IMG SRC=http://www.web-store.net/cgi-local/ezcal/mjmall.jpg)
        2. supply correct URL for the cgi script.  for example:
                <form action="http://www.web-store.net/cgi-local/ezcal/ezcalend.cgi" method="POST">
        3. do above two more times for the 'edit page' and 'delete page' buttons.

DATA.TXT (SEE NOTE BELOW)
        1. Create an empty text file (initially empty)
        2. Install in the NON WEB-ACCESSIBLE directory 'calend' (0777)
	Below is a sample data.txt (delimited by &&) :

	becci&&becci@web-store.net&&rebecca
	becci&&becci@web-store.net&&becci
	admin&&starsblue@yahoo.com&&rebecca
	admin&&webmaster@milwaukeefood.com&&milwaukeefood

	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.


EZCALEND.CGI (calendar generator script)
	1. configured in  CALENDAR_CONFIG.PM
        2. upload to cgi-local/ezcal and chmod to 755

CALENDAR_BANNER.PM
	1. configured in  CALENDAR_CONFIG.PM
        2. upload to cgi-local/ezcal and chmod to 755

CALENDAR_CONFIG.PM
	1. This is where MOST of the configuration is done.
	Good documentation is in this file to help you.

CALENDAR.CGI
	1. configured in  CALENDAR_CONFIG.PM
        2. upload to cgi-local/ezcal and chmod to 755

CALENDAR_DAY.CGI
	1. configured in  CALENDAR_CONFIG.PM
        2. upload to cgi-local/ezcal and chmod to 755

CALENDAR_ADDEDITDELETE.CGI
	1. configured in  CALENDAR_CONFIG.PM
        2. upload to cgi-local/ezcal and chmod to 755


The following scripts are the property of david lozinski of lozinski calendars
(http://www.davelozinski.com/scripts/calendar/calendar.html)
    calendar_config.pm
    calendar_util.pm
    calendar.pl
    calendar_day.pl
    calendar_addeditdelete.pl

The script write a configuration file for each calendar.
Below is a sample (rebecca.cfg)  (delimited by &&) :
	Rebecca's Community Calendar&&
	Rebecca Olsen&&
	http://web-store.net/cgi-local/ezcal&&
	starsblue@yahoo.com&&
	FFFFFF~000000~0000FF~FF0000&&
	&&
	1861M:6XF)F)E8V-I+&=R96<`

The script also write a database of events:
Below is a sample (rebecca_2001.txt) :

	20010301|TEST|TEST|%861M:6X`
	20010312|TEST|TEST|%861M:6X`
	20010201|Second Test|second|%861M:6X`
	20010228|Second Test|second|%861M:6X`
	20010301|second|second|%861M:6X`
	20010308|second|second|%861M:6X`
	20010315|second|second|%861M:6X`
	20010322|second|second|%861M:6X`
	20010329|second|second|%861M:6X`
	20010303|third|third|%861M:6X`
	20010301|THIRD|THIRD|%861M:6X`
	20010301|4th|4th|%861M:6X`
	20010308|4th|4th|%861M:6X`
	20010301|Fourth|This is the forth|%861M:6X`
	20010303|Fourth|This is the forth|%861M:6X`
	20010310|Fourth|This is the forth|%861M:6X`
	20010317|Fourth|This is the forth|%861M:6X`
	20010324|Fourth|This is the forth|%861M:6X`
	20010331|Fourth|This is the forth|%861M:6X`

Administration notes:
To get to administrative calendars use URL in the form:
http://www.web-store.net/cgi-local/ezcal/calendar.cgi?userdir=calend&dept=rebecca&weekends=1&admin=1 
where dept=rebecca is your calendar.
Also add &admin=1 to the URL. 
This variable controls whether or not the fields that allow a user to
edit the calendar are displayed by default to any user who views the
calendar(s).
If you set this value to zero (no), then you need to provide
a separate URL to the people who have permissions to edit each
calendar. That URL should look similar to:
http://www.web-store.net/cgi-local/ezcal/calendar.cgi?userdir=calend&dept=rebecca&weekends=1&admin=1
Add: &admin=1 to the URL
0 means "No"
1 means "Yes"

HELP for: Adding|Editing|Deleting an event.
Adding an Event:
Enter your userID in the space indicated. Only authorized users can delete events! 
Type a heading in the Heading: field for your event. This will appear on the calendar.
The heading can be no longer than what will fit in the heading field!
Type the details of your event in the Description: field. 
Check the days in the current month you wish to have your event added to. 
Note that the day you clicked on to view more details is defaultly selected! 
If you wish to have your heading link to another file/site with additional information, 
type in the correct URL in the Heading Link field. 
To have a graphic displayed in front of your heading, type in the graphic's correct 
URL in the Heading Image field. The graphic should be small in size so it doesn't 
terribly distort the main calendar view! 
If you would like to have an image displayed with your description, type in the 
image's URL in the Description Image field. 
Click the "Update the Calendar" button to add your event.


Editing an Event:
Enter your userID in the space indicated. Only authorized users can delete events! 
Click on the "Edit" button next to the event you wish to edit. 
The contents will then appear in the Heading: and Description: fields for editing. 
Here you may make the necessary changes. 
If you have any values in the Heading Link, Heading Image, or Description Image fields, 
you may edit them at this time. 
Check the days in the current month you wish to have your event edited. If you select 
a day in which the event does not appear, no changes will be made to that day. Note 
that the day you clicked on to view more details is defaultly selected! 
Click on the "Update the Selected Calendars!" button when finished, or click the "Reset" 
button to cancel your changes. Note that if you do not see changes made, it's most 
likely because you did not enter the event. You can only edit events you originally 
added to the calendar! 


Deleting an Event:
Enter your userID in the space indicated. Only authorized users can delete events! 
Click on the "Delete" button (disabled) next to the event you wish to edit. The 
contents will then appear in the Heading: and Description: fields. Note that you 
cannot edit these values! 
Check the days in the current month you wish to have your event deleted from. If 
you select a day in which the event does not appear, no changes will be made to 
that day. Note that the day you clicked on to view more details is defaultly selected! 
Click on the "Update the Selected Calendars!" button when finished, or click the 
"Reset" button to cancel your changes. Note that if you do not see changes made, 
it's most likely because you did not enter the event. You can only delete events 
you originally added to the calendar!
At the completion of these steps, the calendar should automatically reload, showing 
the latest changes. If not, click the "reload" button in the browser window.