You are here

views_panes.inc in Chaos Tool Suite (ctools) 6

Same filename and directory in other branches
  1. 7 views_content/plugins/content_types/views_panes.inc

Content type plugin to allow Views to be exposed as a display type, leaving most of the configuration on the view.

File

views_content/plugins/content_types/views_panes.inc
View source
<?php

/**
 * @file
 * Content type plugin to allow Views to be exposed as a display type,
 * leaving most of the configuration on the view.
 */

/**
 * Implementation of hook_ctools_content_types()
 */
function views_content_views_panes_ctools_content_types() {
  return array(
    'title' => t('View panes'),
    'admin settings' => 'views_content_admin_form',
    'js' => array(
      drupal_get_path('module', 'ctools') . '/js/dependent.js',
    ),
  );
}

/**
 * Return all content types available.
 */
function views_content_views_panes_content_type_content_types($plugin) {
  $types = array();

  // It can be fairly intensive to calculate this, so let's cache this in the
  // cache_views table. The nice thing there is that if views ever change, that
  // table will always be cleared. Except for the occasional default view, so
  // we must use the Views caching functions in order to respect Views caching
  // settings.
  views_include('cache');
  $data = views_cache_get('views_content_panes', TRUE);
  if (!empty($data->data)) {
    $types = $data->data;
  }
  if (empty($types)) {
    $types = array();
    $views = views_get_all_views();
    foreach ($views as $view) {
      if (!empty($view->disabled)) {
        continue;
      }
      $view
        ->init_display();
      foreach ($view->display as $id => $display) {
        if (empty($display->handler->panel_pane_display)) {
          continue;
        }
        $info = _views_content_panes_content_type($view, $display);
        if ($info) {
          $types[$view->name . '-' . $id] = $info;
        }
      }
      $view
        ->destroy();
    }
    views_cache_set('views_content_panes', $types, TRUE);
  }
  return $types;
}

/**
 * Return a single content type.
 */
function views_content_views_panes_content_type_content_type($subtype, $plugin) {
  list($name, $display) = explode('-', $subtype);
  $view = views_get_view($name);
  if (empty($view)) {
    return;
  }
  $view
    ->set_display($display);
  $retval = _views_content_panes_content_type($view, $view->display[$display]);
  $view
    ->destroy();
  return $retval;
}
function _views_content_panes_content_type($view, $display) {

  // Ensure the handler is the right type, as Views will fall back to
  // the default display if something is broken:
  if (get_class($display->handler) != 'views_content_plugin_display_panel_pane') {
    return;
  }
  $title = $display->handler
    ->get_option('pane_title');
  if (!$title) {
    $title = $view->name;
  }
  $description = $display->handler
    ->get_option('pane_description');
  if (!$description) {
    $description = $view->description;
  }
  $category = $display->handler
    ->get_option('pane_category');
  if (!$category['name']) {
    $category['name'] = t('View panes');
  }
  $icon = 'icon_views_page.png';
  $contexts = array();
  $arguments = $display->handler
    ->get_argument_input();
  foreach ($arguments as $argument) {
    if ($argument['type'] == 'context') {
      if (strpos($argument['context'], '.')) {
        list($context, $converter) = explode('.', $argument['context'], 2);
      }
      else {

        // Backwards-compat for before we had a system for delimiting the data
        // we retrieve out of context objects.
        $context = $argument['context'];
      }
      $class = 'ctools_context_' . (empty($argument['context_optional']) ? 'required' : 'optional');
      $contexts[] = new $class($argument['label'], $context);
    }
  }
  $allow = $display->handler
    ->get_option('allow');
  return array(
    'title' => $title,
    'icon' => $icon,
    'description' => filter_xss_admin($description),
    'required context' => $contexts,
    'category' => array(
      $category['name'],
      $category['weight'],
    ),
    'no title override' => empty($allow['title_override']),
  );
}

/**
 * Output function for the 'views' content type.
 *
 * Outputs a view based on the module and delta supplied in the configuration.
 */
