FrameCal - Revision History

F R A M E C A L

Welcome to the revision history page for the FrameCal Perl script. This page will outline the changes made to the script under each revision.

VERSION 2.1.1 - RELEASED 12 DEC 98

This is a minor update to add the following.

The modify event subroutine was getting a bit too complicated to handle via an array, so changed it completely to use variables. This also increases the robustness of the code in regards to modifications, and taking care of special circumstances such as adding additional people to notify and switching from an all day event to a timed event and vice versa.

VERSION 2.1 - RELEASED 06 DEC 98

This is a minor update to add the following.

	Now, when a duration value of 0 is entered for minutes and hours, the event is treated as an informational only event, applicable to the whole day, and will be sorted and displayed at the top of each day's view.
	Each event will now display the last time it was updated in its information. The time displayed will be the server's time, with the option to put in an offset if your server is in a different time zone than your office.
	The search results page no longer links with the subject for viewing the details of an event. It was brought to my attention that some people were using the subject of the event as a link to further information regarding the event, and these two links were conflicting.

VERSION 2.0.2 - RELEASED 01 DEC 98

This is a minor update to add the following.

	The display of the details for an event was in the script in three different places, so it was converted to a separate subroutine. Thus, if you need to modify your format, you need only modify it in one place.
	The display of the time for an event is now displayed as one date range, rather than two separate values, start and end.
	For printing out the javascript in the header, was using qq##; to delimit the printed text. Converted back to using qq!!;, and escaped the ! in the comment.
	Changed "AM" and "PM" to "am" and "pm" in calendar.setup.

VERSION 2.0.1 - RELEASED 30 NOV 98

This is a minor bug fix after the release of 2.00. The following bugs were fixed.

	When modifying a file, the wrong id number was being passed.
	For notifications on deletion of an event, the information on the event wasn't called if there were no users to notify but the administrator wanted the notification.

VERSION 2.0 - RELEASED 28 NOV 98

This is a major revision of the script, virtually a complete rewrite. Many new features were added. See below for details.

	The number of "require" files has been reduced. Since only two functions were being used in date.pl, they were moved into the main script. Also, one of the auth scripts, that contained only one function, was moved into the auth file that called it.
	Cookies have been implemented for guest logins, as an option. If turned on by the administrator, users will be prompted if they would like to save their login information. If they choose to, the values will be stored in a cookie, and read in automatically when they return, bypassing the login screen. To facilitate this, the cookie library from Matt's Script Archive was utilized.
	The current day is now hilited with a different color using the $tdycol variable.
	The user help script was modified to provide better customization. The help .txt files were also modified, and help topics were added for the new features.
	The calendar.events file is now gone. In its place, an events file will be automatically generated by the script for each year/month combination, when events are added. The file will take the format of yyyymm.events.
	The .events files now contain only base information, namely, that used to generate the month view. All other information about an event is stored in a separate text file named after the id number of the event. These files are read to display the event information.
	Old events are now trimmed automatically by setting a value in the initial query string and setting a variable for the number of past months to keep. See installation documentation for details.
	Multiple events can now be deleted at one time.
	Option to allow users to include a link to another web site for information on an event. These links are formatted to open a new browser automatically, to avoid frame hijacking.
	Option to strip HTML out of event posts.
	Option to notify registered users of changes to the calendar, i.e., addition, deletion, or modification of events.
	Addition of a mini-search engine to allow users to search for events that meet user defined criteria.
	Addition of admin features to prevent users from gaining direct access to the calendar upon registration. Users can be placed in an alternate user file while awaiting approval. The administrator can then upgrade to full user status or delete them from within the script.
	Removal of admin features from main script, and creation of an admin script, since the majority of the interactions with the calendar should not involve the administrator.
	Fixes for all known bugs in the program.
	Numerous code optimizations to improve script performance.
	Increased modularization of the code, with many actions off-loaded to subroutines.
	Display of end time for an event as a time, rather than just a duration in hours.
	Option to use or not use time zones in the calendar.
	The authorization script variables are now in their own file, auth.setup.
	Modifications to allow Taint Checking for increased security.
	During registration, if emailing is not allowed, and generation of passwords is set, the user will now get their password via display on the screen.

VERSION 1.1a - RELEASED 14 JUL 98

This is a minor update to modify how the month view is generated, to quicken response time, and to also provide better, clearer information on the events for the month.

	An index is now made for the events of a given month. Thus, the events database file only needs to be read once through, and a running total of the events for each day is kept.
	The number of events for a day are displayed in each cell of the calendar that has events.
	The variable $evntcol was added to the setup file, which will be used as the color to use as the background color for cells that have events, to make them stand out better on the page.

VERSION 1.1 - RELEASED 27 JUN 98

This is a minor update to add a little functionality and clean up the script a little bit.

	Converted printing out of the help link on each page to a subroutine.
	Changed sort routine to sort by year, then month, then day, then time, which also eliminates the need for the $field_num_time variable, and so removed it from the setup file. Also, since the sort routine is called twice in the calendar, I made it into a subroutine.
	Standardized on using the CgiDie subroutine. There were a couple of instances where the open_error subroutine was used instead.
	Went through the script and added in close commands for files that were not closed after just a read in the script. This is probably not a big concern, since Perl should take care of this, but wanted to make sure if running on a Windows system, since it is a little tempermental.
	Added a View Month link to the calendar view. This link will display all of the events, in chronological order, for the currently viewed month. This was a user request a while back, before I setup the site, and I finally got around to incorporating it. The limiting factor was sorting the events database properly, which was also accomplished in this version.

VERSION 1.0 - RELEASED 19 JUN 98

This is the first release, containing the modifications from the script by Selena Sol. The following changes were made:

	Creation of a setup file for each calendar, allowing user to run several different calendars, all off of the main script, with each having a different appearance.
	Addition of Next and Previous month links on top of calendar for easy navigation.
	With the use of frames, eliminated the subject listing in the cells of the calendar, instead making only those days with events posted links in the main calendar view.
	Since only days with events are links, added the "Add Event" button to below the month view calendar, for addition on any day.
	Since events are added without a day specified after selecting the "Add Event" button, an error checking routine was added to make sure users could not post an event on, say February 30.
	Different buttons are shown in the month frame dependent upon user access level. Also, text is added to personalize a greeting to the user, display the access level to the user, and provide contact links to the calendar administrator.
	Added fields for more information on an event, including time zone, location, and duration of the event.
	Added regular expressions to eliminate any possible image tags being inserted in an event, and to remove any server side includes.
	Added variables to notify the calendar administrator of events being added to the calendar.
	Added administrative routine for calendar administrator to view all registered users on the calendar, change their access level, or delete them from the calendar. Each operation can be done for multiple users at one time.
	Added "public access" button to the login screen, so people can access the calendar without logging in on a read only basis.
	Of course, setup everything to run from a frame based page, with month view and administrative functions accessed from one frame, and event viewing an all interaction forms in another.
	Added numerous variables to customize the look of the calendar, with background and all body tag information, and special colors for heading, events, etc.
	Modified delete and modify event views so the event fits on one screen. Eliminated unnecessary fields in the table, concatenated the date and time into one field, and generally just made them more aesthetically pleasing.