FlatCalendar eXtremely Perfect

FlatCalendarXP is arguably the most powerful and configurable JavaScript calendar available. There are very few, if any, things that other JavaScript calendars can do that FlatCalendarXP can not. Simply put with a cliche, it lets you get far more done in far less time.

And the way we name it XP not only because it's perfect, but also because it's designed to be extremely perfect.

Installation Guide

To install, simply extract the zip package to any directory on your hard drive, say c:\calendar.

• The fastest way to test is to using your browser to open the Demos.htm, where you may find many live examples.
• To get to know the insight, please open the Tutorials.htm in any browser, and
• Read "HelloWorld - the beginner's guide" tutorial carefully for how to use the calendar tags on your page.
• Read "Working with themes" tutorial for how to choose and setup a theme for the calendar, as well as how to customize theme options like date range and color.
• Read "Setting up agendas & holidays" if you want to have events shown on the calendar or get events from a backend DB.
• Read other tutorials for localization, internationalization and making your own plugins.

Features

• Written in 100% JavaScript, no installation process needed on the client side.
• Support all major browsers on Windows, MacOS, Linux and Solaris.
• Calendar look is extremely customizable and can be switched among different themes.
• Lightweight and high-performance, main engine is only around 20KB in size.
• Various fascinating effects to highlight selected date, today, agendas and holidays.
• Sophisticated dynamic date range support, visually strike-out any disabled date.
• Retrieving agendas from either script file or backend database.
• Contextual agenda messages in status-bar and/or tooltips.
• Decorating your days with HTML agenda contents.
• Versatile and removable top/bottom sections.
• Auto-adaptive calendar width adjustment.
• Diversified context-sensitive behaviors, like popups, auto-mail or any JavaScript statement.
• USA/Europe/ISO-8601 conformant calendar formats and selectable week numbers.
• Unicode compliant and ready for localization and/or internationalization.
• Unique plug-in design maximizes the extensibility.
• Expandable holiday function can accommodate most sophisticated holiday algorithms.
• Multiple calendars can be tiled and coordinated in the same page.
• Powerful multi-select plugin allow user to pick up multiple dates or date range easily.
• Agenda can be shared across multiple calendars, even with PopCalendarXP.
• Easy to install, easy to use. (NN4 needs more care)
• Fully compatible with ASP.NET, JSP, PHP, ColdFusion and other cgi technologies.
• and a lot more ...

System Requirements

FlatCalendarXP Commercial Edition was tested working in the following browsers with JavaScript support option enabled.

• Windows 9x/ME/NT/2000/XP
  • Internet Explorer 4.01, 5.0, 5.5, 6.0, 7.0+
  • Netscape 4.08, 4.75, 4.79, 4.80
  • Netscape 6.0, 7.0, 8.0+
  • Mozilla FireFox 1.0+
  • Opera 7.0, 8.0, 9.0+
  • Safari 3.0+
• MacOS 9/10
  • Internet Explorer 5.0, 5.1, 5.2
  • Netscape 6.0, 6.2, 7.0
  • Mozilla FireFox 1.0+
  • Safari 1.0+
  • Opera 8.5+
• Mandrake/RedHat Linux 9
  • Mozilla FireFox 1.0+
  • Konqueror 3.0, 3.1
• Solaris 8
  • Netscape 6.0
  • Mozilla FireFox 1.0+

Some customers also reported that they had it successfully running in browsers on other systems like IRIX and AIX.

Please also have a look at the known problems and make sure they are acceptable before ordering.

Known Problems

• Problem: Netscape 4.x doesn't support tooltips and only IE4+ supports multi-line tooltips.
  Cause: Browser incapabilities.
  Workaround: Upgrade to Netscape 6+ or IE 5+.
  
  
• Problem: Netscape 4.x can't render more than 6 calendars in the same page.
  Cause: Browser engine problem.
  Workaround: Upgrade to Netscape 6+ if you really need more than 6.
  
  
• Problem: Netscape 4.x doesn't support implementing different themes in the same page.
  Cause: Browser CSS incapabilities.
  Workaround: Upgrade to Netscape 6+ or avoid using different themes in the same page.
  
  
• Problem: Garbage chars show up in Netscape 4.x if the web server employs "gzip" http compression.
  Cause: Infamous bug of NN4.
  Workaround: Turn off the http response compression on web server.
  
  