function views_content_views_panes_content_type_render($subtype, $conf, $panel_args, $contexts) {
  if (!is_array($contexts)) {
    $contexts = array(
      $contexts,
    );
  }
  list($name, $display) = explode('-', $subtype);
  $view = views_get_view($name);
  if (empty($view)) {
    return;
  }
  $view
    ->set_display($display);
  if (!$view->display_handler
    ->access($GLOBALS['user']) || !$view->display_handler->panel_pane_display) {
    return;
  }
  $view->display_handler
    ->set_pane_conf($conf);
  $args = array();
  $arguments = $view->display_handler
    ->get_option('arguments');
  $context_keys = array_keys($contexts);
  foreach ($view->display_handler
    ->get_argument_input() as $id => $argument) {
    switch ($argument['type']) {
      case 'context':
        $key = array_shift($context_keys);
        if (isset($contexts[$key])) {
          if (strpos($argument['context'], '.')) {
            list($context, $converter) = explode('.', $argument['context'], 2);
            $args[] = ctools_context_convert_context($contexts[$key], $converter);
          }
          else {
            $args[] = $contexts[$key]->argument;
          }
        }
        break;
      case 'fixed':
        $args[] = $argument['fixed'];
        break;
      case 'panel':
        $args[] = isset($panel_args[$argument['panel']]) ? $panel_args[$argument['panel']] : NULL;
        break;
      case 'user':
        $args[] = isset($conf['arguments'][$id]) && $conf['arguments'][$id] !== '' ? $conf['arguments'][$id] : NULL;
        break;
      case 'wildcard':

        // Put in the wildcard.
        $args[] = isset($arguments[$id]['wildcard']) ? $arguments[$id]['wildcard'] : '*';
        break;
      case 'none':
      default:

        // Put in NULL.
        // views.module knows what to do with NULL (or missing) arguments
        $args[] = NULL;
        break;
    }
  }

  // remove any trailing NULL arguments as these are non-args:
  while (count($args) && end($args) === NULL) {
    array_pop($args);
  }
  $view
    ->set_arguments($args);
  $allow = $view->display_handler
    ->get_option('allow');
  if (!empty($conf['path'])) {
    $conf['path'] = ctools_context_keyword_substitute($conf['path'], array(), $contexts);
  }
  if ($allow['path_override'] && !empty($conf['path'])) {
    $view->override_path = $conf['path'];
  }
  else {
    if ($path = $view->display_handler
      ->get_option('inherit_panels_path')) {
      $view->override_path = $_GET['q'];
    }
  }
  $block = new stdClass();
  $block->module = 'views';
  $block->delta = $view->name . $display;
  if ($allow['link_to_view'] && !empty($conf['link_to_view']) || !$allow['link_to_view'] && $view->display_handler
    ->get_option('link_to_view')) {
    $block->title_link = $view
      ->get_url();
  }

  // more link
  if ($allow['more_link']) {
    if (empty($conf['more_link'])) {
      $view->display_handler
        ->set_option('use_more', FALSE);
    }
    else {
      $view->display_handler
        ->set_option('use_more', TRUE);

      // make sure the view runs the count query so we know whether or not the
      // more link applies.
      $view->get_total_rows = TRUE;
    }
  }
  if ($allow['items_per_page'] && isset($conf['items_per_page'])) {
    $view->display_handler
      ->set_option('items_per_page', $conf['items_per_page']);

    // And here too, which works in Views 3 where the above does not.
    $view
      ->set_items_per_page($conf['items_per_page']);
  }
  if ($allow['offset']) {
    $view->display_handler
      ->set_option('offset', $conf['offset']);
    $view
      ->set_offset($conf['offset']);
  }
  if ($allow['use_pager']) {

    // Only set use_pager if they differ, this way we can avoid overwriting the
    // pager type that Views uses.
    // Views 3 version
    if (method_exists($view, 'init_pager')) {
      $pager = $view->display_handler
        ->get_option('pager');
      if ($conf['use_pager'] && ($pager['type'] == 'none' || $pager['type'] == 'some')) {
        $pager['type'] = 'full';
      }
      elseif (!$conf['use_pager'] && $pager['type'] != 'none' && $pager['type'] != 'some') {
        $pager['type'] = $view
          ->get_items_per_page() || !empty($pager['options']['items_per_page']) ? 'some' : 'none';
      }
      if ($conf['use_pager']) {
        if (!isset($pager['options']['id']) || $pager['options']['id'] != $conf['pager_id']) {
          $pager['options']['id'] = $conf['pager_id'];
        }
      }
      $view->display_handler
        ->set_option('pager', $pager);
    }
    else {
      if (!$view->display_handler
        ->get_option('use_pager') || empty($conf['use_pager'])) {
        $view->display_handler
          ->set_option('use_pager', $conf['use_pager']);
      }
      $view->display_handler
        ->set_option('pager_element', $conf['pager_id']);
    }
  }
  if ($allow['fields_override']) {
    if ($conf['fields_override']) {
      $fields = $view
        ->get_items('field');
      foreach ($fields as $field => $display) {
        $fields[$field]['exclude'] = empty($conf['fields_override'][$field]);
      }
      $view->display_handler
        ->set_option('fields', $fields);
    }
  }
  if ($allow['exposed_form'] && !empty($conf['exposed'])) {
    $view
      ->set_exposed_input($conf['exposed']);
  }
  $stored_feeds = drupal_add_feed();
  $block->content = $view
    ->preview();
  if (empty($view->result) && !$view->display_handler
    ->get_option('empty') && empty($view->style_plugin->definition['even empty'])) {
    return;
  }
  $block->title = $view
    ->get_title();
  if (empty($view->total_rows) || $view->total_rows <= $view->display_handler
    ->get_option('items_per_page')) {
    unset($block->more);
  }
  if (!empty($allow['feed_icons']) && !empty($conf['feed_icons']) || empty($allow['feed_icons']) && $view->display_handler
    ->get_option('feed_icons')) {
    $new_feeds = drupal_add_feed();
    if ($diff = array_diff(array_keys($new_feeds), array_keys($stored_feeds))) {
      foreach ($diff as $url) {
        $block->feeds[$url] = $new_feeds[$url];
      }
    }
  }
  return $block;
}

