function theme_date_display_combination in Date 7.2

Same name and namespace in other branches

1. 8 date.theme \theme_date_display_combination()
2. 5.2 date/date.theme \theme_date_display_combination()
3. 5 date.module \theme_date_display_combination()
4. 6.2 date/date.theme \theme_date_display_combination()
5. 6 date/date.theme \theme_date_display_combination()
6. 7.3 date.theme \theme_date_display_combination()
7. 7 date.theme \theme_date_display_combination()

Returns HTML for a date element formatted as a Start/End combination.

$entity->date_id If set, this will show only an individual date on a field with multiple dates. The value should be a string that contains the following values, separated with periods:

• module name of the module adding the item
• node nid
• field name
• delta value of the field to be displayed
• other information the module's custom theme might need.

Used by the calendar module and available for other uses. example: 'date.217.field_date.3.test'

$entity->date_repeat_show If TRUE, tells the theme to show all the computed values of a repeating date. If not TRUE or not set, only the start date and the repeat rule will be displayed.

$dates['format'] The format string used on these dates $dates['value']['local']['object'] The local date object for the Start date $dates['value2']['local']['object'] The local date object for the End date $dates['value']['local']['datetime'] The datetime value of the Start date database (GMT) value $dates['value2']['local']['datetime'] The datetime value of the End date database (GMT) value $dates['value']['formatted'] Formatted Start date, i.e. 'February 15, 2007 2:00 pm'; $dates['value']['formatted_date'] Only the date part of the formatted Start date $dates['value']['formatted_time'] Only the time part of the formatted Start date $dates['value2']['formatted'] Formatted End date, i.e. 'February 15, 2007 6:00 pm'; $dates['value2']['formatted_date'] Only the date part of the formatted End date $dates['value2']['formatted_time'] Only the time part of the formatted End date

1 theme call to theme_date_display_combination()

date_field_formatter_view in ./date.field.inc

Implements hook_field_formatter_view().

File

./date.theme, line 59

Theme functions.

Code

