Initial commit
[eevladatepicker.git] / README
1 eeVlaDatePickerPlugin
2 =====================
3
4 Description
5 -----------
6
7 This plugins eases the use of the rich
8 [Javascript Vista-Like Ajax (Vla) Date Picker widget](http://dev.base86.com/scripts/vista-like_ajax_calendar_version_2.html)
9 in Symfony.
10
11 This plugin uses the
12 [clientside-only version of the widget](http://dev.base86.com/solo/46/client-side_only_extension_for_vlacalendar_v21.html).
13 That means that the contents of the widget are handled by Javascript
14 on the client and not by PHP or whatever.
15
16 Installation
17 ------------
18
19     $ symfony plugin:install eeVlaDatePickerPlugin
20     $ symfony cache:clear
21
22 Usage
23 -----
24
25 Example:
26
27     $this->widgetSchema['date'] = new eeWidgetFormDateVlaDatePicker();
28
29 You can use a standard sfValidatorDate to specify the string format:
30
31     $this->validatorSchema['date']->setOption(
32         'date_format',
33         '@(?P<day>\d{1,2}).(?P<month>\d{1,2}).(?P<year>\d{4})@'
34     );
35
36 i18n
37 ----
38
39 Internalisation is possible but not supported by original widget (please tell me
40 if I am wrong).
41
42 French translation is already done, and you can use it as an example if you want
43 to add another language.
44
45 Contact
46 -------
47
48 If you have any questions feel free to contact me (see the Plugin Information tab).