wp-includes/taxonomy.php:3210Updates term based on arguments provided.
$term_idint$taxonomystring$argsarrayoptionalarray()$alias_ofstringdefault: empty string. Accepts a term slug
$descriptionstringdefault: empty string
$parentintdefault: 0
$slugstringdefault: empty string
array|WP_Error13 hooks fire while wp_update_term() runs, in this order:
Fires immediately before the given terms are edited.
Filters term data before it is updated in the database.
Fires immediately after a term is updated in the database, but before its term-taxonomy relationship is updated.
Fires immediate before a term-taxonomy relationship is updated.
Fires immediately after a term-taxonomy relationship is updated.
Fires after a term has been updated, but before the term cache has been cleaned.
Fires after a term in a specific taxonomy has been updated, but before the term cache has been cleaned.
Filters the term ID after a new term is created.
Fires after a term has been updated, and the term cache has been cleaned.
Fires after a term for a specific taxonomy has been updated, and the term cache has been cleaned.
Fires after a term has been saved, and the term cache has been cleared.
Fires after a term in a specific taxonomy has been saved, and the term cache has been cleared.
function wp_update_term( $term_id, $taxonomy, $args = array() ) { global $wpdb; if ( ! taxonomy_exists( $taxonomy ) ) { return new WP_Error( 'invalid_taxonomy', __( 'Invalid taxonomy.' ) ); } $term_id = (int) $term_id; // First, get all of the original args. $term = get_term( $term_id, $taxonomy ); if ( is_wp_error( $term ) ) { return $term; } if ( ! $term ) { return new WP_Error( 'invalid_term', __( 'Empty Term.' ) ); } $term = (array) $term->data; // Escape data pulled from DB. $term = wp_slash( $term ); // Merge old and new args with new args overwriting old ones. $args = array_merge( $term, $args ); $defaults = array( 'alias_of' => '', 'description' => '', 'parent' => 0, 'slug' => '', ); $args = wp_parse_args( $args, $defaults ); $args = sanitize_term( $args, $taxonomy, 'db' ); $parsed_args = $args; // expected_slashed ($name) $name = wp_unslash( $args['name'] ); $description = wp_unslash( $args['description'] ); $parsed_args['name'] = $name; $parsed_args['description'] = $description; if ( '' === trim( $name ) ) { return new WP_Error( 'empty_term_name', __( 'A name is required for this term.' ) ); } if ( (int) $parsed_args['parent'] > 0 && ! term_exists( (int) $parsed_args['parent'] ) ) { return new WP_Error( 'missing_parent', __( 'Parent term does not exist.' ) ); } $empty_slug = false; if ( empty( $args['slug'] ) ) { $empty_slug = true; $slug = sanitize_title( $name ); } else { $slug = $args['slug']; } $parsed_args['slug'] = $slug; $term_group = isset( $parsed_args['term_group'] ) ? $parsed_args['term_group'] : 0; if ( $args['alias_of'] ) { $alias = get_term_by( 'slug', $args['alias_of'], $taxonomy ); if ( ! empty( $alias->term_group ) ) { // The alias we want is already in a group, so let's use that one. $term_group = $alias->term_group; } elseif ( ! empty( $alias->term_id ) ) { /* * The alias is not in a group, so we create a new one * and add the alias to it. */ $term_group = $wpdb->get_var( "SELECT MAX(term_group) FROM $wpdb->terms" ) + 1; wp_update_term( $alias->term_id, $taxonomy, array(Introduced in 2.3.0. Unchanged from 6.7.7 through 7.1.0.
Signature, return type and hooks compared across 5 parsed releases.
src/wp-includes/taxonomy.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.