home *** CD-ROM | disk | FTP | other *** search
/ linuxmafia.com 2016 / linuxmafia.com.tar / linuxmafia.com / calendar-2010-08-23.tar.gz / calendar-2010-08-23.tar / calendar / README < prev    next >
Text File  |  2003-10-12  |  9KB  |  256 lines
  1.                  ______________________________________
  2.                 |            PHP iCalendar             |
  3.                 | http://phpicalendar.sourceforge.net/ |
  4.                 |______________________________________|
  5.  
  6. Introduction:
  7. -------------
  8. PHP iCalendar is a PHP-based iCal file viewer/parser to display iCals in a Web browser. 
  9. Its based on v2.0 of the IETF spec. It displays iCal files in a nice logical, 
  10. clean manner with day, week, month, and year navigation. It is available in 13
  11. languages and includes support for printing, searching and RSS news feeds. 
  12. If you need a Calendar applicaion, please check the 'Calendar Links' section of our website.
  13.  
  14. Contact:
  15. --------
  16. E-mail the developers and others on the list at:
  17. phpicalendar-devel@lists.sourceforge.net
  18.  
  19. Installation:
  20. -------------
  21. - Put PHP iCalendar into your Sites folder (or another web directory)
  22. - Edit the file "config.inc.php" and see section below called "Configuration"
  23. - Put your iCal files into the directory you specify in config.inc.php
  24.   (default is "calendars")
  25. - Make sure PHP is enabled (http://developer.apple.com/internet/macosx/php.html)
  26. - Turn on Web sharing (if not already on)
  27. - View calendars in your web browser
  28.   If it is in your Sites folder, the URL would be:
  29.   <http://localhost/~username/phpicalendar>
  30.  
  31. Configuration:
  32. --------------
  33. View config.inc.php. The comments behind each variable definition will
  34. tell you what each setting does. Change the values between the quotation
  35. marks to change the setting of that variable. If there are restrictions 
  36. as to what that variable can be set to, the comment behind will specify
  37. them. If you have difficulty with your configuration, you can ask the 
  38. developers and other PHP iCalendar users at the PHP iCalendar forums: 
  39. http://phpicalendar.sourceforge.net/phpBB2
  40.  
  41. Supported Calendar Applications:
  42. --------------------------------
  43. PHP iCalendar supports any calendar application that can generate
  44. valid IETF 2445 files (.ics). Some of the supported applications are:
  45.     
  46.     - Apple iCal
  47.         - http://www.apple.com/ical/
  48.     - Mozilla Calendar
  49.         - http://www.mozilla.org/projects/calendar/
  50.     - Ximian Evolution
  51.         - http://www.ximian.com/products/evolution/
  52.     - KOrganizer
  53.         - http://korganizer.kde.org/
  54.     - WinDates 5.0
  55.         - http://www.rockinsoftware.com/windates.htm
  56.  
  57. Bugs:
  58. -----
  59. If you find a bug, please let us know. The easiest way for you to do this
  60. is to visit our Bug Tracker on SourceForge. This guarantees that we both 
  61. look at it and take time to figure out what is causing it. You can submit
  62. bugs at the following URL:
  63. http://phpicalendar.sourceforge.net/bugs
  64.  
  65. Requests:
  66. ---------
  67. Got an idea? Great! Just like with Bugs, there is a Features Tracker over
  68. on SourceForge. Please use that to sumbit feature requests. That way, you can
  69. see what others have suggested so you don't duplicate requests, and it will give
  70. us a chance to keep the features that haven't been implemented in one central
  71. place that we can find later. The tracker can be found at the following URL:
  72. http://phpicalendar.sourceforge.net/requests
  73.  
  74. Licensing: 
  75. ----------
  76. This product is distributed under the GPL.  Please read through the file
  77. COPYING for more information about our license.
  78.  
  79. Older Browser Support:
  80. ----------------------
  81. Starting with 0.9.4, PHP iCalendar is moving away from supporting 4.x browsers.
  82. If you still need support for these browers, 0.9.3 is still available for
  83. download. To get the latest ical support, simply download the latest version
  84. of PHP iCalendar and replace the file called 'ical_parser.php' in the 
  85. functions folder.
  86.  
  87. Changes:
  88. --------
  89. 0.9.4
  90.     -Vastly improved BYDAY, BYMONTHDAY, BYYEARDAY support.
  91.     -Improved DURATION Support.
  92.     -Smaller HTML footprint on all pages with same look and feel.
  93.     -Combined Calendars automatically refresh when changes are made.
  94.     -Vtodo popup works again.
  95.     -Validation increased on multiple pages.
  96.     -Fixed a bug not listing blacklisted calendars.
  97.     -Moved HTML head into header.inc.php to better support embedding of calendar.
  98.     -Moved HTML foot into footer.inc.php to better support embedding of calendar.
  99.     -Specify the name of 'All Calendars Combined' in language files.
  100.  
  101. 0.9.3    
  102.     -Multiple calendar support (up to 8).
  103.     -Fixed pesky <BR> tags in event popup.
  104.     -Added Esperanto language.
  105.     -Major bug fixes.
  106.     -Last to support Netscape 4.x
  107.     
  108. 0.9.2
  109.     -Fixed an extra .php on the preferences page.
  110.     -Increased validations on many pages.
  111.     -Added support for CLASS (public, private, and confidential).
  112.     -Added support for LOCATION
  113.     -Added support for ATTENDEE
  114.     -Added support for ORGANIZER
  115.     -Added support for STATUS
  116.     -New javascript functions provide additional information.
  117.     -Added the ability to correct the servers time display
  118.     -Added admin.php for administration of calendars (uses cookies). See config.inc.php for configuration.
  119.         -Add or Update a calendar via a web interface
  120.         -Delete a calendar via a web interface
  121.  
  122. 0.9.1
  123.     -Added unset preferences
  124.     -Cookies now fall back to defaults if data is bad.
  125.     -Fixed a bug with the latest version of Ximian.
  126.     -Added the ability to hard-set cookie-uri and download-uri.
  127.     -Added Catalan and Tranditional Chinese languages.
  128.     -Back button on preferences page now works.
  129.     -Allow_Preferences option now works.
  130.  
  131. 0.9
  132.     -Added complete VTODO support.
  133.     -Added STATUS support for VEVENT and VTODO.
  134.     -Added RSS auto-detection on day, week, month, and year pages.
  135.     -Added year view icon.
  136.     -Added Finnish and Czech language support.
  137.     -Added Preferences page (uses cookies).
  138.         -Select defualt language
  139.         -Select default calendar
  140.         -Select default view
  141.         -Select default theme
  142.         -Select default start day
  143.         -Select default start time
  144.     -Print view can now be set for your default view.
  145.     -Updated silver and red styles.
  146.     -Calendars can now be stored outside of phpicalendar's installation.
  147.     -Cleaned up folders for easier installation.
  148.     -Minor interface enhancements.
  149.     -Minor bug fixes
  150.  
  151. 0.8.1
  152.     -Added header.inc.php for custom headers.
  153.     -Added Brazilian language support.
  154.     -Fixed a bug with some of the style sheets not displaying correctly.
  155.     -Fixed a bug with RSS not properly validating.
  156.     -Fixed a bug with Search returning errors on some characters.
  157.     -Brought some languages up to 0.8 translations.
  158.     -Added support for "last X in month"
  159.     -Fixed many small bugs.
  160.  
  161. 0.8
  162.     -Added search capability.
  163.     -Added a Printer Friendly view for Day, Week, and Month.
  164.     -Added support for single event changes in a recurring set.
  165.     -Added RSS feeds for Day, Week, and Month.
  166.     -Added Portugese language support.
  167.     -Added 'clickable links' for web addresses.
  168.     -Tweeked Red and Grey styles.
  169.     -Fixed a bug causing Sunday to be listed twice.
  170.     -Fixed a bug preventing < 4.1.0 php users to run app.
  171.     -Fixed a bug displaying quotes in summary.
  172.     -Fixed many other bugs (none open on SF!!)
  173.  
  174. 0.7
  175.     -Added Year view.
  176.     -New themes, Green, Orange, Grey, and Tan.
  177.     -Parses calendars much faster.
  178.     -Page titles added for bookmarking. 
  179.     -Fixed bug not letting notes to fully display.
  180.     -Fixed bug in recurring all-day events.
  181.     -Fixed a bug for showing &'s and #'s in the javascript.
  182.     -Greatly improved Mozilla Calendar support.
  183.     -Overlapping events now display better.
  184.     -Added complete timezone support (See TIMEZONE file for details).
  185.     -A new website for PHP iCalendar.
  186.     -Many bug fixes.
  187.  
  188. 0.6
  189.     -Added this README!
  190.     -Greatly improved CSS for "themes", theme SDK available.
  191.     -HTML bug fixes specific to Windows browsers
  192.     -All-day and Regular recurring event both support all types
  193.     -Bottom of month view updated
  194.     -Day, Week, Month navigation brought back.
  195.     -Localization update
  196.         -Localized dates and times work with Mac OS X as well as
  197.          other *nixes.
  198.         -Almost all text has been translated for supported languages
  199.         -Added Spanish and Swedish
  200.     -Added ability to turn off the pop-up menu calendar list
  201.     -Added "black-listing" of specific local calendars
  202.     -Added remote calendar support
  203.         -Subscribe to calendars hosted remotely and have them show 
  204.          up in your popup
  205.         -Allow any URL of a calendar to be parsed by your server
  206.     -Added custom error page for user-friendly error messages.
  207.     -Added saving of parsed files to separate files for faster processing
  208.     -Custom options for mini-calendars, this months, events
  209.     -Bug fixes
  210.  
  211. 0.5
  212.     -Improved recurring event support
  213.         -All-day and Regular recurring events now obey ending dates and counts
  214.         -Regular recurring events for monthly
  215.     -New UI
  216.         -Mini-calendars in all views
  217.         -Jump-to pop-ups for Weeks and Months
  218.         -Subscribe works properly
  219.         -Color coding on month view
  220.         -Week view colors the length of the time like day
  221.     -Support for event notes/descriptions
  222.     -More language support
  223.         -Danish
  224.         -Dutch
  225.         -Italian
  226.         -Japanese
  227.         -Norwegian
  228.     -Bug fixes
  229.     
  230. 0.4
  231.     -Improved recurring event support
  232.         -All-day recurring for all types
  233.         -Regular recurring events for daily, weekly
  234.     -Event pop-ups
  235.     -More style sheets
  236.     -Multiple language support
  237.         -English
  238.         -French
  239.         -German
  240.         -Polish
  241.     -24-hour clock support
  242.     -Bug fixes
  243.  
  244. 0.3
  245.     -Calendar list popup
  246.     -All-day yearly recurring support
  247.     -Bug fixes
  248.     
  249. 0.2
  250.     -All-day event support
  251.     -Added month and week views
  252.     -Bug fixes
  253.  
  254. 0.1
  255.     -Initial Release
  256.