class views_plugin_style_atom_fields in Views Atom 6

@file Style plugin for a standard Atom feed.

Hierarchy

• class \views_plugin_style_atom_fields extends \views_plugin_style

1 string reference to 'views_plugin_style_atom_fields'

views_atom_views_plugins in views/views_atom.views.inc

Implementation of hook_views_plugins().

File

views/views_plugin_style_atom_fields.inc, line 8

Style plugin for a standard Atom feed.

class views_plugin_style_atom_fields extends views_plugin_style {

  /**
   * Initialize plugin.
   *
   * Set feed image for shared rendering later.
   */
  function init(&$view, &$display, $options = NULL) {
    parent::init($view, $display, $options = NULL);

    //$this->feed_image = drupal_get_path('module', 'views_kml') . '/images/kml.png';
  }

  /**
   * Attach this view to another display as a feed.
   *
   * Provide basic functionality for all export style views like attaching a
   * feed image link.
   */
  function attach_to($display_id, $path, $title) {
    $url_options = array(
      'html' => true,
    );
    $image = theme('image', $this->feed_image);
    $this->view->feed_icon .= l($image, $path, $url_options);
  }
  function option_definition() {
    $options = parent::option_definition();
    $options['entry_type'] = array(
      'default' => 'text',
    );
    $options['entry_type_custom'] = array(
      'default' => '',
    );
    $options['description']['feed_description'] = array(
      'default' => '',
    );
    $options['fields'] = array(
      'default' => array(),
    );
    $options['guid'] = array(
      'use_feed' => array(
        'default' => array(),
      ),
    );
    return $options;
  }

  /**
   * Provide a form for setting options.
   */
  function options_form(&$form, &$form_state) {
    parent::options_form($form, $form_state);
    $options = parent::option_definition();
    $handlers = $this->display->handler
      ->get_handlers('field');
    if (empty($handlers)) {
      $form['error_markup'] = array(
        '#value' => t('You need at least one field before you can configure your field settings'),
        '#prefix' => '<div class="error form-item description">',
        '#suffix' => '</div>',
      );
    }
    else {
      $form['entry_type'] = array(
        '#type' => 'select',
        '#title' => t('Entry type'),
        '#options' => drupal_map_assoc(array(
          'text',
          'html',
          'xhtml',
          'xml',
        )),
        '#default_value' => $this->options['entry_type'],
        '#description' => t('Select the media type of the content of each entry. If XML, enter the mimetype to use below.'),
      );
      $form['entry_type_custom'] = array(
        '#type' => 'textfield',
        '#title' => t('Custom entry type'),
        '#desctiption' => t('Enter the mimetype of the content of this feed.  It must be a valid XML mimetype.'),
        '#default_value' => $this->options['entry_type_custom'],
      );

      // Feed Description
      $form['description'] = array(
        '#type' => 'fieldset',
        '#title' => t('Feed Description'),
        '#collapsible' => TRUE,
        '#collapsed' => TRUE,
      );
      $form['description']['feed_description'] = array(
        '#type' => 'textarea',
        '#default_value' => $this->options['description']['feed_description'],
        '#description' => t('Description for this feed.  If left blank, the default site mission will be used.'),
      );

      // Field Chooser
      $field_names[$field] = array(
        '' => '--',
      );
      foreach ($handlers as $field => $handler) {
        if ($label = $handler
          ->label()) {
          $field_names[$field] = $label;
        }
        else {
          $field_names[$field] = $handler
            ->ui_name();
        }
      }
      $field_options = $this
        ->atom_mapping_fields();
      $form['fields'] = array(
        '#type' => 'fieldset',
        '#title' => t('Field usage'),
        '#description' => t('Atom needs certain elements have values. Specify which fields should be used to populate each field. Note that all fields will still be available to the content of the record.'),
        '#collapsible' => TRUE,
        '#collapsed' => TRUE,
      );
      foreach ($field_options as $k => $v) {
        $form['fields'][$k] = array(
          '#type' => 'select',
          '#title' => $v['label'],
          '#options' => $field_names,
          '#default_value' => $this->options['fields'][$k],
        );
      }

      // Feed Description
      $form['guid'] = array(
        '#type' => 'fieldset',
        '#title' => t('GUID settings'),
        '#description' => t('Controls how the GUID is created.'),
        '#collapsible' => TRUE,
        '#collapsed' => TRUE,
      );
      if (module_exists('feeds')) {
        $form['guid']['use_existing_from_feed'] = array(
          '#title' => t('Use existing GUID when available'),
          '#type' => 'checkbox',
          '#default_value' => !empty($this->options['guid']['use_existing_from_feed']),
          '#description' => t('If the node was imported into the site from another feed, use the original GUID.'),
        );
      }
      $form['guid']['#access'] = count(element_children($form['guid'])) ? TRUE : FALSE;
    }
  }

  /**
   * Keep track of what fields are mapped for reuse.
   */
  function atom_mapping_fields() {
    return array(
      'atom_title' => array(
        'label' => t('Title'),
        'required' => TRUE,
      ),
      'atom_summary' => array(
        'label' => t('Summary'),
      ),
      'atom_url' => array(
        'label' => t('URL'),
        'required' => TRUE,
      ),
      'atom_updated' => array(
        'label' => t('Updated'),
        'required' => TRUE,
      ),
      'atom_published' => array(
        'label' => t('Published'),
      ),
      'atom_author' => array(
        'label' => t('Author Name'),
      ),
      'atom_author_email' => array(
        'label' => t('Author Email'),
      ),
      'atom_author_url' => array(
        'label' => t('Author URL'),
      ),
    );
  }

  /**
   * Validate that the feed has all needed fields for atom to function.
   */
  function validate() {
    $errors = array();
    $fields = $this->display->handler
      ->get_handlers('field');
    $missing_fields = array();
    foreach ($this
      ->atom_mapping_fields() as $field_key => $info) {
      if (!empty($info['required']) && (empty($this->options['fields'][$field_key]) || empty($fields[$this->options['fields'][$field_key]]))) {
        $missing_fields[] = $info['label'];
      }
    }
    if (!empty($missing_fields)) {
      $errors[] = t('Display "@display" is missing required atom fields: @fields.', array(
        '@display' => $this->display->display_title,
        '@fields' => implode(', ', $missing_fields),
      ));
    }
    return $errors;
  }
  function map_rows($rows) {

    // Fields must be rendered in order as of Views 2.3, so we will pre-render everything.
    $renders = array();
    $keys = array_keys($this->view->field);
    foreach ($rows as $count => $row) {
      foreach ($keys as $id) {
        $renders[$count][$id] = $this->view->field[$id]
          ->theme($row);
      }
    }
    $items = array();
    foreach ($renders as $id => $row) {
      $item = array();
      foreach ($this->options['fields'] as $key => $val) {
        if (!isset($this->view->field[$val])) {
          continue;
        }
        $item[$key] = htmlentities($row[$val], ENT_QUOTES, '', FALSE);
      }
      $items[] = $item;
    }
    return $items;
  }

}

Members

Name	Modifiers	Type	Description	Overrides
views_plugin_style_atom_fields::atom_mapping_fields		function	Keep track of what fields are mapped for reuse.
views_plugin_style_atom_fields::attach_to		function	Attach this view to another display as a feed.
views_plugin_style_atom_fields::init		function	Initialize plugin.
views_plugin_style_atom_fields::map_rows		function
views_plugin_style_atom_fields::options_form		function	Provide a form for setting options.
views_plugin_style_atom_fields::option_definition		function
views_plugin_style_atom_fields::validate		function	Validate that the feed has all needed fields for atom to function.