You are here

context.theme.inc in Chaos Tool Suite (ctools) 7

Same filename and directory in other branches
  1. 6 includes/context.theme.inc

Contains theme registry and theme implementations for the context tool.

File

includes/context.theme.inc
View source
<?php

/**
 * @file
 * Contains theme registry and theme implementations for the context tool.
 */

/**
 * Implements hook_theme()
 */
function ctools_context_theme(&$theme) {
  $theme['ctools_context_list'] = array(
    'variables' => array(
      'object' => NULL,
    ),
    'file' => 'includes/context.theme.inc',
  );
  $theme['ctools_context_list_no_table'] = array(
    'variables' => array(
      'object' => NULL,
    ),
    'file' => 'includes/context.theme.inc',
  );
  $theme['ctools_context_item_form'] = array(
    'render element' => 'form',
    'file' => 'includes/context.theme.inc',
  );
  $theme['ctools_context_item_row'] = array(
    'variables' => array(
      'type' => NULL,
      'form' => NULL,
      'position' => NULL,
      'count' => NULL,
      'with_tr' => TRUE,
    ),
    'file' => 'includes/context.theme.inc',
  );

  // For the access plugin.
  $theme['ctools_access_admin_add'] = array(
    'render element' => 'form',
    'file' => 'includes/context-access-admin.inc',
  );
}

/**
 * Theme the form item for the context entry.
 */
function theme_ctools_context_item_row($vars) {
  $type = $vars['type'];
  $form = $vars['form'];
  $position = $vars['position'];
  $count = $vars['count'];
  $with_tr = $vars['with_tr'];
  $output = '<td class="title">&nbsp;' . render($form['title']) . '</td>';
  if (!empty($form['position'])) {
    $output .= '<td class="position">&nbsp;' . render($form['position']) . '</td>';
  }
  $output .= '<td class="operation">' . render($form['settings']);
  $output .= render($form['remove']) . '</td>';
  if ($with_tr) {
    $output = '<tr id="' . $type . '-row-' . $position . '" class="draggable ' . $type . '-row ' . ($count % 2 ? 'even' : 'odd') . '">' . $output . '</tr>';
  }
  return $output;
}

/**
 * Display the context item.
 */
function theme_ctools_context_item_form($vars) {
  $form = $vars['form'];
  $output = '';
  $type = $form['#ctools_context_type'];
  $module = $form['#ctools_context_module'];
  $cache_key = $form['#cache_key'];
  $type_info = ctools_context_info($type);
  if (!empty($form[$type]) && empty($form['#only_buttons'])) {
    $count = 0;
    $rows = '';
    foreach (array_keys($form[$type]) as $id) {
      if (!is_numeric($id)) {
        continue;
      }
      $theme_vars = array();
      $theme_vars['type'] = $type;
      $theme_vars['form'] = $form[$type][$id];
      $theme_vars['position'] = $id;
      $theme_vars['count'] = $count++;
      $rows .= theme('ctools_context_item_row', $theme_vars);
    }
    $output .= '<table id="' . $type . '-table">';
    $output .= '<thead>';
    $output .= '<tr>';
    $output .= '<th class="title">' . $type_info['title'] . '</th>';
    if (!empty($type_info['sortable']) && $count) {
      $output .= '<th class="position">' . t('Weight') . '</th>';
    }
    $output .= '<th class="operation">' . t('Operation') . '</th>';
    $output .= '</tr>';
    $output .= '</thead>';
    $output .= '<tbody>';
    $output .= $rows;
    $output .= '</tbody>';
    $output .= '</table>';
  }
  if (!empty($form['buttons'])) {

    // Display the add context item.
    $row = array();
    $row[] = array(
      'data' => render($form['buttons'][$type]['item']),
      'class' => array(
        'title',
      ),
    );
    $row[] = array(
      'data' => render($form['buttons'][$type]['add']),
      'class' => array(
        'add',
      ),
      'width' => "60%",
    );
    $output .= '<div class="buttons">';
    $output .= render($form['buttons'][$type]);
    $theme_vars = array();
    $theme_vars['header'] = array();
    $theme_vars['rows'] = array(
      $row,
    );
    $theme_vars['attributes'] = array(
      'id' => $type . '-add-table',
    );
    $output .= theme('table', $theme_vars);
    $output .= '</div>';
  }
  if (!empty($form['description'])) {
    $output .= render($form['description']);
  }
  if (!empty($type_info['sortable'])) {
    drupal_add_tabledrag($type . '-table', 'order', 'sibling', 'drag-position');
  }
  return $output;
}

/**
 * Create a visible list of all the contexts available on an object.
 * Assumes arguments, relationships and context objects.
 *
 * Contexts must be preloaded.
 */
