_taxonomy_term_select

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()

2 calls to _taxonomy_term_select()

File

modules/taxonomy/taxonomy.module, line 1126

Enables the organization of content into categories.

Code

function _taxonomy_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)) {
        $choice = new stdClass();
        $choice->option = array($term->tid => str_repeat('-', $term->depth) . $term->name);
        $options[] = $choice;
      }
    }
  }

  return 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',
  );
}