function taxonomy_get_parents

7.x taxonomy.module	`taxonomy_get_parents($tid)`
6.x taxonomy.module	`taxonomy_get_parents($tid, $key = 'tid')`

Finds all parents of a given term ID.

Parameters

$tid: A taxonomy term ID.

Return value

An array of term objects which are the parents of the term $tid, or an empty array if parents are not found.

8 calls to taxonomy_get_parents()

TaxonomyTermTestCase::testTaxonomyTermHierarchy in drupal-7.x/modules/taxonomy/taxonomy.test: Test terms in a single and multiple hierarchy.
TaxonomyTermTestCase::testTermMultipleParentsInterface in drupal-7.x/modules/taxonomy/taxonomy.test: Test saving a term with multiple parents through the UI.
taxonomy_form_term in drupal-7.x/modules/taxonomy/taxonomy.admin.inc: Form function for the term edit form.
taxonomy_get_parents_all in drupal-7.x/modules/taxonomy/taxonomy.module: Find all ancestors of a given term ID.
taxonomy_term_delete in drupal-7.x/modules/taxonomy/taxonomy.module: Delete a term.

... See full list

1 string reference to 'taxonomy_get_parents'

taxonomy_terms_static_reset in drupal-7.x/modules/taxonomy/taxonomy.module: Clear all static cache variables for terms.

File

drupal-7.x/modules/taxonomy/taxonomy.module, line 1007: Enables the organization of content into categories.

Code

function taxonomy_get_parents($tid) {
  $parents = &drupal_static(__FUNCTION__, array());

  if ($tid && !isset($parents[$tid])) {
    $query = db_select('taxonomy_term_data', 't');
    $query->join('taxonomy_term_hierarchy', 'h', 'h.parent = t.tid');
    $query->addField('t', 'tid');
    $query->condition('h.tid', $tid);
    $query->addTag('term_access');
    $query->orderBy('t.weight');
    $query->orderBy('t.name');
    $tids = $query->execute()->fetchCol();
    $parents[$tid] = taxonomy_term_load_multiple($tids);
  }

  return isset($parents[$tid]) ? $parents[$tid] : array();
}