function theme_ctools_context_list($vars) {
  $object = $vars['object'];
  $header = $vars['header'];
  $description = !empty($vars['description']) ? $vars['description'] : NULL;
  $titles = array();
  $output = '';
  $count = 1;
  $contexts = ctools_context_load_contexts($object);

  // Describe 'built in' contexts.
  if (!empty($object->base_contexts)) {
    foreach ($object->base_contexts as $id => $context) {
      $output .= '<tr>';
      $output .= '<td valign="top"><em>' . t('Built in context') . '</em></td>';
      $desc = check_plain($context->identifier);
      if (isset($context->keyword)) {
        $desc .= '<div class="description">' . t('Keyword: %@keyword', array(
          '@keyword' => $context->keyword,
        ));
        foreach (ctools_context_get_converters('%' . $context->keyword . ':', $context) as $keyword => $title) {
          $desc .= '<br />' . t('@keyword --&gt; @title', array(
            '@keyword' => $keyword,
            '@title' => $title,
          ));
        }
        $desc .= '</div>';
      }
      if (isset($context->description)) {
        $desc .= '<div class="description">' . filter_xss_admin($context->description) . '</div>';
      }
      $output .= '<td>' . $desc . '</td>';
      $output .= '</tr>';
      $titles[$id] = $context->identifier;
    }
  }

  // First, make a list of arguments. Arguments are pretty simple.
  if (!empty($object->arguments)) {
    foreach ($object->arguments as $argument) {
      $output .= '<tr>';
      $output .= '<td valign="top"><em>' . t('Argument @count', array(
        '@count' => $count,
      )) . '</em></td>';
      $desc = check_plain($argument['identifier']);
      if (isset($argument['keyword'])) {
        $desc .= '<div class="description">' . t('Keyword: %@keyword', array(
          '@keyword' => $argument['keyword'],
        ));
        if (isset($contexts[ctools_context_id($argument, 'argument')])) {
          foreach (ctools_context_get_converters('%' . $argument['keyword'] . ':', $contexts[ctools_context_id($argument, 'argument')]) as $keyword => $title) {
            $desc .= '<br />' . t('@keyword --&gt; @title', array(
              '@keyword' => $keyword,
              '@title' => $title,
            ));
          }
        }
        $desc .= '</div>';
      }
      $output .= '<td>' . $desc . '</td>';
      $output .= '</tr>';
      $titles[ctools_context_id($argument, 'argument')] = $argument['identifier'];
      $count++;
    }
  }
  $count = 1;

  // Then, make a nice list of contexts.
  if (!empty($object->contexts)) {
    foreach ($object->contexts as $context) {
      $output .= '<tr>';
      $output .= '<td valign="top"><em>' . t('Context @count', array(
        '@count' => $count,
      )) . '</em></td>';
      $desc = check_plain($context['identifier']);
      if (isset($context['keyword'])) {
        $desc .= '<div class="description">' . t('Keyword: %@keyword', array(
          '@keyword' => $context['keyword'],
        ));
        foreach (ctools_context_get_converters('%' . $context['keyword'] . ':', $contexts[ctools_context_id($context, 'context')]) as $keyword => $title) {
          $desc .= '<br />' . t('@keyword --&gt; @title', array(
            '@keyword' => $keyword,
            '@title' => $title,
          ));
        }
        $desc .= '</div>';
      }
      $output .= '<td>' . $desc . '</td>';
      $output .= '</tr>';
      $titles[ctools_context_id($context)] = $context['identifier'];
      $count++;
    }
  }

  // And relationships.
  if (!empty($object->relationships)) {
    foreach ($object->relationships as $relationship) {
      $output .= '<tr>';
      if (is_array($relationship['context'])) {
        $rtitles = array();
        foreach ($relationship['context'] as $cid) {
          $rtitles[$cid] = $titles[$cid];
        }
        $title = implode(' + ', $rtitles);
      }
      else {
        $title = $titles[$relationship['context']];
      }
      $output .= '<td valign="top"><em>' . t('From "@title"', array(
        '@title' => $title,
      )) . '</em></td>';
      $desc = check_plain($relationship['identifier']);
      if (isset($relationship['keyword'])) {
        $desc .= '<div class="description">' . t('Keyword: %@keyword', array(
          '@keyword' => $relationship['keyword'],
        ));
        foreach (ctools_context_get_converters('%' . $relationship['keyword'] . ':', $contexts[ctools_context_id($relationship, 'relationship')]) as $keyword => $title) {
          $desc .= '<br />' . t('@keyword --&gt; @title', array(
            '@keyword' => $keyword,
            '@title' => $title,
          ));
        }
        $desc .= '</div>';
      }
      $output .= '<td>' . $desc . '</td>';
      $output .= '</tr>';
      $titles[ctools_context_id($relationship, 'relationship')] = $relationship['identifier'];
      $count++;
    }
  }
  $head = '';
  if ($header) {
    if ($description) {
      $header .= '<div class="description">' . $description . '</div>';
    }
    $head .= '<thead><tr>';
    $head .= '<th colspan="2">' . $header . '</th>';
    $head .= '</tr></thead>';
  }
  return $output ? "<table>{$head}<tbody>{$output}</tbody></table>\n" : "<table>{$head}</table>\n";
}

