function _taxonomy_term_select in Drupal 5

Same name and namespace in other branches

1. 4 modules/taxonomy.module \_taxonomy_term_select()
2. 6 modules/taxonomy/taxonomy.module \_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()

taxonomy_form in modules/taxonomy/taxonomy.module

Generate a form element for selecting terms from a vocabulary.

taxonomy_form_term in modules/taxonomy/taxonomy.module

File

modules/taxonomy/taxonomy.module, line 1208

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