My Calendar
version 1.5
------------------------------------------------
Please read everything but email me if
 you do not understand at mike@fuzzymonkey.org
Please also email me after you get it running so I can take a look :-)

This is one of the easiest scripts to get working :-)

mike@fuzzymonkey.org
jay@slushpupie.com

In this README:
-----------------------------------------------
REQUIRES
SUMMARY
FEATURES
DISTRIBUTION / LICENSE
INSTALLATION
HOW TO USE
CHANGES
TODO



REQUIRES
------------------------------------------------
1. web server (only tested on UNIX and LINUX)
2. Perl 5.00503 (may work with others)
3. your web server so execute scripts so that the scripts have
read write access to the directory containing the scripts.  Most
servers are already set up like this, otherwise install suexec. 
See the CGI Intro for more details.

SUMMARY
------------------------------------------------
My Calendar is a lightweight, easy to use web calendar that is really
easy to set.  There is also an included email script that you can have
cron run everyday to remind you of upcoming appointments.

FEATURES
------------------------------------------------
* small
* easy to set up and use
* requires nothing more than a web server with PERL

DISTRIBUTION / LICENSE
------------------------------------------------
This software is released under the GPL.  Please
see the included LICENSE file.

Copyright (C) 2001  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 the .tar.gz into your cgi-bin/ direcotry
Ungzip, untar it.
done.

For example, this is what I do:
  #ftp mycalendar.tar.gz into my www/cgi-bin/
  tar -zxvpf mycalendar.tar.gz
This creates a subdirectory in your cgi-bin/ called calendar/ with all
of the scripts needed.

2. edit title or background (optional) 

Edit sitevariales.pl to suit your needs.
There are many things that are configurable now.  Most of the colors, you
can now add a menu to the top, or a footer at the bottom.  

3. password protect the calendar/protected/ directory if you want to
limit who is able to edit the appointments/events on the callender (optional)

You can do this using .htaccess or using a web based administartion tool if it
comes your account.

4. Your done!  

Fire up your browser and point it at the index.cgi script.
(e.g. http://www.yourserver/cgi-bin/calendar/index.cgi)

Good Luck!  Email me if you use it!

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, run it from command line so that you can see what 
is going wrong.  See my CGI beginner guide on my script page for more info.

If you want it to email you automatically to remind you of your appointments,
you can edit the included email.pl with your email address and put it in your
crontab (e.g. crontab -e). 

CHANGES
------------------------------------------------
Changes by Jay Kline
* fixed add event to have 31 days
* * Made almost every color configurable in sitevaribles.pl
* * Added a seperate color for "busy" days
* * Changed date storeage format- seperator is now a \t and ##
*          This may change again...
*          * Added the ability to have a header and footer file for menu
*          systems and 
*          copyright notices
*          * Added help tips
*          * Added a "today" link to get back to today
*          * Added a full day view
*          * Changed the porportions on the full month view to fill the space
*          with the 
*          right size aspect
*          * Limit the length of a line in month view, and the nuber of lines
*          shown (go 
*          to day view to see full day)
06.12.2001
	Initial release.
10.10.01
    Updated update.pl to allow you to add events for December.  It used to
    only go up to Novemer :-P
12.17.01
   Updated the email script to work now.  Updated the convert2pscal.pl script
   to prompt for information and attempt to print the calendar for you.
1.9.2002
   fixed security holes.  Everyone update!

ToDo
--------------------------------------
I need to do/need help with the following items
1. Repeating events dosnt work at the moment
2. HTML validation for events
3. Fix up the Help screens
4. Have an idea? Let me know!

Send questions or comments to mike@fuzzymonkey.org

Thanks,
Mike Spice
mike@fuzzymonkey.org

Jay Kline
jay@slushpupie.com