function theme_date_display_combination($variables) {
  static $repeating_ids = array();
  $entity_type = $variables['entity_type'];
  $entity = $variables['entity'];
  $field = $variables['field'];
  $instance = $variables['instance'];
  $langcode = $variables['langcode'];
  $item = $variables['item'];
  $delta = $variables['delta'];
  $display = $variables['display'];
  $field_name = $field['field_name'];
  $formatter = $display['type'];
  $options = $display['settings'];
  $dates = $variables['dates'];
  $attributes = $variables['attributes'];
  $rdf_mapping = $variables['rdf_mapping'];
  $add_rdf = $variables['add_rdf'];
  $microdata = $variables['microdata'];
  $add_microdata = $variables['add_microdata'];
  $precision = date_granularity_precision($field['settings']['granularity']);
  $output = '';

  // If date_id is set for this field and delta doesn't match, don't display it.
  if (!empty($entity->date_id)) {
    foreach ((array) $entity->date_id as $key => $id) {
      list($module, $nid, $field_name, $item_delta, $other) = explode('.', $id . '.');
      if ($field_name == $field['field_name'] && isset($delta) && $item_delta != $delta) {
        return $output;
      }
    }
  }

  // Check the formatter settings to see if the repeat rule should be displayed.
  // Show it only with the first multiple value date.
  list($id) = entity_extract_ids($entity_type, $entity);
  if (!in_array($id, $repeating_ids) && module_exists('date_repeat_field') && !empty($item['rrule']) && $options['show_repeat_rule'] == 'show') {
    $repeat_vars = array(
      'field' => $field,
      'item' => $item,
      'entity_type' => $entity_type,
      'entity' => $entity,
    );
    $output .= theme('date_repeat_display', $repeat_vars);
    $repeating_ids[] = $id;
  }

  // If this is a full node or a pseudo node created by grouping multiple
  // values, see exactly which values are supposed to be visible.
  if (isset($entity->{$field_name})) {
    $entity = date_prepare_entity($formatter, $entity_type, $entity, $field, $instance, $langcode, $item, $display);

    // Did the current value get removed by formatter settings?
    if (empty($entity->{$field_name}[$langcode][$delta])) {
      return $output;
    }

    // Adjust the $element values to match the changes.
    $element['#entity'] = $entity;
  }

  // Verify these variables exist.
  if (!isset($dates['value']['formatted'])) {
    $dates['value']['formatted'] = '';
  }
  if (!isset($dates['value2']['formatted'])) {
    $dates['value2']['formatted'] = '';
  }
  if (!isset($dates['value']['formatted_time'])) {
    $dates['value']['formatted_time'] = '';
  }
  if (!isset($dates['value2']['formatted_time'])) {
    $dates['value2']['formatted_time'] = '';
  }
  if (!isset($dates['value']['formatted_timezone'])) {
    $dates['value']['formatted_timezone'] = '';
  }
  if (!isset($dates['value2']['formatted_timezone'])) {
    $dates['value2']['formatted_timezone'] = '';
  }
  switch ($options['fromto']) {
    case 'value':
      $date1 = $dates['value']['formatted'];
      $date2 = $date1;
      break;
    case 'value2':
      $date2 = $dates['value2']['formatted'];
      $date1 = $date2;
      break;
    default:
      $date1 = $dates['value']['formatted'];
      $date2 = $dates['value2']['formatted'];
      break;
  }

  // Pull the timezone, if any, out of the formatted result and tack it back on
  // at the end, if it is in the current formatted date.
  $timezone = $dates['value']['formatted_timezone'];
  if ($timezone) {
    $timezone = ' ' . $timezone;
  }
  $date1 = str_replace($timezone, '', $date1);
  $date2 = str_replace($timezone, '', $date2);
  $time1 = preg_replace('`^([\\(\\[])`', '', $dates['value']['formatted_time']);
  $time1 = preg_replace('([\\)\\]]$)', '', $time1);
  $time2 = preg_replace('`^([\\(\\[])`', '', $dates['value2']['formatted_time']);
  $time2 = preg_replace('([\\)\\]]$)', '', $time2);

  // A date with a granularity of 'hour' has a time string that is an integer
  // value. We can't use that to replace time strings in formatted dates.
  $has_time_string = date_has_time($field['settings']['granularity']);
  if ($precision == 'hour') {
    $has_time_string = FALSE;
  }

  // Check remaining days.
  $show_remaining_days = '';
  if (!empty($variables['show_remaining_days']) && isset($variables['dates']['value']['formatted_iso'])) {
    $remaining_days = $variables['dates']['value']['formatted_iso'];
    $remaining_days = floor((strtotime($remaining_days) - strtotime('now')) / (24 * 3600));

    // Show remaining days only for future events.
    if ($remaining_days >= 0) {
      $show_remaining_days = theme('date_display_remaining', array(
        'remaining_days' => $remaining_days,
      ));
    }
  }

  // No date values, display nothing.
  if (empty($date1) && empty($date2)) {
    $output .= '';
  }
  elseif ($date1 == $date2 || empty($date2)) {
    $output .= theme('date_display_single', array(
      'date' => $date1,
      'timezone' => $has_time_string ? $timezone : '',
      'attributes' => $attributes,
      'rdf_mapping' => $rdf_mapping,
      'add_rdf' => $add_rdf,
      'microdata' => $microdata,
      'add_microdata' => $add_microdata,
      'dates' => $dates,
      'show_remaining_days' => $show_remaining_days,
    ));
  }
  elseif ($has_time_string && $dates['value']['formatted_date'] == $dates['value2']['formatted_date']) {

    // Replace the original time with the start/end time in the formatted start
    // date. Make sure that parentheses or brackets wrapping the time will be
    // retained in the final result.
    $time = theme('date_display_range', array(
      'date1' => $time1,
      'date2' => $time2,
      'timezone' => $timezone,
      'attributes' => $attributes,
      'rdf_mapping' => $rdf_mapping,
      'add_rdf' => $add_rdf,
      'microdata' => $microdata,
      'add_microdata' => $add_microdata,
      'dates' => $dates,
      'show_remaining_days' => $show_remaining_days,
    ));
    $replaced = str_replace($time1, $time, $date1);
    $output .= theme('date_display_single', array(
      'date' => $replaced,
      'timezone' => $timezone,
      'attributes' => array(),
      'rdf_mapping' => array(),
      'add_rdf' => FALSE,
      'dates' => $dates,
    ));
  }
  else {
    $output .= theme('date_display_range', array(
      'date1' => $date1,
      'date2' => $date2,
      'timezone' => $has_time_string ? $timezone : '',
      'attributes' => $attributes,
      'rdf_mapping' => $rdf_mapping,
      'add_rdf' => $add_rdf,
      'microdata' => $microdata,
      'add_microdata' => $add_microdata,
      'dates' => $dates,
      'show_remaining_days' => $show_remaining_days,
    ));
  }
  return $output;
}