-
-
+the main program file (calendar.js). This defines all the logic -behind the calendar widget.
--
+behind the calendar widget.the CSS files (calendar-*.css). Loading one of them is -necessary in order to see the calendar as intended.
--
+necessary in order to see the calendar as intended.the language definition files (lang/calendar-*.js). They are plain JavaScript files that contain all texts that are displayed by the -calendar. Loading one of them is necessary.
--
+calendar. Loading one of them is necessary.helper functions for quick setup of the calendar (calendar-setup.js). You can do fine without it, but starting with -version 0.9.3 this is the recommended way to setup a calendar.
--
+version 0.9.3 this is the recommended way to setup a calendar.@@ -911,54 +906,43 @@ same). While you can skip optional (marked ``opt'') steps if you're happy with the defaults, please respect the order below.
-
-
+Instantiate a Calendar object. Details about this in -section 5.1.
--
+section 5.1.opt Set the weekNumbers property to false if you don't want -the calendar to display week numbers.
--
+the calendar to display week numbers.opt Set the showsTime property to true if you -want the calendar to also provide a time selector.
--
+want the calendar to also provide a time selector.opt Set the time24 property to false if you want the time selector to be in 12-hour format. Default is 24-hour format. This property only has effect if you also set showsTime to -true.
--
+true.opt Set the range of years available for selection (see section -5.3.15). The default range is [1970..2050].
--
+5.3.15). The default range is [1970..2050].opt Set the getDateStatus property. You should pass here a function that receives a JavaScript Date object and returns true if the given date should be disabled, false otherwise (details in -section 5.3.7).
--
+section 5.3.7).opt Set a date format. Your handler function, passed to the calendar constructor, will be called when a date is selected with a reference -to the calendar and a date string in this format.
--
+to the calendar and a date string in this format.Create the HTML elements related to the calendar. This step practically puts the calendar in your HTML page. You simply call Calendar.create(). You can give an optional parameter if you wanna -create a flat calendar (details in section 5.3.1).
--
+create a flat calendar (details in section 5.3.1).opt Initialize the calendar to a certain date, for instance from -the input field.
--
-Show the calendar (details in section 5.3.9).
--
+the input field.Show the calendar (details in section 5.3.9).
@@ -1012,17 +996,13 @@ up the calendar again to create another one. This approach is bad for more reasons:
-
-
-creating the JavaScript object and HTML elements is time-consuming
--
+creating the JavaScript object and HTML elements is time-consuming
we may loose some end-user preferences (i.e. he might prefer to have Monday for the first day of week and probably already clicked it the first time -when the calendar was opened, but now he has to do it again)
--
-The second approach, implemented by the Calendar.setup function, is to cache the JavaScript object. It does this by checking the global variable @@ -1056,17 +1036,14 @@ making a truly reusable thing.
The calendar supports the following user callbacks:-
-
+onSelect -- this gets called when the end-user changes the date in the -calendar. Documented in section 5.1.
--
+calendar. Documented in section 5.1.onClose -- this gets called when the calendar should close. It's user's responsibility to close the calendar. Details in section -5.1.
--
+5.1.getDateStatus -- this function gets called for any day in a month, just before displaying the month. It is called with a JavaScript Date object and should return true if that date should be disabled, false @@ -1074,10 +1051,8 @@ if it's an ordinary date and no action should be taken, or it can return a string in which case the returned value will be appended to the element's CSS class (this way it provides a powerful way to make some dates ``special'', i.e. highlight them differently). Details in section -5.3.8.
--
-@@ -1098,27 +1073,20 @@ Synopsis: Parameters are as follows:
-
-
+firstDayOfWeek -- specifies which day is to be displayed as the first day of week. Possible values are 0 to 6; 0 means Sunday, 1 means Monday, -..., 6 means Saturday.
--
+..., 6 means Saturday.date -- a JavaScript Date object or null. If null is passed then the calendar will default to today date. Otherwise it will -initialize on the given date.
--
-onSelect -- your callback for the ``onChange'' event. See above.
--
-onClose -- your callback for the ``onClose'' event. See above.
--
--
+initialize on the given date. + +onSelect -- your callback for the ``onChange'' event. See above.
onClose -- your callback for the ``onClose'' event. See above.
-
-
+date -- is a JavaScript Date object. It will always -reflect the date shown in the calendar (yes, even if the calendar is hidden).
--
+reflect the date shown in the calendar (yes, even if the calendar is hidden).isPopup -- if this is true then the current Calendar object is a popup calendar. Otherwise (false) we have a flat calendar. This variable is set from Calendar.create and has no meaning before this function was -called.
--
+called.dateClicked -- particularly useful in the onSelect handler, this variable tells us if a date was really clicked. That's because the onSelect handler is called even if the end-user only changed the month/year but did not select a date. We don't want to close the calendar in -that case.
--
+that case.weekNumbers -- if true (default) then the calendar displays week numbers. If you don't want week numbers you have to set this -variable to false before calling Calendar.create.
--
+variable to false before calling Calendar.create.showsTime - if you set this to true (it is -false by default) then the calendar will also include a time selector.
--
+false by default) then the calendar will also include a time selector.time24 - if you set this to false then the time -selector will be in 12-hour format. It is in 24-hour format by default.
--
+selector will be in 12-hour format. It is in 24-hour format by default.firstDayOfWeek -- specifies the first day of week (0 to 6, pass 0 for Sunday, 1 for Monday, ..., 6 for Saturday). This variable is set from constructor, but you still have a chance to modify it before calling -Calendar.create.
--
-There are lots of other member variables, but one should access them only through member functions so I won't document them here.
@@ -1504,61 +1464,44 @@ the position it uses Calendar.showAt to display the calendar there.The first character in ``align'' can take one of the following values:
-
-
+T -- completely above the reference element (bottom margin of -the calendar aligned to the top margin of the element).
--
+the calendar aligned to the top margin of the element).t -- above the element but may overlap it (bottom margin of the calendar aligned to -the bottom margin of the element).
--
+the bottom margin of the element).c -- the calendar displays vertically centered to the reference -element. It might overlap it (that depends on the horizontal alignment).
--
+element. It might overlap it (that depends on the horizontal alignment).b -- below the element but may overlap it (top margin of the calendar aligned to -the top margin of the element).
--
+the top margin of the element).B -- completely below the element (top margin of the calendar -aligned to the bottom margin of the element).
--
--
+aligned to the bottom margin of the element). +The second character in ``align'' can take one of the following values:
-
-
+L -- completely to the left of the reference element (right -margin of the calendar aligned to the left margin of the element).
--
+margin of the calendar aligned to the left margin of the element).l -- to the left of the element but may overlap it (left margin -of the calendar aligned to the left margin of the element).
--
+of the calendar aligned to the left margin of the element).c -- horizontally centered to the element. Might overlap it, -depending on the vertical alignment.
--
+depending on the vertical alignment.r -- to the right of the element but may overlap it (right -margin of the calendar aligned to the right margin of the element).
--
+margin of the calendar aligned to the right margin of the element).R -- completely to the right of the element (left margin of the -calendar aligned to the right margin of the element).
--
--
+calendar aligned to the right margin of the element). +If the ``align'' parameter is missing the calendar will choose @@ -1622,59 +1565,47 @@ Sets the range of years that are allowed in the calendar. Synopsis:
less as possible side effects. However, there are some -- not harmful, after all. Here is a list of side effects; you can count they already happened after calendar.js was loaded. --
--
+ +The global variable window.calendar will be set to null. This variable is used by the calendar code, especially when doing drag & drop for moving the calendar. In the future I might get rid of it, but for now it -didn't harm anyone.
--
+didn't harm anyone.The JavaScript Date object is modified. We add some properties and functions that are very useful to our calendar. It made more sense to add them directly to the Date object than to the calendar itself. -Complete list:
--
--
+Complete list:Date._MD = new Array(31,28,31,30,31,30,31,31,30,31,30,31); -
+Date.SECOND = 1000 /* milliseconds */; -
+Date.MINUTE = 60 * Date.SECOND; -
+Date.HOUR = 60 * Date.MINUTE; -
+Date.DAY = 24 * Date.HOUR; -
-Date.WEEK = 7 * Date.DAY;
--
+Date.WEEK = 7 * Date.DAY;
Date.prototype.getMonthDays(month) -- returns the number of days -of the given month, or of the current date object if no month was given.
--
+of the given month, or of the current date object if no month was given.Date.prototype.getWeekNumber() -- returns the week number of the -date in the current object.
--
+date in the current object.Date.prototype.equalsTo(other_date) -- compare the current date object with other_date and returns true if the dates are -equal. It ignores time.
--
+equal. It ignores time.Date.prototype.print(format) -- returns a string with the current date object represented in the given format. It implements the format -specified in section 5.3.5.
--
--
-@@ -1686,24 +1617,18 @@ feature and pay me for implementing it) or donate some money please please contact me at mihai_bazon@yahoo.com.
-
-
-Sunny Chowdhury (www.ex3.com)
--
-Ian Barrack (www.simban.com)
--
-Himanshukumar Shah
--
-Seyhan Ersoy (www.oocgi.com)
--
-Jon Stokkeland (www.sauen.com)
--
-Sunny Chowdhury (www.ex3.com)
Ian Barrack (www.simban.com)
Himanshukumar Shah
Seyhan Ersoy (www.oocgi.com)
Jon Stokkeland (www.sauen.com)
|
diff --git a/htdocs/install/fileconf.php b/htdocs/install/fileconf.php
index d7b71f58029..b9cacb692f1 100644
--- a/htdocs/install/fileconf.php
+++ b/htdocs/install/fileconf.php
@@ -114,8 +114,10 @@ if(! isset($dolibarr_main_url_root) || strlen($dolibarr_main_url_root) == 0)
print $langs->trans("WithNoSlashAtTheEnd")." "; print $langs->trans("Examples").": "; ?> +
|