path: root/README

                 ______________________________________
                |            PHP iCalendar             |
                | http://phpicalendar.sourceforge.net/ |
                |______________________________________|

Introduction:
-------------
PHP iCalendar is a PHP-based iCal file viewer/parser to display iCals in a Web browser. 
Its based on v2.0 of the IETF spec. It displays iCal files in a nice logical, 
clean manner with day, week, month, and year navigation. It is available in 13
languages and includes support for printing, searching and RSS news feeds. 
If you need a Calendar applicaion, please check the 'Calendar Links' section of our website.

Contact:
--------
E-mail the developers and others on the list at:
phpicalendar-devel@lists.sourceforge.net

Installation:
-------------
- Put PHP iCalendar into your Sites folder (or another web directory)
- Edit the file "config.inc.php" and see section below called "Configuration"
- Put your iCal files into the directory you specify in config.inc.php
  (default is "calendars")
- Make sure PHP is enabled (http://developer.apple.com/internet/macosx/php.html)
- Turn on Web sharing (if not already on)
- View calendars in your web browser
  If it is in your Sites folder, the URL would be:
  <http://localhost/~username/phpicalendar>

Configuration:
--------------
View config.inc.php. The comments behind each variable definition will
tell you what each setting does. Change the values between the quotation
marks to change the setting of that variable. If there are restrictions 
as to what that variable can be set to, the comment behind will specify
them. If you have difficulty with your configuration, you can ask the 
developers and other PHP iCalendar users at the PHP iCalendar forums: 
http://phpicalendar.sourceforge.net/phpBB2

Bugs:
-----
If you find a bug, please let us know. The easiest way for you to do this
is to visit our Bug Tracker on SourceForge. This guarantees that we both 
look at it and take time to figure out what is causing it. You can submit
bugs at the following URL:
http://phpicalendar.sourceforge.net/bugs

Requests:
---------
Got an idea? Great! Just like with Bugs, there is a Features Tracker over
on SourceForge. Please use that to sumbit feature requests. That way, you can
see what others have suggested so you don't duplicate requests, and it will give
us a chance to keep the features that haven't been implemented in one central
place that we can find later. The tracker can be found at the following URL:
http://phpicalendar.sourceforge.net/requests

Licensing: 
----------
This product is distributed under the GPL.  Please read through the file
COPYING for more information about our license.

Changes:
--------
0.9
	-Added VTODO support
	-Added STATUS support for VEVENT and VTODO
	-Added Preferences page (uses cookies).
		-Select defualt language
		-Select default calendar
		-Select default view
		-Select default theme
		-Select default start day
		-Select default start time
		-Upload new calendars (ftp)
	-Print view can now be set for your default view.
	-Calendars can now be store outside of phpicalendar's installation.
	-Minor bug fixes

0.8.1
	-Added header.inc.php for custom headers.
	-Added Brazilian language support.
	-Fixed a bug with some of the style sheets not displaying correctly.
	-Fixed a bug with RSS not properly validating.
	-Fixed a bug with Search returning errors on some characters.
	-Brought some languages up to 0.8 translations.
	-Added support for "last X in month"
	-Fixed many small bugs.

0.8
	-Added search capability.
	-Added a Printer Friendly view for Day, Week, and Month.
	-Added support for single event changes in a recurring set.
	-Added RSS feeds for Day, Week, and Month.
	-Added Portugese language support.
	-Added 'clickable links' for web addresses.
	-Tweeked Red and Grey styles.
	-Fixed a bug causing Sunday to be listed twice.
	-Fixed a bug preventing < 4.1.0 php users to run app.
	-Fixed a bug displaying quotes in summary.
	-Fixed many other bugs (none open on SF!!)

0.7
	-Added Year view.
	-New themes, Green, Orange, Grey, and Tan.
	-Parses calendars much faster.
	-Page titles added for bookmarking. 
	-Fixed bug not letting notes to fully display.
	-Fixed bug in recurring all-day events.
	-Fixed a bug for showing &'s and #'s in the javascript.
	-Greatly improved Mozilla Calendar support.
	-Overlapping events now display better.
	-Added complete timezone support (See TIMEZONE file for details).
	-A new website for PHP iCalendar.
	-Many bug fixes.

0.6
	-Added this README!
    -Greatly improved CSS for "themes", theme SDK available.
    -HTML bug fixes specific to Windows browsers
    -All-day and Regular recurring event both support all types
    -Bottom of month view updated
    -Day, Week, Month navigation brought back.
    -Localization update
    	-Localized dates and times work with Mac OS X as well as
    	 other *nixes.
    	-Almost all text has been translated for supported languages
    	-Added Spanish and Swedish
    -Added ability to turn off the pop-up menu calendar list
    -Added "black-listing" of specific local calendars
    -Added remote calendar support
        -Subscribe to calendars hosted remotely and have them show 
         up in your popup
        -Allow any URL of a calendar to be parsed by your server
    -Added custom error page for user-friendly error messages.
    -Added saving of parsed files to separate files for faster processing
    -Custom options for mini-calendars, this months, events
    -Bug fixes

0.5
    -Improved recurring event support
        -All-day and Regular recurring events now obey ending dates and counts
        -Regular recurring events for monthly
    -New UI
        -Mini-calendars in all views
        -Jump-to pop-ups for Weeks and Months
        -Subscribe works properly
        -Color coding on month view
        -Week view colors the length of the time like day
    -Support for event notes/descriptions
    -More language support
        -Danish
        -Dutch
        -Italian
        -Japanese
        -Norwegian
    -Bug fixes
    
0.4
    -Improved recurring event support
        -All-day recurring for all types
        -Regular recurring events for daily, weekly
    -Event pop-ups
    -More style sheets
    -Multiple language support
        -English
        -French
        -German
        -Polish
    -24-hour clock support
    -Bug fixes

0.3
    -Calendar list popup
    -All-day yearly recurring support
    -Bug fixes
    
0.2
    -All-day event support
    -Added month and week views
    -Bug fixes

0.1
    -Initial Release