• Problem: Implementing the calendar in Netscape 4.x under certain situations could result extra complexity in web authoring.
  Cause: The buggy and non-standard-compliant DHTML engine of Netscape 4.x.
  Workaround: Follow the NN4 tutorials bundled with the commercial edition.
  
  
• Problem: The mockup theme and decent theme doesn't work well in IE5 on Mac.
  Cause: Browser CSS2 incapabilities.
  Workaround: Upgrade to Safari or Mozilla for Mac.
  

Revision History

Release 9.9.290

+ Added support to Safari 3.0.
+ Totally revised accounting 4-4-5 calendar support and demo.
+ Added giFirstMonth to indicate the start month of fiscal year.
- Fixed a bug of fLoadScript and made it pure AJAX.
- Minor bug fixes.

Release 9.8.285

+ Added support to finacial 4-4-5 calendars (simply set gb445 option to true).
* Allowed TAB key to navigate the focus through the dates and ENTER key to select.
- Fixed a bug in fW2Date regarding the customized week offset.
- Fixed a bug that disables the calendar when running in Netscape 8.x browsers.

Release 9.7.272

+ Added support to IE 7 beta2.
* Adjusted mini theme to fix border issue in IE 5.5.
* Optimized demos with more combined features.
* Update agenda tutorial with MySQL and PHP examples.
- Fixed a bug so as to allow showing only the top (for selecting month only).
- Fixed the xml loading bugs in agenda tutorial.

Release 9.6.265

+ Added _cacheOther option to switch caching of theme and plugin files (gbCacheAgenda option is for agenda-cache only).
+ Enabled CSS cursor support for Safari 1.x and Mozilla.
+ Added support to hide the calendar middle panel.
* Renamed the Developer License to Enterprise License.
- Remove the default utf-8 charset setting, you can always set it in name & id if needed.
- Fixed a browser cache problem.

Release 9.5.256

+ Added charset support to make localization even easier.
* Updated tutorials.
- Fixed a bug that causes extra white space at the top in Opera 8.5.
- Minor bug fixes.

Release 9.4.251

+ Enable the boxit param of agenda to set border color of date cell individually instead of relying on bgcolor.
+ Added undocumented _preferOOR option to keep the agenda style even when they are out-of-range.
+ Made hovering mouse cursor context(action) sensitive.
* Updated agenda tutorial including samples regarding XML agenda.
* Refactored the calendar engine to eliminate the onclick restriction from the html param of agenda.
* Returning value of fOnDrag plugin is no longer needed, since date picking is triggered via onclick now.
* Fine-tuned the mini theme.
* Fine-tuned script loading sequence inside the calendar engine.
* Optimized fInitRange() to set default safe-month to the begin of range in case it's missing.
- Fixed a minor bug in agenda effect logic.
- Fixed a bug in multipicker demo regarding to column selection.

Release 9.3.235

+ Added support to Opera 8.
+ Added the classic demo.
* Restructured demos directory to give a better idea of code separation.
* Updated License Agreement with new license type.
* Moved all FAQ into online forum with better support and easier to find.
* Added workaround for Mcafee8 slowdown.
* Optimized some themes.
* Updated tutorials.
- Adjusted css rules to make tutorial more readable in firefox.
- Fixed a bug in fInitRange and repaint the calendar after each call.
- Fixed a misinterpretation in Multipicker Demo.
- Added a workaround to avoid the relative path issue in NN4.

Release 9.2.224

+ Added type-in-year support to the contrast theme, as well as a FAQ for how to apply it to other themes.
+ Added fOnload event handler to plugins.js
+ Enhanced the plugins for multipicker demo 2 (commercial edition only) so as to make it easier to support calendar group.
- Fixed a bug in type-in-year support that crashes safari and IE on Mac.

Release 9.1.220

