function _taxonomy_container_term_select in Taxonomy container 6

Create a select form element for a given taxonomy vocabulary.

NOTE: This function expects input that has already been sanitized and is safe for display. Callers must properly sanitize the $title and $description arguments to prevent XSS vulnerabilities.

Parameters

$title: The title of the vocabulary. This MUST be sanitized by the caller.

$name: Ignored.

$value: The currently selected terms from this vocabulary, if any.

$vocabulary_id: The vocabulary ID to build the form element for.

$description: Help text for the form element. This MUST be sanitized by the caller.

$multiple: Boolean to control if the form should use a single or multiple select.

$blank: Optional form choice to use when no value has been selected.

$exclude: Optional array of term ids to exclude in the selector.

Return value

A FAPI form array to select terms from the given vocabulary.

See also

taxonomy_form()

taxonomy_form_term()

1 string reference to '_taxonomy_container_term_select'

taxonomy_container_form in ./taxonomy_container.module

Generate a form element for selecting terms from a vocabulary.

File

./taxonomy_container.module, line 167

Allows users to organize containers using taxonomy terms.

Code

function _taxonomy_container_term_select($title, $name, $value, $vocabulary_id, $description, $multiple, $blank, $exclude = array()) {
  $tree = taxonomy_get_tree($vocabulary_id);
  $options = array();
  if ($blank) {
    $options[''] = $blank;
  }
  if ($tree) {
    foreach ($tree as $term) {
      if (!in_array($term->tid, $exclude)) {
        if ($term->parents[0] == 0) {
          $parent_name = $term->name;
        }
        else {
          $choice = new stdClass();
          $choice->option = array(
            $term->tid => str_repeat('-', $term->depth) . ' ' . $term->name,
          );
          $options[$parent_name][$term->tid] = $choice;
        }
      }
    }
  }
  $select = array(
    '#type' => 'select',
    '#title' => $title,
    '#default_value' => $value,
    '#options' => $options,
    '#description' => $description,
    '#multiple' => $multiple,
    '#size' => $multiple ? min(9, count($options)) : 0,
    '#weight' => -15,
    '#theme' => 'taxonomy_term_select',
  );
  return $select;
}