node_terms.inc in Chaos Tool Suite (ctools) 7

File

plugins/content_types/node_context/node_terms.inc

<?php

/**
 * @file
 * Plugins are described by creating a $plugin array which will be used
 * by the system that includes this file.
 */
$plugin = array(
  'single' => TRUE,
  'title' => t('Node terms'),
  'icon' => 'icon_node.png',
  'description' => t('Taxonomy terms of the referenced node.'),
  'required context' => new ctools_context_required(t('Node'), 'node'),
  'category' => t('Node'),
  'defaults' => array(
    'vid' => 0,
    'term_format' => 'term-links',
    'link' => TRUE,
    'term_delimiter' => ', ',
  ),
);

/**
 * Render the node_terms content type.
 */
function ctools_node_terms_content_type_render($subtype, $conf, $panel_args, $context) {
  if (empty($context) || empty($context->data)) {
    return;
  }

  // Get a shortcut to the node.
  $node = $context->data;

  // Load all terms for this node from all vocabularies.
  $query = db_select('taxonomy_index', 't');
  $result = $query
    ->fields('t')
    ->condition('t.nid', $node->nid)
    ->execute();
  $tids = array();
  foreach ($result as $term) {
    $tids[] = $term->tid;
  }

  // Get the real term objects.
  $term_objects = taxonomy_term_load_multiple($tids);
  $terms = array();
  if (empty($conf['vid'])) {

    // All terms.
    foreach ($term_objects as $term) {
      $terms['taxonomy_term_' . $term->tid] = array(
        'title' => check_plain($term->name),
        'href' => 'taxonomy/term/' . $term->tid,
        'attributes' => array(
          'rel' => 'tag',
          'title' => strip_tags($term->description),
        ),
      );
    }
  }
  else {

    // They want something special and custom, we'll have to do this ourselves.
    foreach ($term_objects as $term) {
      if ($term->vid == $conf['vid']) {
        if ($conf['term_format'] == 'term-links') {
          $terms['taxonomy_term_' . $term->tid] = array(
            'title' => $term->name,
            'href' => 'taxonomy/term/' . $term->tid,
            'attributes' => array(
              'rel' => 'tag',
              'title' => strip_tags($term->description),
            ),
          );
        }
        elseif (empty($conf['link'])) {
          $terms[] = check_plain($term->name);
        }
        else {
          $terms[] = l($term->name, 'taxonomy/term/' . $term->tid, array(
            'attributes' => array(
              'rel' => 'tag',
              'title' => strip_tags($term->description),
            ),
          ));
        }
      }
    }
  }
  $formatted_terms = '';
  switch ($conf['term_format']) {
    case 'term-links':
      drupal_alter('link', $terms, $node);
      $formatted_terms = theme('links', array(
        'links' => $terms,
      ));
      break;
    case 'ul':
      $formatted_terms = theme('item_list', array(
        'items' => $terms,
      ));
      break;
    case 'inline-delimited':
      $delimiter = isset($conf['term_delimiter']) ? $conf['term_delimiter'] : ', ';
      $processed_terms = array();
      foreach ($terms as $key => $term) {
        if (is_string($term)) {
          $processed_terms[$key] = $term;
        }
        else {
          $terms[$key] = l($term['title'], $term['href'], $term);
        }
      }
      $formatted_terms = implode($delimiter, $processed_terms);
      break;
  }

  // Build the content type block.
  $block = new stdClass();
  $block->module = 'node_terms';
  $block->delta = $node->nid;
  $block->title = t('Terms');
  $block->content = $formatted_terms;
  return $block;
}

/**
 * Returns an edit form for node terms display settings.
 *
 * The first question is if they want to display all terms or restrict it to a
 * specific taxonomy vocabulary.
 *
 * Then, they're presented with a set of radios to find out how they want the
 * terms formatted, which can be either be via theme('links'), a regular item
 * list (ul), or inline with a delimiter.  Depending on which radio they
 * choose, some other settings might appear. If they're doing either the ul or
 * inline, we ask if they want the terms to appear as links or not. If they
 * want it inline, we ask what delimiter they want to use.
 */
function ctools_node_terms_content_type_edit_form($form, &$form_state) {
  ctools_include('dependent');
  $conf = $form_state['conf'];
  $options = array();
  $options[0] = t('- All vocabularies -');
  foreach (taxonomy_get_vocabularies() as $vid => $vocabulary) {
    $options[$vid] = $vocabulary->name;
  }
  $form['vid'] = array(
    '#title' => t('Vocabulary'),
    '#type' => 'select',
    '#options' => $options,
    '#default_value' => $conf['vid'],
    '#description' => t('Optionally restrict the terms to a specific vocabulary, or allow terms from all vocabularies.'),
    '#prefix' => '<div class="clearfix">',
    '#suffix' => '</div>',
  );
  $form['term_format'] = array(
    '#type' => 'radios',
    '#title' => t('Term formatting'),
    '#options' => array(
      'term-links' => t("Taxonomy links (uses theme('links'))"),
      'ul' => t('Unordered list'),
      'inline-delimited' => t('Inline, delimited'),
    ),
    '#default_value' => $conf['term_format'],
    '#prefix' => '<div class="clearfix">',
    '#suffix' => '</div>',
  );
  $form['link'] = array(
    '#title' => t('Link to terms'),
    '#type' => 'checkbox',
    '#default_value' => $conf['link'],
    '#description' => t('Check here to make the terms link to the term paths.'),
    '#dependency' => array(
      'radio:term_format' => array(
        'inline-delimited',
        'ul',
      ),
    ),
    '#prefix' => '<div class="clearfix">',
    '#suffix' => '</div>',
  );
  $form['term_delimiter'] = array(
    '#type' => 'textfield',
    '#title' => t('Term delimiter'),
    '#default_value' => $conf['term_delimiter'],
    '#size' => 10,
    '#dependency' => array(
      'radio:term_format' => array(
        'inline-delimited',
      ),
    ),
  );
  return $form;
}

/**
 * Submit handler for the custom type settings form.
 */
function ctools_node_terms_content_type_edit_form_submit($form, &$form_state) {

  // Copy everything from our defaults.
  foreach (array_keys($form_state['plugin']['defaults']) as $key) {
    $form_state['conf'][$key] = $form_state['values'][$key];
  }
}

/**
 * Returns the administrative title for a type.
 */
function ctools_node_terms_content_type_admin_title($subtype, $conf, $context) {
  $placeholders['@s'] = $context->identifier;
  if (!empty($conf['vid'])) {
    $vocabulary = taxonomy_vocabulary_load($conf['vid']);
    $placeholders['@vocabulary'] = $vocabulary->name;
    return t('"@s" terms from @vocabulary', $placeholders);
  }
  return t('"@s" terms', $placeholders);
}

Functions

Name	Description
ctools_node_terms_content_type_admin_title	Returns the administrative title for a type.
ctools_node_terms_content_type_edit_form	Returns an edit form for node terms display settings.
ctools_node_terms_content_type_edit_form_submit	Submit handler for the custom type settings form.
ctools_node_terms_content_type_render	Render the node_terms content type.