function taxonomy_get_children in Drupal 7

Same name and namespace in other branches

1. 4 modules/taxonomy.module \taxonomy_get_children()
2. 5 modules/taxonomy/taxonomy.module \taxonomy_get_children()
3. 6 modules/taxonomy/taxonomy.module \taxonomy_get_children()

Finds all children of a term ID.

Parameters

$tid: A taxonomy term ID.

$vid: An optional vocabulary ID to restrict the child search.

Return value

An array of term objects that are the children of the term $tid, or an empty array when no children exist.

3 calls to taxonomy_get_children()

TaxonomyQueryAlterTestCase::testTaxonomyQueryAlter in modules/taxonomy/taxonomy.test

Tests that appropriate tags are added when querying the database.

TaxonomyTermTestCase::testTaxonomyTermHierarchy in modules/taxonomy/taxonomy.test

Test terms in a single and multiple hierarchy.

taxonomy_term_delete in modules/taxonomy/taxonomy.module

Delete a term.

1 string reference to 'taxonomy_get_children'

taxonomy_terms_static_reset in modules/taxonomy/taxonomy.module

Clear all static cache variables for terms.

File

modules/taxonomy/taxonomy.module, line 1075

Enables the organization of content into categories.

Code

function taxonomy_get_children($tid, $vid = 0) {
  $children =& drupal_static(__FUNCTION__, array());
  if ($tid && !isset($children[$tid])) {
    $query = db_select('taxonomy_term_data', 't');
    $query
      ->join('taxonomy_term_hierarchy', 'h', 'h.tid = t.tid');
    $query
      ->addField('t', 'tid');
    $query
      ->condition('h.parent', $tid);
    if ($vid) {
      $query
        ->condition('t.vid', $vid);
    }
    $query
      ->addTag('taxonomy_term_access');
    $query
      ->orderBy('t.weight');
    $query
      ->orderBy('t.name');
    $tids = $query
      ->execute()
      ->fetchCol();
    $children[$tid] = taxonomy_term_load_multiple($tids);
  }
  return isset($children[$tid]) ? $children[$tid] : array();
}