My Calendar README

My Calendar 2.7

Please read everything but email me if
(1) you do not understand
(2) you get it running (so I can check it out and put up a link to your site)
at support@fuzzymonkey.net
Many thanks to Jay Kline (jay@slushpupie.com) and his many bug fixes and layout help!

In this README:

> REQUIRES
> SUMMARY
> FEATURES
> DISTRIBUTION / LICENSE
> INSTALLATION
> HOW TO USE
> CHANGES
> TODO

REQUIRES

> - 1. web server (tested on apache Linux/Unix but reported to work on Windows NT/2000)
> - 2. Perl 5.00503 or later (may work with others)
> - 3. cal is required but already installed on just about every server.
> - 4. pscal is required for making printable calendars in postscript format.

SUMMARY

My Calendar is a lightweight, easy-to-use Web calendar that is a breeze to install and customize using CSS. There is also an included email script that you can have cron run everyday to remind you of upcoming appointments. My Calendar can also use pscal to create very pretty postscript and Adobe Acrobat PDF versions of your calendar for printing. For those stuck using Microsoft Outlook, you can import your Outlook stuff into MyCalendar.

FEATURES

> - lightweight and easy to setup
> - email scrip to remind you of upcomming events
> - email script can be run by cron and/or used to send emails to a mailing list for clugs and organizations
> - easily generated pretty printable versiosn in postscript and PDF
> - import events from Microsoft Outlook.
> - easily customizeable with CSS and templating.

DISTRIBUTION / LICENSE

> This software is released under the GPL. Please see the included LICENSE file. Copyright (C) 2002 Michael Spiceland This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Use this script at your own risk! I make no warranties that it is hack proof!

INSTALLATION

> 1. Install scripts
> ftp mycalendar-xxx.tar.gz to your cgi-bin/ directory on your server
> $ tar -zxvpf mycalendar-xxx.tar.gz
> this will create a calendar/ directory in that directory
> 2. edit template.html to match your site
> To customize the look, simply edit template.html. This file can be created with any html editor or text editor as long as it retains the hidden HTML comment, <!-- content --> . This comment is where the content (calendar) will be placed.
> 3. password protect protected/ directory
> Use htaccess or some other method to password protect the protected/ dirctory. Doing this will require your users to supply a password if they ever attempt to edit any events.
> 4. Move calendar.css to an html servable location, and specify it in sitevariables.pl.

HOW TO USE

> Just point your browser at it

> e.g.- http://www.yoursite.com/cgi-bin/calendar/index.cgi

> If you get an internal server error, check your web server error logs or run it from command line so that you can see what is going wrong. See my docs/FAQ.html on my script page for more info.

CHANGES

02.19.2006 | version 2.7 | Added CSS formatting, fixed some bugs, cleaned some code, entire code rewrite coming soon.
09.06.2003 | version 2.6 | Added Outlook (.csv) import capability. Added blank appointments.txt file to distrobution since some folks's servers weren't making them. Changed some default colors to be a bit more slick looking. Cleaned up some error checking code.
06.16.2003 | version 2.5 | Added ability to generate pritable calendars by interfacing pscal and ps2pdf.
06.14.2003 | version 2.0 | Code rewritten to be cleaner.
06.14.2003 | version 1.9 | Added montly and yearly option for appointments. These appointments appear every year and month. The index.cgi, update.cgi, and email.pl scripts were all updated.
01.09.2002 | version 1.8 | Bugfixes.
03.06.2003 | version 1.7 | Changed the format for the data storage and wrote conversion script to convert to the new format. This is in preparation for the new PalmOS conduit. Several bug fixes.
01.09.2002 | version 1.6 | Bugfixes.
01.09.2002 | version 1.5 | Security Fix.
12.17.2001 | version 1.4 | Bugfixes.
12.17.2001 | version 1.3 | Fixed bugs with email script and convert2pscal.pl
10.10.2001 | version 1.2 | Fixed bug with adding events for December
06.12.2001 | version 1.0 | Initial release.

TODO

> I need to do/need help with the following items
> NONE YET. Email me with bugs.

Send questions or comments to support@fuzzymonkey.net
Thanks,
Michael and Erin
FuzzyMonkey scripting wizards