/**
 * Returns an edit form for a block.
 */
function views_content_views_panes_content_type_edit_form(&$form, &$form_state) {
  $conf = $form_state['conf'];
  $contexts = $form_state['contexts'];

  // This allows older content to continue to work, where we used to embed
  // the display directly.
  list($name, $display_id) = explode('-', $form_state['subtype_name']);
  $view = views_get_view($name);
  if (empty($view)) {
    $form['markup'] = array(
      '#value' => t('Broken/missing/deleted view.'),
    );
    return;
  }
  $view
    ->set_display($display_id);
  $allow = $view->display_handler
    ->get_option('allow');

  // Provide defaults for everything in order to prevent warnings.
  if (empty($conf)) {
    $conf['link_to_view'] = $view->display_handler
      ->get_option('link_to_view');
    $conf['more_link'] = $view->display_handler
      ->get_option('more_link');
    $conf['feed_icons'] = FALSE;
    $conf['use_pager'] = $view->display_handler
      ->get_option('use_pager');
    $conf['pager_id'] = $view->display_handler
      ->get_option('element_id');
    $conf['items_per_page'] = $view->display_handler
      ->get_option('items_per_page');
    $conf['offset'] = $view->display_handler
      ->get_option('offset');
    $conf['path_override'] = FALSE;
    $conf['path'] = $view
      ->get_path();
    $conf['fields_override'] = $view->display_handler
      ->get_option('fields_override');
  }
  $form['arguments']['#tree'] = TRUE;
  foreach ($view->display_handler
    ->get_argument_input() as $id => $argument) {
    if ($argument['type'] == 'user') {
      $form['arguments'][$id] = array(
        '#type' => 'textfield',
        '#default_value' => isset($conf['arguments'][$id]) ? $conf['arguments'][$id] : '',
        '#title' => $argument['label'],
      );
    }
  }
  if ($allow['link_to_view']) {
    $form['link_to_view'] = array(
      '#type' => 'checkbox',
      '#default_value' => isset($conf['link_to_view']) ? $conf['link_to_view'] : $view->display_handler
        ->get_option('link_to_view'),
      '#title' => t('Link title to page'),
    );
  }
  if ($allow['more_link']) {
    $form['more_link'] = array(
      '#type' => 'checkbox',
      '#default_value' => isset($conf['more_link']) ? $conf['more_link'] : $view->display_handler
        ->get_option('use_more'),
      '#description' => t('The text of this link will be "@more". This setting can only be modified on the View configuration.', array(
        '@more' => $view->display_handler
          ->use_more_text(),
      )),
      '#title' => t('Provide a "more" link.'),
    );
  }
  if (!empty($allow['feed_icons'])) {
    $form['feed_icons'] = array(
      '#type' => 'checkbox',
      '#default_value' => !empty($conf['feed_icons']),
      '#title' => t('Display feed icons'),
    );
  }
  $view
    ->init_style();
  if ($allow['fields_override'] && $view->style_plugin
    ->uses_fields()) {
    $form['fields_override'] = array(
      '#type' => 'fieldset',
      '#title' => 'Fields to display',
      '#collapsible' => TRUE,
      '#tree' => TRUE,
    );
    foreach ($view->display_handler
      ->get_handlers('field') as $field => $handler) {
      $title = $handler
        ->ui_name();
      if ($handler->options['label']) {
        $title .= ' (' . $handler->options['label'] . ')';
      }
      $form['fields_override'][$field] = array(
        '#type' => 'checkbox',
        '#title' => $title,
        '#default_value' => isset($conf['fields_override'][$field]) ? $conf['fields_override'][$field] : TRUE,
      );
    }
  }
  ctools_include('dependent');
  if ($allow['use_pager']) {
    $form['use_pager'] = array(
      '#type' => 'checkbox',
      '#title' => t('Use pager'),
      '#default_value' => isset($conf['use_pager']) ? $conf['use_pager'] : $view->display_handler
        ->get_option('use_pager'),
      '#id' => 'use-pager-checkbox',
      '#prefix' => '<div class="container-inline">',
    );
    $form['pager_id'] = array(
      '#type' => 'textfield',
      '#default_value' => isset($conf['pager_id']) ? $conf['pager_id'] : $view->display_handler
        ->get_option('element_id'),
      '#title' => t('Pager ID'),
      '#size' => 4,
      '#id' => 'use-pager-textfield',
      '#process' => array(
        'ctools_dependent_process',
      ),
      '#dependency' => array(
        'use-pager-checkbox' => array(
          1,
        ),
      ),
      '#suffix' => '</div>',
    );
  }
  if ($allow['items_per_page']) {
    $form['items_per_page'] = array(
      '#type' => 'textfield',
      '#default_value' => isset($conf['items_per_page']) ? $conf['items_per_page'] : $view->display_handler
        ->get_option('items_per_page'),
      '#title' => t('Num items'),
      '#size' => 4,
      '#description' => t('Select the number of items to display, or 0 to display all results.'),
    );
  }
  if ($allow['offset']) {
    $form['offset'] = array(
      '#type' => 'textfield',
      '#default_value' => isset($conf['offset']) ? $conf['offset'] : $view->display_handler
        ->get_option('offset'),
      '#title' => t('Offset'),
      '#size' => 4,
      '#description' => t('Enter the number of items to skip; enter 0 to skip no items.'),
    );
  }
  if ($allow['path_override']) {
    $form['path'] = array(
      '#type' => 'textfield',
      '#default_value' => isset($conf['path']) ? $conf['path'] : $view
        ->get_path(),
      '#title' => t('Override path'),
      '#size' => 30,
      '#description' => t('If this is set, override the View URL path; this can sometimes be useful to set to the panel URL.'),
    );
    if (!empty($contexts)) {
      $form['path']['#description'] .= ' ' . t('You may use substitutions in this path.');

      // Add js for collapsible fieldsets manually
      drupal_add_js('misc/collapse.js');

      // We have to create a manual fieldset because fieldsets do not support IDs.
      // Use 'hidden' instead of 'markup' so that the process will run.
      $form['contexts_prefix'] = array(
        '#type' => 'hidden',
        '#id' => 'edit-path-substitutions',
        '#prefix' => '<div><fieldset id="edit-path-substitutions" class="collapsed collapsible"><legend>' . t('Substitutions') . '</legend>',
      );
      $rows = array();
      foreach ($contexts as $context) {
        foreach (ctools_context_get_converters('%' . check_plain($context->keyword) . ':', $context) as $keyword => $title) {
          $rows[] = array(
            check_plain($keyword),
            t('@identifier: @title', array(
              '@title' => $title,
              '@identifier' => $context->identifier,
            )),
          );
        }
      }
      $header = array(
        t('Keyword'),
        t('Value'),
      );
      $form['contexts']['context'] = array(
        '#value' => theme('table', $header, $rows),
      );
      $form['contexts_suffix'] = array(
        '#value' => '</fieldset></div>',
      );
    }
  }
  if (empty($conf['exposed'])) {
    $conf['exposed'] = array();
  }
  if ($allow['exposed_form']) {

    // If the exposed form is part of pane configuration, get the exposed
    // form re-tool it for our use.
    $exposed_form_state = array(
      'view' => &$view,
      'display' => &$view->display[$display_id],
    );
    $view
      ->set_exposed_input($conf['exposed']);
    if (version_compare(views_api_version(), '3', '>=')) {
      $exposed_form_state['exposed_form_plugin'] = $view->display_handler
        ->get_plugin('exposed_form');
    }
    $view
      ->init_handlers();
    $exposed_form = views_exposed_form($exposed_form_state);
    $form['exposed'] = array(
      '#tree' => TRUE,
    );
    foreach ($exposed_form['#info'] as $id => $info) {
      $form['exposed'][$id] = array(
        '#type' => 'item',
        '#id' => 'views-exposed-pane',
      );
      if (!empty($info['label'])) {
        $form['exposed'][$id]['#title'] = $info['label'];
      }
      if (!empty($info['operator']) && !empty($exposed_form[$info['operator']])) {
        $form['exposed'][$id][$info['operator']] = $exposed_form[$info['operator']];
        $form['exposed'][$id][$info['operator']]['#parents'] = array(
          'exposed',
          $info['operator'],
        );
        $form['exposed'][$id][$info['operator']]['#default_value'] = isset($conf['exposed'][$info['operator']]) ? $conf['exposed'][$info['operator']] : '';
      }
      $form['exposed'][$id][$info['value']] = $exposed_form[$info['value']];
      $form['exposed'][$id][$info['value']]['#parents'] = array(
        'exposed',
        $info['value'],
      );
      $form['exposed'][$id][$info['value']]['#default_value'] = isset($conf['exposed'][$info['value']]) ? $conf['exposed'][$info['value']] : '';
    }
  }
}

