forked from extern/egroupware
0a28f3812e
- Inclusion of the following javascript directories:
* Connector: javascript object to interface xmlhttprequest object. This object allows
asynchronous posts and support for messages while this post is being done, such as
"wait, contacting server", etc.
* JsAPI: general javascript functions and methods
* jsolait: performs conversion from a xmlrpc message to a javascript object
* xmlRpcMsgCreator: performs conversion from a javascript object to a xmlrpc message
* dynapi: cross-browser class to draw layers
- Update in setup version: now is 1.0.1.008; Update your versions. There was made a
change in phpgw_vfs2_files table in handling of modified files.
- Upgrade of vfs2 classes and PclZip class
- Changes in javascript object and common object to allow the javascript backend to
applications to work (now just filescenter will use it...)
436 lines
18 KiB
HTML
436 lines
18 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 3.2//EN">
|
|
<html>
|
|
<head>
|
|
<title>jscalendar release notes</title>
|
|
|
|
<style type="text/css">
|
|
h1 { border-bottom: 1px solid #000; }
|
|
h2 { border-bottom: 1px solid #444; }
|
|
ul li { margin-top: 0.5em; margin-bottom: 0.5em; }
|
|
</style>
|
|
</head>
|
|
|
|
<body>
|
|
<div style="float: right; border: 1px solid #000; background: #fff; padding: 10px; ">
|
|
<a href="http://www.dynarch.com/projects/calendar/">The Coolest DHTML Calendar</a><br />
|
|
© <a href="http://www.dynarch.com/">Dynarch.com</a> 2002 and later.
|
|
</div>
|
|
<h1>jscalendar release notes</h1>
|
|
|
|
<p>This release compiled at Monday, 7 Mar 2005 (19:06).</p>
|
|
|
|
<h2>1.0</h2>
|
|
|
|
<ul>
|
|
|
|
<li>
|
|
Added support for multiple dates selection. In this mode the
|
|
calendar will allow the user to select more than one date, and
|
|
will maintain an array of selected dates that can be
|
|
investigated from your custom handlers. Sample in <a
|
|
href="multiple-dates.html">multiple-dates.html</a>.
|
|
</li>
|
|
|
|
<li>
|
|
Support for “day info”. Using this feature you can display
|
|
custom information for certain dates. Sample in <a
|
|
href="dayinfo.html">dayinfo.html</a>. Note that if the text
|
|
is really big the calendar layout might appear somehow broken;
|
|
this is something that should be easy to fix in the CSS file.
|
|
</li>
|
|
|
|
<li>
|
|
Clicking on “Today” will now close the calendar if the current
|
|
date is already selected.
|
|
</li>
|
|
|
|
<li>
|
|
The “first day of week” setting can now be defined in the
|
|
language file--after all, it is locale-specific. The new
|
|
parameter is “Calendar._FD”. Language files should be
|
|
updated, but the calendar will not complain nor fail to
|
|
function if the parameter is not present.
|
|
</li>
|
|
|
|
<li>
|
|
Some fixes to make the thing work in Safari. It now seems to
|
|
be properly supported, please let me know if you encounter any
|
|
problems.
|
|
</li>
|
|
|
|
<li>
|
|
New skin: Aqua theme, appropriate for MacOSX fan sites :-)
|
|
This theme is located in “skins/aqua/theme.css” (in the
|
|
future, all themes will go to this directory).
|
|
</li>
|
|
|
|
<li>
|
|
<b>Bug fixes.</b>
|
|
<ul>
|
|
<li>
|
|
Keyboard operation now functions normally when the
|
|
calendar is displaying days from adjacent months; it might
|
|
even work correctly for months containing disabled dates
|
|
:). This fix was originally developed under contract for
|
|
<a
|
|
href="http://www.zapatec.com/website/main/products/prod1/">The
|
|
Zapatec Calendar</a>. Zapatec kindly allowed us to
|
|
include the bugfixes back in the open source calendar.
|
|
</li>
|
|
<li>
|
|
Fixed the time selection bug: the previous version would
|
|
reset the time to current time when a new date was
|
|
clicked.
|
|
</li>
|
|
<li>
|
|
Parsing hours like "12:XX pm" would wrongfully replace
|
|
"pm" with "am"--fixed.
|
|
</li>
|
|
<li>
|
|
Fixed critical bugs in parseDate function that would
|
|
initialize the calendar with 'NaN' values in all cells if
|
|
the string to be parsed is not a valid date.
|
|
</li>
|
|
<li>
|
|
The golbal variable that we are using was renamed to
|
|
“_dynarch_popupCalendar” to minimize the risk of name
|
|
clashes. It's still difficult to get rid of it.
|
|
</li>
|
|
<li>
|
|
Added z-index property to drop-down menus style.
|
|
</li>
|
|
<li>
|
|
The calendar will update an input field even in flat mode,
|
|
if an input field was passed. Also, the “showOthers”
|
|
parameter will be effective in both popup and flat mode.
|
|
</li>
|
|
<li>
|
|
Others, probably.
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
|
|
<li>
|
|
Documentation & sample files updated.
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
<h2>0.9.6</h2>
|
|
|
|
<ul>
|
|
|
|
<li>
|
|
"Smart" (TM :-) positioning algorithm. The new algorithm will
|
|
try to keep the calendar in the browser view, which is helpful
|
|
in situations when the input field is near the bottom or the
|
|
right edge. This code is only tested with IE and Mozilla, but
|
|
it should work with other browsers too. Many thanks to <a
|
|
href="http://www.ex3.com">Sunny Chowdhury</a> for sponsoring
|
|
this feature!
|
|
</li>
|
|
|
|
<li>
|
|
Support for IE5/Win is back. I also want to thank Janusz
|
|
Piwowarski for keeping his eye on the CVS ;-) He reviewed my
|
|
IE5-related changes and sent me a much cleaner patch.
|
|
</li>
|
|
|
|
<li>
|
|
The calendar will now allow any day of week to be "the first
|
|
day of week". This was requested long time ago, by someone
|
|
whose name I forgot (sorry). The reason was that in certain
|
|
countries weeks start on Saturday. So I thought that instead
|
|
of having a "mondayFirst" and a "saturdayFirst" parameter,
|
|
:-), it's better to have a "firstDayOfWeek" parameter; now
|
|
it's present and its meaning is: "0 for Sunday", "1 for
|
|
Monday", "2 for Tuesday", etc. The equivalent parameter for
|
|
Calendar.setup is "firstDay". The end user can also change
|
|
it very easy: click on the day name in the calendar display.
|
|
</li>
|
|
|
|
<li>
|
|
The above feature triggered one <b>important change</b>: the
|
|
notion of "weekend" is now defined in the language file.
|
|
Added parameters:
|
|
|
|
<pre>
|
|
Calendar._TT["WEEKEND"] = "0,6";
|
|
Calendar._TT["DAY_FIRST"] = "Display %s first";</pre>
|
|
|
|
"WEEKEND" specifies a string with comma-separated numbers from
|
|
0 to 7; they define what days are marked as "weekend". 5 and
|
|
6 mean, of course, "Sunday" and "Saturday". Day first is the
|
|
tooltip displayed when a day name is hovered; "%s" will get
|
|
replaced with the day name. Updated languages are "en" and
|
|
"ro", which I maintain. Please note that languages wich are
|
|
not updated <b>will not work</b>. If yours is one of them,
|
|
please consider fixing it and sending me the fix so that I can
|
|
include it in the distro.
|
|
</li>
|
|
|
|
<li>
|
|
The calendar can now display days from the months adjacent to
|
|
the currently displayed one. This is optional, of course, and
|
|
the parameter name is "showsOtherMonths" (or "showOthers" in
|
|
Calendar.setup). All theme files were updated.
|
|
</li>
|
|
|
|
<li>
|
|
Displays "Time:" near the time selector, only if defined in
|
|
the language file.
|
|
</li>
|
|
|
|
<li>
|
|
Some bugs fixed in the date parsing code (which has also been
|
|
rewritten a little bit cleaner).
|
|
</li>
|
|
|
|
<li>
|
|
Calendar.setup will now configure the calendar to trigger the
|
|
input fields' "onchange" event, if specified, when a date is
|
|
selected.
|
|
</li>
|
|
|
|
<li>
|
|
New parameter in Calendar.setup: "cache" (<b>defaults to
|
|
false</b>). If set to true then the popup calendar object
|
|
will be "cached", meaning, it will be created only once, no
|
|
matter how many input fields are there in the page. Sometimes
|
|
this is not desirable, which is why I've added this
|
|
parameter. Please note that it defaults to "false" (thus the
|
|
default behavior has changed).
|
|
</li>
|
|
|
|
<li>
|
|
Added a simple PHP wrapper. It provides code which loads all
|
|
the required scripts and theme file, and one function which
|
|
creates and configures an input field for date input. It
|
|
takes care of creating and assigning unique ID-s for the
|
|
calendar fields and it also creates the "Calendar.setup" code.
|
|
Functions to create more specialized fields can be added very
|
|
easily. This feature was requested by the FreeMED.org project
|
|
(thanks for donating!).
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
<p>Wow, there were quite some changes :-D Enjoy it!</p>
|
|
|
|
<h2>0.9.5</h2>
|
|
|
|
<p>
|
|
This release's primary goal is to fix a wrong license statement which
|
|
can be found in some files from 0.9.4. For instance in README or
|
|
calendar.js, the statement was that the code is distributed under the
|
|
GNU GPL; that's because I had plans to change the license, then
|
|
changed my mind but unfortunately I committed files so. I am sorry
|
|
for this inconvenience, please use the latest (0.9.5) release which is
|
|
fully covered by LGPL.
|
|
</p>
|
|
|
|
<p>Other changes:</p>
|
|
|
|
<ul>
|
|
|
|
<li>
|
|
<b>Fixed</b> an annoying bug that prevented the calendar to display
|
|
correctly when it was configured for an input field inside a
|
|
<b>scrolling area</b>. <b>Many thanks</b> to Ian Barrack (<a
|
|
href="http://www.simban.com">Simban.com</a>) who pointed it up and
|
|
donated quite some money for the Calendar project!
|
|
</li>
|
|
|
|
<li>
|
|
All examples use UTF-8 now; the translations may not be all
|
|
up-to-date, but I <strong>strongly</strong> suggest everyone to use
|
|
UTF-8; other encodings are a plain mess. So far I know for sure
|
|
that Romanian translation will work with UTF-8 and <em>not
|
|
anymore</em> with ISO-8859-2. Other translations are probably
|
|
usable under UTF-8, but if your preferred language isn't... ;-)
|
|
please make it and send it to me for inclusion.
|
|
</li>
|
|
|
|
<li>
|
|
Fixed small bug in the documentation (one footnote didn't appear
|
|
where it should have).
|
|
</li>
|
|
|
|
<li>
|
|
Updated translations: DE, ES, HU, IT, RO. Thanks to everyone who
|
|
sent translations!
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
<h2>0.9.4</h2>
|
|
|
|
<h3>New stuff</h3>
|
|
|
|
<ul>
|
|
|
|
<li>Supports time selection. Yes. ;-) This work has been largely
|
|
sponsored by <strong>Himanshukumar Shah</strong> (thank you!). See
|
|
the docs and example files for details on how to setup.</li>
|
|
|
|
<li>Easy to link 2 or more fields by using the new
|
|
<code>onUpdate</code> parameter of <code>Calendar.setup</code>. This
|
|
is useful, say, to automatically set a value in a second field based
|
|
on the value selected in the first field. See the documentation and
|
|
first sample in <a href="simple-1.html">simple-1.html</a>.</li>
|
|
|
|
<li>Other <code>Calendar.setup</code> low-level parameters, for those
|
|
wanting to have the complete control: <code>onSelect</code> and
|
|
<code>onClose</code>. The handlers are called when something is
|
|
selected in the calendar or when the calendar is closed.</li>
|
|
|
|
<li>The translation files can optionally include the short day names
|
|
and the short month names. That's because in some languages, like
|
|
German, the short form is not the first 3 letters of the entire name
|
|
but only the first 2. Also in other languages short names can't be
|
|
as easily derived from the full name by just calling substr, so this
|
|
patch solves the problem.</li>
|
|
|
|
<li>Implemented a nice way to make some dates "special" (look
|
|
different). Specifically, the <code>setDisabledHandler</code> method
|
|
was replaced with the more general <code>setDateStatusHandler</code>
|
|
method (the old one is still available for backwards compatibility but
|
|
<em>will</em> be removed). More details about this in the
|
|
documentation. Also see <a href="simple-3.html">simple-3.html</a>
|
|
for a live sample.</li>
|
|
|
|
<li>Date parsing and formatting engine is now rewritten and supports a
|
|
subset of <code>strftime</code> format specifiers from ANSI C. This
|
|
makes it possible to use dates like "YYYYMMDD" (the corresponding
|
|
format for this would be "%Y%m%d"). Details in the documentation.
|
|
<b>Please note that the new engine is not compatibile with older
|
|
calendar releases!</b></li>
|
|
|
|
<li>Along with the new date parser I workarounded an unpleasant crash
|
|
that occurred in IE when certain accented characters appeared in the
|
|
texts. I think German was one of the language with such problems, and
|
|
the workaround was to use the letter without an accent. Well, now you
|
|
can translate to whatever you want.</li>
|
|
|
|
<li>"Fixes" (I mean, "horrible workarounds") for Konqueror (and
|
|
hopefully Safari). Unfortunately, this otherwise excellent browser
|
|
still has some bugs that keep the calendar from working
|
|
<em>exactly</em> as it should.. But they're going to be fixed,
|
|
right? ;-)</li>
|
|
|
|
<li>CSS themes got pretty much modified too so if you wrote your theme
|
|
you need to update it. Aside for the time selector support, the CSS
|
|
themes contain a simple hack that makes the navigation buttons show
|
|
a little arrow in the lower-right corner which indicates that if one
|
|
holds the mouse a menu will appear.</li>
|
|
|
|
</ul>
|
|
|
|
<h3>Translation files</h3>
|
|
|
|
<p>The translation files need to be updated in order for the calendar to
|
|
work properly. Currently the only updated files are calendar-en.js
|
|
(main file) and calendar-ro.js (well, yes, I am a Romanian ;-).</p>
|
|
|
|
<p>Specifically, they need the following:</p>
|
|
|
|
<ul>
|
|
|
|
<li>Correct date format, according with the new format specifiers
|
|
introduced in 0.9.4. Details about the available format specifiers
|
|
in the documentation</li>
|
|
|
|
<li>Short day or month names, <em>if required</em>. If they can be
|
|
derived by taking the first N letters of the full name then a simple
|
|
Calendar._SDN_len = N or Calendar._SMN_len = N will suffice. If N
|
|
is 3 then nothing needs to be done as we take it for granted if no
|
|
other option is offered ;-)</li>
|
|
|
|
<li>We have some new texts that shows short usage information as well
|
|
as copyright information.</li>
|
|
|
|
</ul>
|
|
|
|
<p>If your favorite language is not there yet, or it is but not updated
|
|
according to the main calendar-en.js file, then please consider
|
|
translating calendar-en.js and send the translation back to me so that
|
|
I include it in the official distribution.</p>
|
|
|
|
<h3>Bug status</h3>
|
|
|
|
<p>Check <a
|
|
href="http://sourceforge.net/tracker/?atid=544285&group_id=75569&func=browse">SourceForge</a>,
|
|
I didn't keep track. However, there were a lot of bugfixes.</p>
|
|
|
|
<h2>0.9.3</h2>
|
|
|
|
<h3>New stuff</h3>
|
|
|
|
<ul>
|
|
|
|
<li>Opera 7 compatibility — keyboard navigation is
|
|
still not available; text selection can't be disabled, leading to an
|
|
ugly effect when walking through the month/year menus.</li>
|
|
|
|
<li>Ability to align the calendar relative to the input field (or any
|
|
other element). Vertical: top, center, bottom. Horizontal: left,
|
|
center, right. This is established as a new parameter for
|
|
<tt>showAtElement</tt>.</li>
|
|
|
|
<li>Added <tt>dateClicked</tt> property (boolean). This can be
|
|
inspected in the "onSelect" handler to determine if a date was
|
|
really clicked or the user only changed month/year using the menus.
|
|
You <em>need</em> to check this for "single-click" calendars and
|
|
only close/hide the calendar if it's <tt>true</tt>.</li>
|
|
|
|
<li>Full documentation in <a href="doc/html/reference.html">HTML</a>
|
|
and <a href="doc/reference.pdf">PDF</a> format is now available in the
|
|
distribution archive.</li>
|
|
|
|
<li>New language definition files: HU, HR, PT, ZH. Thanks those who
|
|
submitted!</li>
|
|
|
|
</ul>
|
|
|
|
<h3>Bug status</h3>
|
|
|
|
<p>This covers only those bugs that have been reported <a
|
|
href="http://sourceforge.net/projects/jscalendar" target="_blank"
|
|
title="Project page at SourceForge">at SourceForge</a>.</p>
|
|
|
|
<ol>
|
|
|
|
<li><a href="http://sourceforge.net/tracker/index.php?func=detail&aid=703238&group_id=75569&atid=544285" target="_blank"
|
|
title="Go to bug description at sourceforge"><tt>#703,238</tt></a> — fixed</li>
|
|
<li><a href="http://sourceforge.net/tracker/index.php?func=detail&aid=703814&group_id=75569&atid=544285" target="_blank"
|
|
title="Go to bug description at sourceforge"><tt>#703,814</tt></a> — fixed</li>
|
|
<li><a href="http://sourceforge.net/tracker/index.php?func=detail&aid=716777&group_id=75569&atid=544285" target="_blank"
|
|
title="Go to bug description at sourceforge"><tt>#716,777</tt></a> — closed (was fixed already in 0.9.2-1)</li>
|
|
<li><a href="http://sourceforge.net/tracker/index.php?func=detail&aid=723335&group_id=75569&atid=544285" target="_blank"
|
|
title="Go to bug description at sourceforge"><tt>#723,335</tt></a> — fixed</li>
|
|
<li><a href="http://sourceforge.net/tracker/index.php?func=detail&aid=715122&group_id=75569&atid=544285" target="_blank"
|
|
title="Go to bug description at sourceforge"><tt>#715,122</tt></a> — feature request; implemented.</li>
|
|
<li><a href="http://sourceforge.net/tracker/index.php?func=detail&aid=721206&group_id=75569&atid=544285" target="_blank"
|
|
title="Go to bug description at sourceforge"><tt>#721,206</tt></a> — fixed (added "refresh()" function)</li>
|
|
<li><a href="http://sourceforge.net/tracker/index.php?func=detail&aid=721833&group_id=75569&atid=544285" target="_blank"
|
|
title="Go to bug description at sourceforge"><tt>#721,833</tt></a> — fixed (bug concerning the "yy" format
|
|
parsing)</li>
|
|
<li><a href="http://sourceforge.net/tracker/index.php?func=detail&aid=721833&group_id=75569&atid=544285" target="_blank"
|
|
title="Go to bug description at sourceforge"><tt>#721,833</tt></a> — won't fix (we won't set the time to
|
|
midnight; time might actually be useful when we implement support
|
|
for time selection).
|
|
|
|
</ol>
|
|
|
|
<hr />
|
|
<address><a href="http://dynarch.com/mishoo/">Mihai Bazon</a></address>
|
|
<!-- Created: Tue Jul 8 17:29:37 EEST 2003 -->
|
|
<!-- hhmts start -->
|
|
Last modified on Wed Oct 29 02:37:07 2003
|
|
<!-- hhmts end -->
|
|
<!-- doc-lang: English -->
|
|
</body>
|
|
</html>
|
|
|
|
|