scripts/jscalendar-1.0/release-notes.html

   1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 3.2//EN">
   2 <html>
   3   <head>
   4     <title>jscalendar release notes</title>
   5
   6     <style type="text/css">
   7       h1 { border-bottom: 1px solid #000; }
   8       h2 { border-bottom: 1px solid #444; }
   9       ul li { margin-top: 0.5em; margin-bottom: 0.5em; }
  10     </style>
  11   </head>
  12
  13   <body>
  14     <div style="float: right; border: 1px solid #000; background: #fff; padding: 10px; ">
  15       <a href="http://www.dynarch.com/projects/calendar/">The Coolest DHTML Calendar</a><br />
  16       © <a href="http://www.dynarch.com/">Dynarch.com</a> 2002 and later.
  17     </div>
  18     <h1>jscalendar release notes</h1>
  19
  20     <p>This release compiled at Monday,  7 Mar 2005 (19:06).</p>
  21
  22     <h2>1.0</h2>
  23
  24     <ul>
  25
  26       <li>
  27         Added support for multiple dates selection.  In this mode the
  28         calendar will allow the user to select more than one date, and
  29         will maintain an array of selected dates that can be
  30         investigated from your custom handlers.  Sample in <a
  31         href="multiple-dates.html">multiple-dates.html</a>.
  32       </li>
  33
  34       <li>
  35         Support for “day info”.  Using this feature you can display
  36         custom information for certain dates.  Sample in <a
  37         href="dayinfo.html">dayinfo.html</a>.  Note that if the text
  38         is really big the calendar layout might appear somehow broken;
  39         this is something that should be easy to fix in the CSS file.
  40       </li>
  41
  42       <li>
  43         Clicking on “Today” will now close the calendar if the current
  44         date is already selected.
  45       </li>
  46
  47       <li>
  48         The “first day of week” setting can now be defined in the
  49         language file--after all, it is locale-specific.  The new
  50         parameter is “Calendar._FD”.  Language files should be
  51         updated, but the calendar will not complain nor fail to
  52         function if the parameter is not present.
  53       </li>
  54
  55       <li>
  56         Some fixes to make the thing work in Safari.  It now seems to
  57         be properly supported, please let me know if you encounter any
  58         problems.
  59       </li>
  60
  61       <li>
  62         New skin: Aqua theme, appropriate for MacOSX fan sites :-)
  63         This theme is located in “skins/aqua/theme.css” (in the
  64         future, all themes will go to this directory).
  65       </li>
  66
  67       <li>
  68         <b>Bug fixes.</b>
  69         <ul>
  70           <li>
  71             Keyboard operation now functions normally when the
  72             calendar is displaying days from adjacent months; it might
  73             even work correctly for months containing disabled dates
  74             :).  This fix was originally developed under contract for
  75             <a
  76             href="http://www.zapatec.com/website/main/products/prod1/">The
  77             Zapatec Calendar</a>.  Zapatec kindly allowed us to
  78             include the bugfixes back in the open source calendar.
  79           </li>
  80           <li>
  81             Fixed the time selection bug: the previous version would
  82             reset the time to current time when a new date was
  83             clicked.
  84           </li>
  85           <li>
  86             Parsing hours like "12:XX pm" would wrongfully replace
  87             "pm" with "am"--fixed.
  88           </li>
  89           <li>
  90             Fixed critical bugs in parseDate function that would
  91             initialize the calendar with 'NaN' values in all cells if
  92             the string to be parsed is not a valid date.
  93           </li>
  94           <li>
  95             The golbal variable that we are using was renamed to
  96             “_dynarch_popupCalendar” to minimize the risk of name
  97             clashes.  It's still difficult to get rid of it.
  98           </li>
  99           <li>
 100             Added z-index property to drop-down menus style.
 101           </li>
 102           <li>
 103             The calendar will update an input field even in flat mode,
 104             if an input field was passed.  Also, the “showOthers”
 105             parameter will be effective in both popup and flat mode.
 106           </li>
 107           <li>
 108             Others, probably.
 109           </li>
 110         </ul>
 111       </li>
 112
 113       <li>
 114         Documentation &amp; sample files updated.
 115       </li>
 116
 117     </ul>
 118
 119     <h2>0.9.6</h2>
 120
 121     <ul>
 122
 123       <li>
 124         "Smart" (TM :-) positioning algorithm.  The new algorithm will
 125         try to keep the calendar in the browser view, which is helpful
 126         in situations when the input field is near the bottom or the
 127         right edge.  This code is only tested with IE and Mozilla, but
 128         it should work with other browsers too.  Many thanks to <a
 129         href="http://www.ex3.com">Sunny Chowdhury</a> for sponsoring
 130         this feature!
 131       </li>
 132
 133       <li>
 134         Support for IE5/Win is back.  I also want to thank Janusz
 135         Piwowarski for keeping his eye on the CVS ;-) He reviewed my
 136         IE5-related changes and sent me a much cleaner patch.
 137       </li>
 138
 139       <li>
 140         The calendar will now allow any day of week to be "the first
 141         day of week".  This was requested long time ago, by someone
 142         whose name I forgot (sorry).  The reason was that in certain
 143         countries weeks start on Saturday.  So I thought that instead
 144         of having a "mondayFirst" and a "saturdayFirst" parameter,
 145         :-), it's better to have a "firstDayOfWeek" parameter; now
 146         it's present and its meaning is: "0 for Sunday", "1 for
 147         Monday", "2 for Tuesday", etc.  The equivalent parameter for
 148         Calendar.setup is "firstDay".  The end user can also change
 149         it very easy: click on the day name in the calendar display.
 150       </li>
 151
 152       <li>
 153         The above feature triggered one <b>important change</b>: the
 154         notion of "weekend" is now defined in the language file.
 155         Added parameters:
 156
 157         <pre>
 158           Calendar._TT["WEEKEND"] = "0,6";
 159           Calendar._TT["DAY_FIRST"] = "Display %s first";</pre>
 160
 161         "WEEKEND" specifies a string with comma-separated numbers from
 162         0 to 7; they define what days are marked as "weekend".  5 and
 163         6 mean, of course, "Sunday" and "Saturday".  Day first is the
 164         tooltip displayed when a day name is hovered; "%s" will get
 165         replaced with the day name.  Updated languages are "en" and
 166         "ro", which I maintain.  Please note that languages wich are
 167         not updated <b>will not work</b>.  If yours is one of them,
 168         please consider fixing it and sending me the fix so that I can
 169         include it in the distro.
 170       </li>
 171
 172       <li>
 173         The calendar can now display days from the months adjacent to
 174         the currently displayed one.  This is optional, of course, and
 175         the parameter name is "showsOtherMonths" (or "showOthers" in
 176         Calendar.setup).  All theme files were updated.
 177       </li>
 178
 179       <li>
 180         Displays "Time:" near the time selector, only if defined in
 181         the language file.
 182       </li>
 183
 184       <li>
 185         Some bugs fixed in the date parsing code (which has also been
 186         rewritten a little bit cleaner).
 187       </li>
 188
 189       <li>
 190         Calendar.setup will now configure the calendar to trigger the
 191         input fields' "onchange" event, if specified, when a date is
 192         selected.
 193       </li>
 194
 195       <li>
 196         New parameter in Calendar.setup: "cache" (<b>defaults to
 197         false</b>).  If set to true then the popup calendar object
 198         will be "cached", meaning, it will be created only once, no
 199         matter how many input fields are there in the page.  Sometimes
 200         this is not desirable, which is why I've added this
 201         parameter.  Please note that it defaults to "false" (thus the
 202         default behavior has changed).
 203       </li>
 204
 205       <li>
 206         Added a simple PHP wrapper.  It provides code which loads all
 207         the required scripts and theme file, and one function which
 208         creates and configures an input field for date input.  It
 209         takes care of creating and assigning unique ID-s for the
 210         calendar fields and it also creates the "Calendar.setup" code.
 211         Functions to create more specialized fields can be added very
 212         easily.  This feature was requested by the FreeMED.org project
 213         (thanks for donating!).
 214       </li>
 215
 216     </ul>
 217
 218     <p>Wow, there were quite some changes :-D  Enjoy it!</p>
 219
 220     <h2>0.9.5</h2>
 221
 222     <p>
 223       This release's primary goal is to fix a wrong license statement which
 224       can be found in some files from 0.9.4.  For instance in README or
 225       calendar.js, the statement was that the code is distributed under the
 226       GNU GPL; that's because I had plans to change the license, then
 227       changed my mind but unfortunately I committed files so.  I am sorry
 228       for this inconvenience, please use the latest (0.9.5) release which is
 229       fully covered by LGPL.
 230     </p>
 231
 232     <p>Other changes:</p>
 233
 234     <ul>
 235
 236       <li>
 237         <b>Fixed</b> an annoying bug that prevented the calendar to display
 238         correctly when it was configured for an input field inside a
 239         <b>scrolling area</b>.  <b>Many thanks</b> to Ian Barrack (<a
 240         href="http://www.simban.com">Simban.com</a>) who pointed it up and
 241         donated quite some money for the Calendar project!
 242       </li>
 243
 244       <li>
 245         All examples use UTF-8 now; the translations may not be all
 246         up-to-date, but I <strong>strongly</strong> suggest everyone to use
 247         UTF-8; other encodings are a plain mess.  So far I know for sure
 248         that Romanian translation will work with UTF-8 and <em>not
 249         anymore</em> with ISO-8859-2.  Other translations are probably
 250         usable under UTF-8, but if your preferred language isn't... ;-)
 251         please make it and send it to me for inclusion.
 252       </li>
 253
 254       <li>
 255         Fixed small bug in the documentation (one footnote didn't appear
 256         where it should have).
 257       </li>
 258
 259       <li>
 260         Updated translations: DE, ES, HU, IT, RO.  Thanks to everyone who
 261         sent translations!
 262       </li>
 263
 264     </ul>
 265
 266     <h2>0.9.4</h2>
 267
 268     <h3>New stuff</h3>
 269
 270     <ul>
 271
 272       <li>Supports time selection.  Yes. ;-) This work has been largely
 273         sponsored by <strong>Himanshukumar Shah</strong> (thank you!).  See
 274         the docs and example files for details on how to setup.</li>
 275
 276       <li>Easy to link 2 or more fields by using the new
 277         <code>onUpdate</code> parameter of <code>Calendar.setup</code>.  This
 278         is useful, say, to automatically set a value in a second field based
 279         on the value selected in the first field.  See the documentation and
 280         first sample in <a href="simple-1.html">simple-1.html</a>.</li>
 281
 282       <li>Other <code>Calendar.setup</code> low-level parameters, for those
 283         wanting to have the complete control: <code>onSelect</code> and
 284         <code>onClose</code>.  The handlers are called when something is
 285         selected in the calendar or when the calendar is closed.</li>
 286
 287       <li>The translation files can optionally include the short day names
 288         and the short month names.  That's because in some languages, like
 289         German, the short form is not the first 3 letters of the entire name
 290         but only the first 2.  Also in other languages short names can't be
 291         as easily derived from the full name by just calling substr, so this
 292         patch solves the problem.</li>
 293
 294       <li>Implemented a nice way to make some dates "special" (look
 295         different).  Specifically, the <code>setDisabledHandler</code> method
 296         was replaced with the more general <code>setDateStatusHandler</code>
 297         method (the old one is still available for backwards compatibility but
 298         <em>will</em> be removed).  More details about this in the
 299         documentation.  Also see <a href="simple-3.html">simple-3.html</a>
 300         for a live sample.</li>
 301
 302       <li>Date parsing and formatting engine is now rewritten and supports a
 303         subset of <code>strftime</code> format specifiers from ANSI C.  This
 304         makes it possible to use dates like "YYYYMMDD" (the corresponding
 305         format for this would be "%Y%m%d").  Details in the documentation.
 306         <b>Please note that the new engine is not compatibile with older
 307           calendar releases!</b></li>
 308
 309       <li>Along with the new date parser I workarounded an unpleasant crash
 310         that occurred in IE when certain accented characters appeared in the
 311         texts.  I think German was one of the language with such problems, and
 312         the workaround was to use the letter without an accent.  Well, now you
 313         can translate to whatever you want.</li>
 314
 315       <li>"Fixes" (I mean, "horrible workarounds") for Konqueror (and
 316         hopefully Safari).  Unfortunately, this otherwise excellent browser
 317         still has some bugs that keep the calendar from working
 318         <em>exactly</em> as it should..  But they're going to be fixed,
 319         right? ;-)</li>
 320
 321       <li>CSS themes got pretty much modified too so if you wrote your theme
 322         you need to update it.  Aside for the time selector support, the CSS
 323         themes contain a simple hack that makes the navigation buttons show
 324         a little arrow in the lower-right corner which indicates that if one
 325         holds the mouse a menu will appear.</li>
 326
 327     </ul>
 328
 329     <h3>Translation files</h3>
 330
 331     <p>The translation files need to be updated in order for the calendar to
 332       work properly.  Currently the only updated files are calendar-en.js
 333       (main file) and calendar-ro.js (well, yes, I am a Romanian ;-).</p>
 334
 335     <p>Specifically, they need the following:</p>
 336
 337     <ul>
 338
 339       <li>Correct date format, according with the new format specifiers
 340         introduced in 0.9.4.  Details about the available format specifiers
 341         in the documentation</li>
 342
 343       <li>Short day or month names, <em>if required</em>.  If they can be
 344         derived by taking the first N letters of the full name then a simple
 345         Calendar._SDN_len = N or Calendar._SMN_len = N will suffice.  If N
 346         is 3 then nothing needs to be done as we take it for granted if no
 347         other option is offered ;-)</li>
 348
 349       <li>We have some new texts that shows short usage information as well
 350         as copyright information.</li>
 351
 352     </ul>
 353
 354     <p>If your favorite language is not there yet, or it is but not updated
 355       according to the main calendar-en.js file, then please consider
 356       translating calendar-en.js and send the translation back to me so that
 357       I include it in the official distribution.</p>
 358
 359     <h3>Bug status</h3>
 360
 361     <p>Check <a
 362         href="http://sourceforge.net/tracker/?atid=544285&group_id=75569&func=browse">SourceForge</a>,
 363       I didn't keep track.  However, there were a lot of bugfixes.</p>
 364
 365     <h2>0.9.3</h2>
 366
 367     <h3>New stuff</h3>
 368
 369     <ul>
 370
 371       <li>Opera&nbsp;7 compatibility &mdash; keyboard navigation is
 372         still not available; text selection can't be disabled, leading to an
 373         ugly effect when walking through the month/year menus.</li>
 374
 375       <li>Ability to align the calendar relative to the input field (or any
 376         other element).  Vertical: top, center, bottom.  Horizontal: left,
 377         center, right.  This is established as a new parameter for
 378         <tt>showAtElement</tt>.</li>
 379
 380       <li>Added <tt>dateClicked</tt> property (boolean).  This can be
 381         inspected in the "onSelect" handler to determine if a date was
 382         really clicked or the user only changed month/year using the menus.
 383         You <em>need</em> to check this for "single-click" calendars and
 384         only close/hide the calendar if it's <tt>true</tt>.</li>
 385
 386       <li>Full documentation in <a href="doc/html/reference.html">HTML</a>
 387         and <a href="doc/reference.pdf">PDF</a> format is now available in the
 388         distribution archive.</li>
 389
 390       <li>New language definition files: HU, HR, PT, ZH.  Thanks those who
 391         submitted!</li>
 392
 393     </ul>
 394
 395     <h3>Bug status</h3>
 396
 397     <p>This covers only those bugs that have been reported <a
 398         href="http://sourceforge.net/projects/jscalendar" target="_blank"
 399         title="Project page at SourceForge">at SourceForge</a>.</p>
 400
 401     <ol>
 402
 403       <li><a href="http://sourceforge.net/tracker/index.php?func=detail&aid=703238&group_id=75569&atid=544285" target="_blank"
 404             title="Go to bug description at sourceforge"><tt>#703,238</tt></a> &mdash; fixed</li>
 405       <li><a href="http://sourceforge.net/tracker/index.php?func=detail&aid=703814&group_id=75569&atid=544285" target="_blank"
 406             title="Go to bug description at sourceforge"><tt>#703,814</tt></a> &mdash; fixed</li>
 407       <li><a href="http://sourceforge.net/tracker/index.php?func=detail&aid=716777&group_id=75569&atid=544285" target="_blank"
 408             title="Go to bug description at sourceforge"><tt>#716,777</tt></a> &mdash; closed (was fixed already in 0.9.2-1)</li>
 409       <li><a href="http://sourceforge.net/tracker/index.php?func=detail&aid=723335&group_id=75569&atid=544285" target="_blank"
 410             title="Go to bug description at sourceforge"><tt>#723,335</tt></a> &mdash; fixed</li>
 411       <li><a href="http://sourceforge.net/tracker/index.php?func=detail&aid=715122&group_id=75569&atid=544285" target="_blank"
 412             title="Go to bug description at sourceforge"><tt>#715,122</tt></a> &mdash; feature request; implemented.</li>
 413       <li><a href="http://sourceforge.net/tracker/index.php?func=detail&aid=721206&group_id=75569&atid=544285" target="_blank"
 414             title="Go to bug description at sourceforge"><tt>#721,206</tt></a> &mdash; fixed (added "refresh()" function)</li>
 415       <li><a href="http://sourceforge.net/tracker/index.php?func=detail&aid=721833&group_id=75569&atid=544285" target="_blank"
 416             title="Go to bug description at sourceforge"><tt>#721,833</tt></a> &mdash; fixed (bug concerning the "yy" format
 417         parsing)</li>
 418       <li><a href="http://sourceforge.net/tracker/index.php?func=detail&aid=721833&group_id=75569&atid=544285" target="_blank"
 419             title="Go to bug description at sourceforge"><tt>#721,833</tt></a> &mdash; won't fix (we won't set the time to
 420         midnight; time might actually be useful when we implement support
 421         for time selection).
 422
 423     </ol>
 424
 425     <hr />
 426     <address><a href="http://dynarch.com/mishoo/">Mihai Bazon</a></address>
 427 <!-- Created: Tue Jul  8 17:29:37 EEST 2003 -->
 428 <!-- hhmts start -->
 429 Last modified on Wed Oct 29 02:37:07 2003
 430 <!-- hhmts end -->
 431 <!-- doc-lang: English -->
 432   </body>
 433 </html>
 434
 435