/**
 * Store form values in $conf.
 */
function views_content_views_panes_content_type_edit_form_submit(&$form, &$form_state) {

  // Copy everything from our defaults.
  $keys = array(
    'link_to_view',
    'more_link',
    'feed_icons',
    'use_pager',
    'pager_id',
    'items_per_page',
    'offset',
    'path_override',
    'path',
    'arguments',
    'fields_override',
    'exposed',
  );
  foreach ($keys as $key) {
    if (isset($form_state['values'][$key])) {
      $form_state['conf'][$key] = $form_state['values'][$key];
    }
  }
}

/**
 * Returns the administrative title for a type.
 */
function views_content_views_panes_content_type_admin_title($subtype, $conf, $contexts) {
  list($name, $display) = explode('-', $subtype);
  $view = views_get_view($name);
  if (empty($view) || empty($view->display[$display])) {
    return t('Deleted/missing view @view', array(
      '@view' => $name,
    ));
  }
  $view
    ->set_display($display);
  $title = $view->display_handler
    ->get_option('pane_title');
  return check_plain($title ? $title : $view->name);
}

/**
 * Returns the administrative title for a type.
 */
function views_content_views_panes_content_type_admin_info($subtype, $conf, $contexts) {
  $info = array();
  list($view_name, $display_name) = explode('-', $subtype);
  $view = views_get_view($view_name);
  if (empty($view) || empty($view->display[$display_name])) {
    return;
  }
  $view
    ->set_display($display_name);

  // Add arguments first
  if (!empty($conf['arguments'])) {
    $keys = array_keys($conf['arguments']);
    $values = array_values($conf['arguments']);
    $argument_input = $view->display_handler
      ->get_option('argument_input');
    foreach ($conf['arguments'] as $key => $value) {
      $label = $argument_input[$key]['label'];
      $info[] = $label . ': ' . $value;
    }
  }
  $block = new stdClass();
  if ($info) {
    $block->title = array_shift($info);
    $info[] = $view->display_handler
      ->get_option('pane_description');
    $block->content = theme('item_list', $info);
  }
  else {
    $block->title = $view->display_handler
      ->get_option('pane_description');
    $block->content = '';
  }
  return $block;
}

Functions

Namesort descending Description
views_content_views_panes_content_type_admin_info Returns the administrative title for a type.
views_content_views_panes_content_type_admin_title Returns the administrative title for a type.
views_content_views_panes_content_type_content_type Return a single content type.
views_content_views_panes_content_type_content_types Return all content types available.
views_content_views_panes_content_type_edit_form Returns an edit form for a block.
views_content_views_panes_content_type_edit_form_submit Store form values in $conf.
views_content_views_panes_content_type_render Output function for the 'views' content type.
views_content_views_panes_ctools_content_types Implementation of hook_ctools_content_types()
_views_content_panes_content_type