/**
 * The ctools_context_list() function but not in a table format because
 * tabledrag won't let us have tables within tables and still drag.
 */
function theme_ctools_context_list_no_table($vars) {
  $object = $vars['object'];
  ctools_add_css('context');
  $titles = array();
  $output = '';
  $count = 1;

  // Describe 'built in' contexts.
  if (!empty($object->base_contexts)) {
    foreach ($object->base_contexts as $id => $context) {
      $output .= '<div class="ctools-context-holder clearfix">';
      $output .= '<div class="ctools-context-title">' . t('Built in context') . '</div>';
      $desc = check_plain($context->identifier);
      if (isset($context->keyword)) {
        $desc .= '<div class="description">' . t('Keyword: %@keyword', array(
          '@keyword' => $context->keyword,
        )) . '</div>';
      }
      if (isset($context->description)) {
        $desc .= '<div class="description">' . filter_xss_admin($context->description) . '</div>';
      }
      $output .= '<div class="ctools-context-content">' . $desc . '</div>';
      $output .= '</div>';
      $titles[$id] = $context->identifier;
      $count++;
    }
  }

  // First, make a list of arguments. Arguments are pretty simple.
  if (!empty($object->arguments)) {
    foreach ($object->arguments as $argument) {
      $output .= '<div class="ctools-context-holder clearfix">';
      $output .= '<div class="ctools-context-title">' . t('Argument @count', array(
        '@count' => $count,
      )) . '</div>';
      $desc = check_plain($argument['identifier']);
      if (isset($argument['keyword'])) {
        $desc .= '<div class="description">' . t('Keyword: %@keyword', array(
          '@keyword' => $argument['keyword'],
        )) . '</div>';
      }
      $output .= '<div class="ctools-context-content">' . $desc . '</div>';
      $output .= '</div>';
      $titles[ctools_context_id($argument, 'argument')] = $argument['identifier'];
      $count++;
    }
  }
  $count = 1;

  // Then, make a nice list of contexts.
  if (!empty($object->contexts)) {
    foreach ($object->contexts as $context) {
      $output .= '<div class="ctools-context-holder clearfix">';
      $output .= '<div class="ctools-context-title">' . t('Context @count', array(
        '@count' => $count,
      )) . '</div>';
      $desc = check_plain($context['identifier']);
      if (isset($context['keyword'])) {
        $desc .= '<div class="description">' . t('Keyword: %@keyword', array(
          '@keyword' => $context['keyword'],
        )) . '</div>';
      }
      $output .= '<div class="ctools-context-content">' . $desc . '</div>';
      $output .= '</div>';
      $titles[ctools_context_id($context)] = $context['identifier'];
      $count++;
    }
  }

  // And relationships.
  if (!empty($object->relationships)) {
    foreach ($object->relationships as $relationship) {
      $output .= '<div class="ctools-context-holder clearfix">';
      if (is_array($relationship['context'])) {
        $rtitles = array();
        foreach ($relationship['context'] as $cid) {
          $rtitles[$cid] = $titles[$cid];
        }
        $title = implode(' + ', $rtitles);
      }
      else {
        $title = $titles[$relationship['context']];
      }
      $output .= '<div class="ctools-context-title">' . t('From "@title"', array(
        '@title' => $title,
      )) . '</div>';
      $desc = check_plain($relationship['identifier']);
      if (isset($relationship['keyword'])) {
        $desc .= '<div class="description">' . t('Keyword: %@keyword', array(
          '@keyword' => $relationship['keyword'],
        )) . '</div>';
      }
      $output .= '<div class="ctools-context-content">' . $desc . '</div>';
      $output .= '</div>';
      $titles[ctools_context_id($relationship, 'relationship')] = $relationship['identifier'];
      $count++;
    }
  }
  return $output;
}

Functions

Namesort descending Description
ctools_context_theme Implements hook_theme()
theme_ctools_context_item_form Display the context item.
theme_ctools_context_item_row Theme the form item for the context entry.
theme_ctools_context_list Create a visible list of all the contexts available on an object. Assumes arguments, relationships and context objects.
theme_ctools_context_list_no_table The ctools_context_list() function but not in a table format because tabledrag won't let us have tables within tables and still drag.