t('Format:'), '#type' => 'select', '#options' => date_format_type_options(), '#default_value' => $settings['format_type'], '#weight' => 0, ); $form['fromto'] = array( '#title' => t('Display:'), '#type' => 'select', '#options' => array( 'both' => t('Both From and To dates'), 'value' => t('From date only'), 'value2' => t('To date only'), ), '#access' => $field['settings']['todate'], '#default_value' => $settings['fromto'], '#weight' => 1, ); // Make the string translatable by keeping it as a whole rather than // translating prefix and suffix separately. list($prefix, $suffix) = explode('@count', t('Show @count value(s)')); $form['multiple_number'] = array( '#type' => 'textfield', '#title' => t('Multiple values:'), '#size' => 5, '#field_prefix' => theme('advanced_help_topic', 'date_api', 'date-display') . $prefix, '#field_suffix' => $suffix, '#default_value' => $settings['multiple_number'], '#weight' => 2, '#access' => $field['cardinality'] == FIELD_CARDINALITY_UNLIMITED ? 1 : $field['cardinality'], '#description' => t('Identify a specific number of values to display, or leave blank to show all values.'), ); list($prefix, $suffix) = explode('@isodate', t('starting from @isodate')); $form['multiple_from'] = array( '#type' => 'textfield', '#size' => 15, '#field_prefix' => $prefix, '#field_suffix' => $suffix, '#default_value' => $settings['multiple_from'], '#weight' => 3, '#access' => $field['cardinality'] == FIELD_CARDINALITY_UNLIMITED ? 1 : $field['cardinality'], ); list($prefix, $suffix) = explode('@isodate', t('ending with @isodate')); $form['multiple_to'] = array( '#type' => 'textfield', '#size' => 15, '#field_prefix' => $prefix, '#field_suffix' => $suffix, '#default_value' => $settings['multiple_to'], '#weight' => 4, '#access' => $field['cardinality'] == FIELD_CARDINALITY_UNLIMITED ? 1 : $field['cardinality'], '#description' => t('Identify specific start and/or end dates in the format YYYY-MM-DDTHH:MM:SS, or leave blank for all available dates.'), ); $form['show_repeat_rule'] = array( '#title' => t('Repeat rule:'), '#type' => 'select', '#options' => array( 'show' => t('Display repeat rule'), 'hide' => t('Hide repeat rule')), '#default_value' => $settings['show_repeat_rule'], '#access' => $field['settings']['repeat'], '#weight' => 5, ); return $form; } /** * Settings for the interval formatter. */ function date_interval_formatter_settings_form($field, $instance, $view_mode, $form, &$form_state) { $display = $instance['display'][$view_mode]; $settings = $display['settings']; $form = array(); $form['interval'] = array( '#title' => t('Interval'), '#description' => t("How many time units should be shown in the 'time ago' string."), '#type' => 'select', '#options' => drupal_map_assoc(range(1, 6)), '#default_value' => $settings['interval'], '#weight' => 0, ); return $form; } /** * Settings summary for the default formatter. */ function date_default_formatter_settings_summary($field, $instance, $view_mode) { $display = $instance['display'][$view_mode]; $settings = $display['settings']; $formatter = $display['type']; $format_types = date_format_type_options(); $summary = array(); $summary[] = t('Use the @format format type.', array('@format' => $format_types[$settings['format_type']])); $options = array( 'both' => t('Display both From and To dates'), 'value' => t('Display From date only'), 'value2' => t('Display To date only'), ); $summary[] = $options[$settings['fromto']]; if (!empty($field['cardinality'])) { $summary[] = t('Show @count value(s) starting with @date1, ending with @date2', array( '@count' => !empty($settings['multiple_number']) ? $settings['multiple_number'] : t('all'), '@date1' => !empty($settings['multiple_from']) ? $settings['multiple_from'] : t('earliest'), '@date2' => !empty($settings['multiple_to']) ? $settings['multiple_to'] : t('latest'), )); } if (!empty($field['repeat'])) { if (!empty($settings['show_repeat_rule'])) { $summary[] = t('Show repeat rule'); } else { $summary[] = t('Do not show repeat rule'); } } return implode('
', $summary); } /** * Settings summary for the interval formatter. * @TODO Add settings later. */ function date_interval_formatter_settings_summary($field, $instance, $view_mode) { $summary = array(); $display = $instance['display'][$view_mode]; $settings = $display['settings']; $formatter = $display['type']; return t('Display time ago, showing @interval units.', array('@interval' => $settings['interval'])); } function _date_field_instance_settings_form($field, $instance) { $widget = $instance['widget']; $settings = $instance['settings']; $widget_settings = $instance['widget']['settings']; $description = t("The relative value to use. This should be something that describes a time by reference to the current day using strtotime, like '+90 days' (90 days from the day the field is created) or '+1 Saturday' (the next Saturday). See !strtotime for more details.", array('!strtotime' => l(t('strtotime'), 'http://www.php.net/manual/en/function.strtotime.php'))); $form['default_value'] = array( '#type' => 'select', '#title' => t('Default value'), '#default_value' => $settings['default_value'], '#options' => array('blank' => t('Blank'), 'now' => t('Now'), 'strtotime' => t('Relative')), '#weight' => 1, ); $form['default_value_code'] = array( '#type' => 'textfield', '#title' => t('Relative default value'), '#description' => $description, '#default_value' => $settings['default_value_code'], '#states' => array( 'visible' => array( ':input[name="instance[settings][default_value]"]' => array('value' => 'strtotime')) ), '#weight' => 1.1, ); $form['default_value2'] = array( '#type' => !empty($field['settings']['todate']) ? 'select' : 'hidden', '#title' => t('Default value for To date'), '#default_value' => $settings['default_value2'], '#options' => array('same' => t('Same as From date'), 'blank' => t('Blank'), 'now' => t('Now'), 'strtotime' => t('Relative')), '#weight' => 2, ); $form['default_value_code2'] = array( '#type' => !empty($field['settings']['todate']) ? 'textfield' : 'hidden', '#title' => t('Relative default value for To date'), '#description' => $description, '#default_value' => $settings['default_value_code2'], '#states' => array( 'visible' => array( ':input[name="instance[settings][default_value2]"]' => array('value' => 'strtotime')) ), '#weight' => 2.1, ); $format_types = array(); foreach (_system_date_format_types_build() as $name => $info) { $format_types[$name] = $info['title']; } $form['default_format'] = array( '#type' => 'select', '#title' => t('Default Display'), '#default_value' => $settings['default_format'], '#options' => $format_types, '#description' => t('Select a default format type to be used for the date display. Visit the Date and time date format page to add and edit format types.', array('@date-time-page' => url('admin/config/regional/date-time/formats'))), ); if (module_exists('date_repeat') && date_is_repeat_field($field, $instance)) { $form['repeat_collapsed'] = array( '#type' => 'radios', '#default_value' => $widget_settings['repeat_collapsed'], '#options' => array(0 => t('Expanded'), 1 => t('Collapsed')), '#title' => t('Repeat display'), '#description' => t("Should the repeat options form start out expanded or collapsed? Set to 'Collapsed' to make those options less obtrusive."), ); } $form['#element_validate'] = array('date_field_instance_settings_form_validate'); return $form; } function date_field_instance_settings_form_validate(&$form, &$form_state) { $settings = $form_state['values']['instance']['settings']; if ($settings['default_value'] == 'strtotime') { $is_strtotime = @strtotime($settings['default_value_code']); if (!$is_strtotime) { form_set_error('instance][settings][default_value_code', t('The Strtotime default value is invalid.')); } } if (isset($settings['default_value2']) && $settings['default_value2'] == 'strtotime') { $is_strtotime = @strtotime($settings['default_value_code2']); if (!$is_strtotime) { form_set_error('instance][settings][default_value_code2', t('The Strtotime default value for the To Date is invalid.')); } } } function _date_field_widget_settings_form($field, $instance) { $widget = $instance['widget']; $settings = $widget['settings']; $form = array( '#element_validate' => array('date_field_widget_settings_form_validate'), ); $options = array(); if ($widget['type'] == 'date_popup' && module_exists('date_popup')) { $formats = date_popup_formats(); } else { // example input formats must show all possible date parts, so add seconds. $formats = str_replace('i', 'i:s', array_keys(system_get_date_formats('short'))); $formats = drupal_map_assoc($formats); } $now = date_example_date(); foreach ($formats as $f) { $options[$f] = date_format_date($now, 'custom', $f); } $form['input_format'] = array( '#type' => 'select', '#title' => t('Input format'), '#default_value' => $settings['input_format'], '#options' => $options, '#description' => t('Set the order and format for the date parts in the input form. The format will be adapted to remove values not in the granularity for this field.'), '#weight' => 4, ); // Only a limited set of formats is available for the Date Popup module if ($widget['type'] != 'date_popup') { $form['input_format_custom'] = array( '#type' => 'textfield', '#title' => t('Custom input format'), '#default_value' => $settings['input_format_custom'], '#description' => t("The custom format, if provided, will override the input format selected above. Define a php date format string like 'm-d-Y H:i' (see http://php.net/date for more details).", array('@link' => 'http://php.net/date')), '#weight' => 5, ); } else { $form['input_format_custom'] = array( '#type' => 'hidden', '#value' => '', ); } if (in_array($widget['type'], array('date_select', 'date_popup', 'date_select_repeat', 'date_popup_repeat'))) { $form['year_range'] = array( '#type' => 'textfield', '#title' => t('Years back and forward'), '#default_value' => $settings['year_range'], '#size' => 10, '#maxsize' => 10, '#description' => t('Number of years to go back and forward in the year selection list, default is -3:+3.'), '#weight' => 6, ); $form['increment'] = array( '#type' => 'select', '#title' => t('Time increment'), '#default_value' => $settings['increment'], '#options' => array(1 => 1, 5 => 5, 10 => 10, 15 => 15, 30 => 30), '#description' => t('Increment the minute and second fields by this amount.'), '#weight' => 7, ); } else { $form['increment'] = array( '#type' => 'hidden', '#value' => $settings['increment'], ); $form['year_range'] = array( '#type' => 'hidden', '#value' => $settings['year_range'], ); } $form['label_position'] = array( '#type' => 'value', '#value' => $settings['label_position'], ); $form['text_parts'] = array( '#type' => 'value', '#value' => $settings['text_parts'], ); $form['advanced'] = array( '#type' => 'fieldset', '#title' => t('Customize Date Parts'), '#collapsible' => TRUE, '#collapsed' => TRUE, '#weight' => 8, ); $form['advanced']['label_position'] = array( '#type' => 'radios', '#options' => array('above' => t('Above'), 'within' => t('Within'), 'none' => t('None')), '#default_value' => $settings['label_position'], '#title' => t('Position of date part labels'), '#description' => t("The location of date part labels, like 'Year', 'Month', or 'Day' . 'Above' will display them as titles above each date part. 'Within' will insert the label as the first option in the select list and in blank textfields. 'None' will not label any of the date parts. The exact text in the label is controlled by themes like 'date_part_label_year' and 'date_part_label_month' ."), ); $form['advanced']['text_parts'] = array( '#theme' => $widget['type'] == 'date_select' ? 'date_text_parts' : '', ); $text_parts = (array) $settings['text_parts']; foreach (date_granularity_names() as $key => $value) { if ($widget['type'] == 'date_select') { $form['advanced']['text_parts'][$key] = array( '#type' => 'radios', '#default_value' => in_array($key, $text_parts) ? 1 : 0, '#options' => array(0 => '', 1 => ''), ); } else { $form['advanced']['text_parts'][$key] = array( '#type' => 'value', '#value' => in_array($key, (array) $settings['text_parts']) ? 1 : 0, ); } } return $form; } function date_field_widget_settings_form_validate(&$form, &$form_state) { // The widget settings are in the wrong place in the form because of #tree on the top level. $settings = $form_state['values']['instance']['widget']['settings']; $settings = array_merge($settings, $settings['advanced']); unset($settings['advanced']); form_set_value(array('#parents' => array('instance', 'widget', 'settings')), $settings, $form_state); $widget = $form_state['values']['instance']['widget']; // Munge the table display for text parts back into an array of text parts. if (is_array($widget['settings']['text_parts'])) { form_set_value($form['text_parts'], array_keys(array_filter($widget['settings']['text_parts'])), $form_state); } if (in_array($widget['type'], array('date_select', 'date_popup', 'date_select_repeat', 'date_popup_repeat')) && !date_range_valid($widget['settings']['year_range'])) { form_set_error('instance][widget][settings][year_range', t('Years back and forward must be in the format -9:+9.')); } } function _date_field_settings_form($field, $instance, $has_data) { $settings = $field['settings']; $form = array( '#element_validate' => array('date_field_settings_validate'), ); // Make sure granularity is in the right format and has no empty values. if (!empty($settings['granularity']) && is_array($settings['granularity'])) { $granularity = array_filter($settings['granularity']); } $tz_handling = $settings['tz_handling']; // If adding a repeat, override the Content module's handling of the multiple values option. if (module_exists('date_repeat') && date_is_repeat_field($field, $instance)) { $form['repeat'] = array('#type' => 'hidden', '#value' => 1); } else { $form['repeat'] = array('#type' => 'hidden', '#value' => 0); } $description = t("Display a matching second date field as a 'To date' . If marked 'Optional' field will be presented but not required. If marked 'Required' the 'To date' will be required if the 'From date' is required or filled in."); $form['todate'] = array( '#type' => 'select', '#title' => t('To Date'), '#options' => array('' => t('Never'), 'optional' => t('Optional'), 'required' => t('Required')), '#description' => $description, '#default_value' => $settings['todate'], '#disabled' => $has_data, ); $description = t('Set the date elements to be stored (at least a year is required).'); $form['granularity'] = array( '#type' => 'select', '#title' => t('Granularity'), '#default_value' => $granularity, '#options' => date_granularity_names(), '#multiple' => TRUE, '#description' => $description, '#disabled' => $has_data, ); $description = t('Select the timezone handling method to be used for this date field.'); $form['tz_handling'] = array( '#type' => 'select', '#title' => t('Time zone handling'), '#default_value' => $tz_handling, '#options' => date_timezone_handling_options(), '#description' => $description, '#disabled' => $has_data, ); // Force this value to hidden because we don't want to allow it to be changed right now, // but allow it to be a variable if needed. $form['timezone_db'] = array( '#type' => 'hidden', '#value' => date_get_timezone_db($tz_handling), ); return $form; } /** * Custom field settings manipulation. */ function date_field_settings_validate(&$form, &$form_state) { $field = $form_state['values']['field']; if ($field['settings']['tz_handling'] == 'none') { form_set_value($form['timezone_db'], '', $form_state); } else { form_set_value($form['timezone_db'], date_get_timezone_db($field['settings']['tz_handling']), $form_state); } if (!in_array('year', $field['settings']['granularity'])) { form_set_error('field][settings][granularity', t('Granularity must include a year.')); } if ($field['settings']['tz_handling'] != 'none' && !in_array('hour', array_filter($field['settings']['granularity']))) { form_set_error('field][settings][tz_handling', t('Dates without hours granularity must not use any timezone handling.')); } } /** * Timezone handling options * * the 'none' option will do no timezone conversions and will store and display dates exactly as entered * useful in locales or situations where timezone conversions are not working reliably, * for dates with no times, for historical dates where timezones are irrelevant, * or anytime conversion is unnecessary or undesirable */ function date_timezone_handling_options() { return array( 'site' => t("Site's time zone"), 'date' => t("Date's time zone"), 'user' => t("User's time zone"), 'utc' => 'UTC', 'none' => t('No time zone conversion'), ); } /** * Get an example date and make sure the difference between * month and day and 12 and 24 hours will be clear. */ function date_example_date() { $now = date_now(); if (date_format($now, 'm') == date_format($now, 'd')) { date_modify($now, '+1 day'); } if (date_format($now, 'H') == date_format($now, 'h')) { date_modify($now, '+12 hours'); } return $now; }