usability: add guidance for calendar fields format

- Date of birth field in "My Resume"
- View access start/stop date
Signed-off-by: Evan Goldenberg <evang@catalyst.net.nz>
Signed-off-by: Francois Marier <francois@catalyst.net.nz>

htdocs/artefact/resume/index.php

@@ -162,6 +162,7 @@ $personalinformationform = pieform(array(
                     'defaultvalue' => ((!empty($personalinformation)) 
                         ? $personalinformation->get_composite('dateofbirth') : null),
                     'title' => get_string('dateofbirth', 'artefact.resume'),
+                    'description' => get_string('dateformatguide'),
                     'help'  => true,
                 ),
                 'placeofbirth' => array(

htdocs/lang/en.utf8/mahara.php

@@ -96,6 +96,8 @@ $string['sortalpha'] = 'Sort tags alphabetically';
 $string['sortfreq'] = 'Sort tags by frequency';
 $string['sortresultsby'] = 'Sort results by:';
 $string['date'] = 'Date';
+$string['dateformatguide'] = 'Use the format YYYY/MM/DD';
+$string['datetimeformatguide'] = 'Use the format YYYY/MM/DD HH:MM';
 $string['filterresultsby'] = 'Filter results by:';
 $string['tagfilter_all'] = 'All';
 $string['tagfilter_file'] = 'Files';

htdocs/theme/raw/templates/form/viewacl.tpl

@@ -67,6 +67,10 @@ function renderAccessListItem(item) {
             TR(null,
                 TH(null, get_string('To') + ':'),
                 TD(null, makeCalendarInput(item, 'stop'), makeCalendarLink(item, 'stop'))
+            ),
+            TR(null,
+                TH(null, null),
+                TD(null, get_string('datetimeformatguide'))
             )
         )
     );

htdocs/view/access.php

@@ -187,6 +187,7 @@ $form['elements']['overrides'] = array(
         'startdate'        => array(
             'type'         => 'calendar',
             'title'        => get_string('startdate','view'),
+            'description'  => get_string('datetimeformatguide'),
             'defaultvalue' => isset($view) ? strtotime($view->get('startdate')) : null,
             'caloptions'   => array(
                 'showsTime'      => true,
@@ -197,6 +198,7 @@ $form['elements']['overrides'] = array(
         'stopdate'  => array(
             'type'         => 'calendar',
             'title'        => get_string('stopdate','view'),
+            'description'  => get_string('datetimeformatguide'),
             'defaultvalue' => isset($view) ? strtotime($view->get('stopdate')) : null,
             'caloptions'   => array(
                 'showsTime'      => true,
@@ -404,7 +406,7 @@ function editaccess_submit(Pieform $form, $values) {
 
 $form = pieform($form);
 
-$smarty = smarty(array('tablerenderer'), array(), array('mahara' => array('From', 'To')), array('sidebars' => false));
+$smarty = smarty(array('tablerenderer'), array(), array('mahara' => array('From', 'To', 'datetimeformatguide')), array('sidebars' => false));
 $smarty->assign('INLINEJAVASCRIPT', $js);
 $smarty->assign('PAGEHEADING', hsc(TITLE));
 $smarty->assign('form', $form);