date_elements.inc in Date 6
Same filename and directory in other branches
Date forms and form themes and validation.
All code used in form editing and processing is in this file, included only during form editing.
File
date/date_elements.incView source
<?php
/**
* @file
* Date forms and form themes and validation.
*
* All code used in form editing and processing is in this file,
* included only during form editing.
*/
/**
* Private implementation of hook_field validate operation.
*/
function _date_field_validate($op, &$node, $field, &$items, $teaser, $page) {
$field_name = $field['field_name'];
// Don't try to validate if there were any errors before this point
// since the element won't have been munged back into a date.
if (!form_get_errors()) {
foreach ($items as $delta => $item) {
$process = date_process_values($field);
foreach ($process as $processed) {
$error_field = $field['field_name'] . '][' . $delta . '][' . $processed;
$error_field .= $field['widget']['type'] == 'date_select' ? '][year' : '';
if ($processed == 'value' && $field['todate'] && !date_is_valid($item['value'], $field['type']) && date_is_valid($item['value2'], $field['type'])) {
form_set_error($error_field, t("A 'From date' date is required for %field %delta", array(
'%delta' => $field['multiple'] ? intval($delta + 1) : '',
'%field' => t($field['widget']['label']),
)));
}
if ($processed == 'value2' && $field['todate'] == 'required' && ($field['required'] && date_is_valid($item['value'], $field['type']) && !date_is_valid($item['value2'], $field['type']))) {
form_set_error($error_field, t("A 'To date' is required for %field %delta", array(
'%delta' => $field['multiple'] ? intval($delta + 1) : '',
'%field' => t($field['widget']['label']),
)));
}
}
}
}
}
/**
* Private implementation of hook_field update and insert operations.
*/
function _date_field_update($op, &$node, $field, &$items, $teaser, $page) {
$field_name = $field['field_name'];
$format = $field['type'] == DATE_ISO ? DATE_FORMAT_ISO : DATE_FORMAT_UNIX;
$timezone = date_get_timezone($field['tz_handling'], $items[0]['timezone']);
$db_info = content_database_info($field);
$columns = array_keys($db_info['columns']);
$values = $items;
foreach ($values as $delta => $item) {
// Don't save empty values.
if (empty($item['value']) && $delta !== 0) {
unset($items[$delta]);
}
// For convenience, we process all possible columns in the element,
// but now we need to remove columns not used by this field.
if (is_array($item)) {
$keys = array_keys($item);
foreach ($keys as $column => $value) {
if (!in_array($column, $columns)) {
unset($items[$delta][$column]);
}
}
}
// Special case for ISO dates which may have been given artificial values for
// some date parts to make them into valid dates.
if ($field['type'] == DATE_ISO) {
$items[$delta]['value'] = date_limit_value($items[$delta]['value'], date_granularity($field), $field['type']);
if ($field['todate']) {
$items[$delta]['value2'] = date_limit_value($items[$delta]['value2'], date_granularity($field), $field['type']);
}
}
}
$node->{$field}['field_name'] = $items;
}
/**
* Private implementation of hook_widget().
*
* The widget builds out a complex date element in the following way:
*
* - A field is pulled out of the database which is comprised of one or
* more collections of from/to dates.
*
* - The dates in this field are all converted from the UTC values stored
* in the database back to the local time before passing their values
* to FAPI.
*
* - If values are empty, the field settings rules are used to determine
* if the default_values should be empty, now, the same, or use strtotime.
*
* - Each from/to combination is created using the date_combo element type
* defined by the date module. If the timezone is date-specific, a
* timezone selector is added to the first combo element.
*
* - If repeating dates are defined, a form to create a repeat rule is
* added to the field element.
*
* - The date combo element creates two individual date elements, one each
* for the from and to field, using the appropriate individual Date API
* date elements, like selects, textfields, or popups.
*
* - In the individual element validation, the data supplied by the user is
* used to update the individual date values.
*
* - In the combo date validation, the timezone is updated, if necessary,
* then the user input date values are used with that timezone to create
* date objects, which are used update combo date timezone and offset values.
*
* - In the field's submission processing, the new date values, which are in
* the local timezone, are converted back to their UTC values and stored.
*
*/
function _date_widget(&$form, &$form_state, &$field, $items, $delta = 0) {
// If this is a multiple value form, get the Content module's
// multiple value form with its AHAH add more element and return that.
// Set a flag so we know to skip this step when the
// content_multiple_value_form() re-invokes this widget.
if (empty($field['repeat']) && empty($field['multiple_form'])) {
$field_copy = $field;
$field_copy['multiple_form'] = TRUE;
return content_multiple_value_form($form, $form_state, $field_copy, $items);
}
include_once drupal_get_path('module', 'date_api') . '/date_api_elements.inc';
$timezone = date_get_timezone($field['tz_handling'], isset($items[0]['timezone']) ? $items[0]['timezone'] : date_default_timezone_name());
// Convert UTC dates to their local values in DATETIME format,
// and adjust the default values as specified in the field settings.
// It would seem to make sense to do this conversion when the data
// is loaded instead of when the form is created, but the loaded
// field data is cached and we can't cache dates that have been converted
// to the timezone of an individual user, so we cache the UTC values
// instead and do our conversion to local dates in the form and
// in the formatters.
$process = date_process_values($field);
foreach ($process as $processed) {
if (!isset($items[$delta][$processed])) {
$items[$delta][$processed] = '';
}
$date = date_local_date($delta, $items[$delta], $timezone, $field, $processed);
$items[$delta][$processed] = is_object($date) ? date_format($date, DATE_FORMAT_DATETIME) : '';
}
$element = array(
'#type' => 'date_combo',
'#weight' => $delta,
'#default_value' => isset($items[$delta]) ? $items[$delta] : '',
'#date_timezone' => $timezone,
'#element_validate' => array(
'date_combo_validate',
'date_widget_validate',
),
);
if ($field['tz_handling'] == 'date' && $delta == 0) {
$element['timezone'] = array(
'#type' => $delta == 0 ? 'date_timezone' : 'hidden',
'#delta' => $delta,
'#default_value' => $timezone,
'#weight' => $delta + 0.2,
);
}
// Add a date repeat form element, if needed.
if (module_exists('date_repeat') && $field['repeat'] == 1) {
include_once drupal_get_path('module', 'date') . '/date_repeat.inc';
$element = array_merge($element, _date_repeat_widget($element, $field, $items, $delta));
}
return $element;
}
/**
* Create local date object.
*
* Create a date object set to local time from the field and
* widget settings and item values, using field settings to
* determine what to do with empty values.
*/
function date_local_date($delta, $item, $timezone, $field, $part = 'value') {
if ($part == 'value') {
$default_value = $field['widget']['default_value'];
$default_value_code = $field['widget']['default_value_code'];
}
else {
$default_value = $field['widget']['default_value2'];
$default_value_code = $field['widget']['default_value_code2'];
}
if (empty($item[$part])) {
if (empty($default_value) || $default_value == 'blank') {
return NULL;
}
elseif ($part == 'value2' && $default_value == 'same' && !empty($item['value'])) {
$date = date_make_date($item['value'], $timezone);
}
elseif ($field['tz_handling'] == 'none') {
$date = date_make_date('now', date_default_timezone_name());
}
else {
$date = date_make_date('now', $timezone);
}
}
else {
$value = $item[$part];
// Special case for ISO dates to create a valid date object for formatting.
if ($field['type'] == DATE_ISO) {
$value = date_fuzzy_datetime($value);
}
else {
$value = date_convert($value, $field['type'], DATE_DATETIME);
}
$date = date_make_date($value, 'UTC');
if (date_timezone_convert($field, $item)) {
date_timezone_set($date, timezone_open($timezone));
}
}
if (is_object($date) && empty($item[$part]) && $default_value == 'strtotime' && !empty($default_value_code)) {
date_modify($date, $default_value_code);
}
return $date;
}
/**
* Implementation of hook_elements().
*
* date_combo will create a 'from' and optional 'to' date, along with
* an optional 'timezone' column for date-specific timezones. Each
* 'from' and 'to' date will be constructed from date_select or date_text.
*/
function _date_elements() {
$type = array();
$type['date_combo'] = array(
'#input' => TRUE,
'#delta' => 0,
'#columns' => array(
'value',
'value2',
'timezone',
'offset',
'offset2',
),
'#process' => array(
'date_combo_process',
),
'#element_validate' => array(
'date_combo_validate',
),
);
return $type;
}
/**
* Process an individual date element.
*/
function date_combo_process($element, $edit, &$form_state, $form) {
$field_name = $element['#field_name'];
$field = $form['#field_info'][$field_name];
$delta = $element['#delta'];
$columns = $element['#columns'];
if (isset($columns['rrule'])) {
unset($columns['rrule']);
}
$from_field = 'value';
$to_field = 'value2';
$tz_field = 'timezone';
$offset_field = 'offset';
$offset_field2 = 'offset2';
if ($field['todate'] != 'required' && !empty($element['#default_value'][$to_field]) && $element['#default_value'][$to_field] == $element['#default_value'][$from_field]) {
unset($element['#default_value'][$to_field]);
}
$element[$from_field] = array(
'#field' => $field,
'#title' => t($field['widget']['label']),
'#weight' => $field['widget']['weight'],
'#description' => empty($field['todate']) ? t($field['widget']['description']) : '',
'#required' => $field['required'] && $delta == 0 ? 1 : 0,
'#default_value' => isset($element['#value'][$from_field]) ? $element['#value'][$from_field] : '',
'#field' => $field,
'#delta' => $delta,
'#date_timezone' => $element['#date_timezone'],
'#date_format' => date_limit_format(date_input_format($element, $field), $field['granularity']),
'#date_text_parts' => (array) $field['widget']['text_parts'],
'#date_increment' => $field['widget']['increment'],
'#date_year_range' => $field['widget']['year_range'],
'#date_label_position' => $field['widget']['label_position'],
);
$element[$from_field]['#description'] .= ' ' . t('Format: @date', array(
'@date' => date($element[$from_field]['#date_format'], time()),
));
// Give this element the right type, using a Date API
// or a Date Popup element type.
switch ($field['widget']['type']) {
case 'date_select':
$element[$from_field]['#type'] = 'date_select';
break;
case 'date_popup':
$element[$from_field]['#type'] = 'date_popup';
break;
default:
$element[$from_field]['#type'] = 'date_text';
break;
}
// If this field uses the 'To', add matching element
// for the 'To' date, and adapt titles to make it clear which
// is the 'From' and which is the 'To'.
if ($field['todate']) {
$element[$from_field]['#title'] = t('From date');
$element[$to_field] = $element[$from_field];
$element[$to_field]['#title'] = t('To date');
$element[$to_field]['#default_value'] = isset($element['#value'][$to_field]) ? $element['#value'][$to_field] : '';
$element[$to_field]['#required'] = false;
$element[$to_field]['#weight'] += 0.1;
$element[$to_field]['#description'] = t('Empty \'To date\' values will use the \'From date\' values.');
$element['#fieldset_description'] = t($field['widget']['description']);
}
// Make sure field info will be available to the validator which
// does not get the values in $form.
$form_state['#field_info'][$field['field_name']] = $field;
return $element;
}
/**
* Validate and update a combo element.
* Don't try this if there were errors before reaching this point.
*/
function date_combo_validate($element, &$form_state) {
$form_values = $form_state['values'];
$field_name = $element['#field_name'];
$delta = $element['#delta'];
$item = $form_values[$field_name][$delta];
$field = $form_state['#field_info'][$element['#field_name']];
$delta = $element['#delta'];
$from_field = 'value';
$to_field = 'value2';
$tz_field = 'timezone';
$offset_field = 'offset';
$offset_field2 = 'offset2';
// Update the timezone, if changed.
$timezone = $element['#date_timezone'];
if (!empty($form_values['timezone']) && $form_values[$field_name]['timezone'] != $element['#date_timezone']) {
$timezone = $form_values[$field_name]['timezone'];
}
if (empty($item[$from_field])) {
$item[$from_field] = NULL;
$item[$to_field] = NULL;
$item[$tz_field] = $timezone;
$item[$offset_field] = NULL;
$item[$offset_field2] = NULL;
form_set_value($element, $item, $form_state);
}
elseif (!form_get_errors()) {
// Check todate input for blank values and substitute in fromdate
// values where needed, then re-compute the todate with those values.
if ($field['todate']) {
$merged_date = array();
foreach ($element['#post'][$field_name][$delta][$to_field] as $part => $value) {
$merged_date[$part] = empty($value) ? $element['#post'][$field_name][$delta][$from_field][$part] : $value;
if ($part == 'ampm' && $merged_date['ampm'] == 'pm' && $merged_date['hour'] < 12) {
$merged_date['hour'] += 12;
}
elseif ($part == 'ampm' && $merged_date['ampm'] == 'am' && $merged_date['hour'] == 12) {
$merged_date['hour'] -= 12;
}
}
$element[$to_field]['#value'] = $merged_date;
// Call the right function to turn this altered user input into
// a new value for the todate.
$function = $field['widget']['type'] . '_input_value';
$to_date = $function($element[$to_field]);
$item[$to_field] = $to_date;
}
else {
$item[$to_field] = $item[$from_field];
}
if ($item[$from_field] > $item[$to_field]) {
form_set_error(implode('][', $element['#parents']), t('The To date must be greater than the From date.'));
}
else {
// Convert input dates back to their UTC values and re-format to ISO
// or UNIX instead of the DATETIME format used in element processing.
if (date_timezone_convert($field, $item)) {
$item[$tz_field] = $timezone;
$from_date = date_make_date($item[$from_field], $timezone);
$item[$offset_field] = date_offset_get($from_date);
$to_date = date_make_date($item[$to_field], $timezone);
$item[$offset_field2] = date_offset_get($to_date);
date_timezone_set($from_date, timezone_open('UTC'));
date_timezone_set($to_date, timezone_open('UTC'));
$item[$from_field] = date_format($from_date, date_type_format($field['type']));
$item[$to_field] = date_format($to_date, date_type_format($field['type']));
}
else {
$item[$from_field] = date_convert($item[$from_field], DATE_DATETIME, $field['type']);
$item[$to_field] = date_convert($item[$to_field], DATE_DATETIME, $field['type']);
}
$item['rrule'] = $rrule;
form_set_value($element, $item, $form_state);
}
}
}
/**
* Handle widget processing.
*/
function date_widget_validate($element, &$form_state) {
$form_values = $form_state['values'];
$field_name = $element['#field_name'];
$fields = content_fields();
$field = $form_state['#field_info'][$element['#field_name']];
if (module_exists('date_repeat') && array_key_exists('rrule', $form_values[$field_name])) {
include_once drupal_get_path('module', 'date') . '/date_repeat.inc';
return _date_repeat_widget_validate($element, $form_state);
}
}
/**
* Determine the input format for this element.
*/
function date_input_format($element, $field) {
if (!empty($field['widget']['input_format_custom'])) {
return $field['widget']['input_format_custom'];
}
elseif (!empty($field['widget']['input_format']) && $field['widget']['input_format'] != 'site-wide') {
return $field['widget']['input_format'];
}
return variable_get('date_format_short', 'm/d/Y - H:i');
}
/**
* Theme from/to date combination on form.
*/
function theme_date_combo($element) {
$fields = content_fields();
$field = $fields[$element['#field_name']];
if (!$field['todate']) {
return $element['#children'];
}
// Group from/to items together in fieldset.
$fieldset = array(
'#title' => $field['widget']['label'] . ' ' . ($element['#delta'] > 0 ? intval($element['#delta'] + 1) : ''),
'#value' => $element['#children'],
'#collapsible' => FALSE,
'#collapsed' => FALSE,
'#description' => $element['#fieldset_description'],
'#attributes' => array(),
);
return theme('fieldset', $fieldset);
}Functions
Name |
Description |
|---|---|
| date_combo_process | Process an individual date element. |
| date_combo_validate | Validate and update a combo element. Don't try this if there were errors before reaching this point. |
| date_input_format | Determine the input format for this element. |
| date_local_date | Create local date object. |
| date_widget_validate | Handle widget processing. |
| theme_date_combo | Theme from/to date combination on form. |
| _date_elements | Implementation of hook_elements(). |
| _date_field_update | Private implementation of hook_field update and insert operations. |
| _date_field_validate | Private implementation of hook_field validate operation. |
| _date_widget | Private implementation of hook_widget(). |