+ Made domain license more friendly to Intranet by having all non-dotted local hostnames covered.
+ Added OnDoWClick plugin function to enable clicking events on week titles.
+ Integrated the getDateByDOW from plugin into engine core, renamed to fGetDateByDOW.
+ Added a new demo.
* Enhanced multipicker demo to select dates of the same weekday.
* Updated FAQ and License Agreement.
- Fixed a bug in Mac theme.
+ Added an additional param to the fAddEvent() so as to allow user to attach any object with the event.
+ You now have the option to remove the line-through effect on disabled dates, see FAQ for details.
+ Added additional support to offset week number algorithm.
* Improved engine so that you may now use '\n' directly in the action string.
* Updated FAQ.
- Fixed a bug that may prevent agenda from being shared properly. Please update if you use the agenda sharing feature.
- Fixed a serious bug introduced in build 199.
- Minor bug fixes.

Release 9.0.196

+ Added new themes.
+ Added new powerful demos.
+ Added more plugin functions.
+ Added support to auto-adjust calendar width according to its enclosing parent tag.
+ Added support to allow loading agendas on-demond (per month), see tutorials for details.
+ Added auto-traverse support when holding down the navigation button.
+ Supported more browsers, including Safari on MacOS.
+ Added support to make any day as first day of week. (gbEuroCal option is deprecated)
* Enhanced dragging support and multi-select plugin.
* Optimized all themes and slightly improved engine performance.
* Updated tutorials and FAQ.
- Minor bug fixes.

Release 8.1.178

+ Added a new theme.
+ Now you can hide all the contents in a date cell by setting its agenda fgcolor to "" (empty string). This gives you another way to disable a date.
* Adjusted month navigator options of certain themes to follow a bug fix.
* Updated tutorials and FAQ.
- General bug fixes.

Release 8.0.172

+ Enhanced support for handling server-side charset encoding and i18n.
+ Enhanced NN4 support.
+ Added new demos and themes.
+ Added in FAQ on how to append multiple sub-events to a day.
* Updated datePicker2 demo on how to persist/retrieve multi-selected dates to/from server.
* Updated documentation with new tips and tricks.
* Not working with old NN4 tag, new tags are required for NN4.x (not affecting other browsers).
- Default multiselect key changed to Ctrl from Alt.
- gEvent has been deprecated, event object is now directly passed into plugin functions.
- Fixed a minor bug that may stop showing hint messages on status-bar.
- Fixed a bug in outlookTwin and triplex theme plugin.
- Fixed a bug that can't hide days in other months when set background color to transparent.

Release 7.1.158

* License schema changed.
- Fixed license related issues on IIS 6.0 and tomcat 4.0.

Release 7.0.156

+ New multi-select plugin supports dragging and ctrl/alt/shift-key-assisted dates picking.
+ Support run-time agenda sharing across multiple calendars, even with PopCalendarXP.
+ More theme options that can help creating gorgeous effects.
+ Added more high-quality themes!
+ Added more powerful demos!
* Enhanced code engine is 2-8 times faster on various browsers.
* Enhanced auto-resizing under all supported browsers.
* Enhanced internal dropdown plugins.
* Updated product tutorials and FAQ.
- Fixed the border overflow bug in Opera 7 and the frame border bug in IE6 with DOCTYPE.
- Fixed a bug that caused the calendar title always left-aligned in IE on Mac.
- Opera 6.x support has been discontinued.
- Other minor bugs fixed.

Release 6.1.105a

+ Added a new arrival/departure demo for FlatCalendarXP.
* Updated product tutorials and FAQ.
* Minor optimization to the engine.

Release 6.1.104a

+ Added a new option in themes to invert the boldface effect.
+ Setting gsOutOfRange to empty string (i.e. "") can now prevent the out-of-range alert from showing up.
* Added more FAQs to documentation.
* Updated the agenda tutorial to improve the JSP/Database sample.

Release 6.1.102

+ Added support to Opera 7.0!
- Fixed a bug that crashes IE 5.0 on MacOS 9.2.

Release 6.0.100

+ Tons of new features added in the theme.
+ More highlighting effects on agenda date.
+ New exquisite high-quality cross-browser themes.
+ New plugin support, extremely extensible.
+ New well-organized well-documented tutorials and demos.
* Code engine has been rewritten and is 4 times faster than before!!!
* Week number is now ISO-8601 conformant.
- Minor bugs fixed.

 

---

 

 

 

⁺This product includes software developed by the Apache Software Foundation (http://www.apache.org/) - the Tigris CSS Style Sheet (http://style.tigris.org/), which is used to render tutorial documents only.