function taxonomy_del_term

6.x taxonomy.module taxonomy_del_term($tid)

Delete a term.

Parameters

$tid: The term ID.

Return value

Status constant indicating deletion.

4 calls to taxonomy_del_term()

forum_confirm_delete_submit in drupal-6.x/modules/forum/forum.admin.inc: Implementation of forms api _submit call. Deletes a forum after confirmation.
taxonomy_del_vocabulary in drupal-6.x/modules/taxonomy/taxonomy.module: Delete a vocabulary.
taxonomy_save_term in drupal-6.x/modules/taxonomy/taxonomy.module: Helper function for taxonomy_form_term_submit().
taxonomy_term_confirm_delete_submit in drupal-6.x/modules/taxonomy/taxonomy.admin.inc: Submit handler to delete a term after confirmation.

File

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

Code

function taxonomy_del_term($tid) {
  $tids = array($tid);
  while ($tids) {
    $children_tids = $orphans = array();
    foreach ($tids as $tid) {
      // See if any of the term's children are about to be become orphans:
      if ($children = taxonomy_get_children($tid)) {
        foreach ($children as $child) {
          // If the term has multiple parents, we don't delete it.
          $parents = taxonomy_get_parents($child->tid);
          if (count($parents) == 1) {
            $orphans[] = $child->tid;
          }
        }
      }

      $term = (array) taxonomy_get_term($tid);

      db_query('DELETE FROM {term_data} WHERE tid = %d', $tid);
      db_query('DELETE FROM {term_hierarchy} WHERE tid = %d', $tid);
      db_query('DELETE FROM {term_relation} WHERE tid1 = %d OR tid2 = %d', $tid, $tid);
      db_query('DELETE FROM {term_synonym} WHERE tid = %d', $tid);
      db_query('DELETE FROM {term_node} WHERE tid = %d', $tid);

      module_invoke_all('taxonomy', 'delete', 'term', $term);
    }

    $tids = $orphans;
  }

  cache_clear_all();

  return SAVED_DELETED;
}