function taxonomy_del_term in Drupal 6

Same name and namespace in other branches

1. 4 modules/taxonomy.module \taxonomy_del_term()
2. 5 modules/taxonomy/taxonomy.module \taxonomy_del_term()

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 modules/forum/forum.admin.inc

Implementation of forms api _submit call. Deletes a forum after confirmation.

taxonomy_del_vocabulary in modules/taxonomy/taxonomy.module

Delete a vocabulary.

taxonomy_save_term in modules/taxonomy/taxonomy.module

Helper function for taxonomy_form_term_submit().

taxonomy_term_confirm_delete_submit in modules/taxonomy/taxonomy.admin.inc

Submit handler to delete a term after confirmation.

File

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;
}