views_rss_itunes.field.inc in Views RSS: iTunes Elements 7

File

views_rss_itunes.field.inc

<?php

/**
 * Implements hook_field_formatter_info().
 */
function views_rss_itunes_field_formatter_info() {
  $formatters = array(
    'itunes:duration' => array(
      'label' => t('RSS <itunes:duration> element'),
      'field types' => array(
        'file',
      ),
    ),
    'itunes:image' => array(
      'label' => t('RSS <itunes:image> element'),
      'field types' => array(
        'image',
        'file',
      ),
    ),
  );
  return $formatters;
}

/**
 * Implements hook_field_formatter_settings_form().
 */
function views_rss_itunes_field_formatter_settings_form($field, $instance, $view_mode, $form, &$form_state) {
  $display = $instance['display'][$view_mode];
  $settings = $display['settings'];
  $element = NULL;
  if ($field['type'] == 'image') {
    $image_styles = image_style_options(FALSE);
    $element['image_style'] = array(
      '#title' => t('Image style'),
      '#type' => 'select',
      '#default_value' => $settings['image_style'],
      '#empty_option' => t('None (original image)'),
      '#options' => $image_styles,
    );
  }
  return $element;
}

/**
 * Implements hook_field_formatter_settings_summary().
 */
function views_rss_itunes_field_formatter_settings_summary($field, $instance, $view_mode) {
  $display = $instance['display'][$view_mode];
  $settings = $display['settings'];
  $summary = array();
  if ($field['type'] == 'image') {
    $image_styles = image_style_options(FALSE);

    // Unset possible 'No defined styles' option.
    unset($image_styles['']);

    // Styles could be lost because of enabled/disabled modules that defines
    // their styles in code.
    if (isset($image_styles[$settings['image_style']])) {
      $summary[] = t('RSS &lt;itunes:image&gt; element: @style', array(
        '@style' => $image_styles[$settings['image_style']],
      ));
    }
    else {
      $summary[] = t('RSS &lt;itunes:image&gt; element');
    }
  }
  return implode('<br />', $summary);
}

/**
 * Implements hook_field_formatter_view().
 *
 * This is a dirty trick here. Essentially, we do not want to call a theme
 * function from here, as it should be called from within a view (amongst
 * other to have $view object in $variables). Therefore here we want to
 * return value only, hence use of array('#markup' => $value). However,
 * in some cases it won't be just a simple string value to return,
 * sometimes we'd want to return an array (for example value with
 * additional arguments) - hence the need to serialize it (plus add
 * "serialized" string at the beginning so that our field preprocess
 * function template_preprocess_views_view_views_rss_field() is able
 * to recognize it as serialized array and treat accordingly.
 *
 * Any better ideas?
 */
function views_rss_itunes_field_formatter_view($entity_type, $entity, $field, $instance, $langcode, $items, $display) {
  $element = array();
  foreach ($items as $delta => $item) {

    // Inside a view item may contain NULL data. In that case, just return.
    if (empty($item['fid'])) {
      unset($items[$delta]);
      continue;
    }
    $rss_element = array(
      'key' => $display['type'],
    );
    switch ($display['type']) {
      case 'itunes:duration':
        $file_info = views_rss_itunes_get_file_info($item['uri']);
        if (isset($file_info['playtime_string'])) {
          $rss_element['value'] = $file_info['playtime_string'];
        }
        break;
      case 'itunes:image':
        $uri = file_create_url($item['uri']);
        if (!empty($display['settings']['image_style']) && ($image_style = image_style_load($display['settings']['image_style']))) {

          // Get full image URI based on provided image style.
          $uri = image_style_url($display['settings']['image_style'], $item['uri']);

          // Make sure that image style file has already been created.
          $path = image_style_path($display['settings']['image_style'], $item['uri']);
          if (!file_exists(drupal_realpath($path))) {
            image_style_create_derivative($image_style, $item['uri'], $path);
          }
        }
        $rss_element['attributes'] = array(
          'href' => $uri,
        );
        break;
    }
    $element[$delta] = array(
      '#item' => $item,
      '#markup' => format_xml_elements(array(
        $rss_element,
      )),
      '#rss_element' => $rss_element,
      '#settings' => $display['settings'],
    );
  }
  return $element;
}

Functions

Name	Description
views_rss_itunes_field_formatter_info	Implements hook_field_formatter_info().
views_rss_itunes_field_formatter_settings_form	Implements hook_field_formatter_settings_form().
views_rss_itunes_field_formatter_settings_summary	Implements hook_field_formatter_settings_summary().
views_rss_itunes_field_formatter_view	Implements hook_field_formatter_view().