WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

edited_{$taxonomy}

do_action( “edited_{$taxonomy}”, int $term_id, int $tt_id, array $args )

In this article

Back to top

Fires after a term for a specific taxonomy has been updated, and the term cache has been cleaned.

Description

The dynamic portion of the hook name, $taxonomy, refers to the taxonomy slug.

Possible hook names include:

  • edited_category
  • edited_post_tag

Parameters

$term_idint
Term ID.
$tt_idint
Term taxonomy ID.
$argsarray
Arguments passed to wp_update_term() .
More Arguments from wp_update_term( … $args )Array of arguments for updating a term.
  • alias_of string
    Slug of the term to make this term an alias of.
    Default empty string. Accepts a term slug.
  • description string
    The term description. Default empty string.
  • parent int
    The id of the parent term. Default 0.
  • slug string
    The term slug to use. Default empty string.

More Information

The edit_$taxonomy action is used to hook into code after a custom taxonomy term is updated in the database.

A plugin (or theme) can register an action hook from the example below.

Source

do_action( "edited_{$taxonomy}", $term_id, $tt_id, $args );

View all references View on Trac View on GitHub

Used byDescription
wp_update_term()wp-includes/taxonomy.php

Updates term based on arguments provided.

Changelog

VersionDescription
6.1.0The $args parameter was added.
2.3.0Introduced.

User Contributed Notes

  1. Skip to note 3 content
    Akira Tachibana
    You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

    Example from Codex

    <?php 
add_action( 'edited_custom_taxonomy', 'custom_term_slug_edit_success', 10, 2 );

/**
 * Custom redirect on taxonomy term update, keeps users on the term page for additional updates
 *
 * @param $term_id
 * @param $tt_id
 */
function custom_term_slug_edit_success( $term_id, $tt_id ) {
  
    // Get the taxonomy slug.
    $term = get_term( $term_id );
    $tax_slug = $term->taxonomy;
    
    // Setup the redirect URL.
    $tax_param = '&taxonomy=' . $taxonomy_slug;
    $term_param = '&tag_ID=' . $term_id;
    $notice_param = '&notice=success';
    $redirect_url = admin_url( 'edit-tags.php?action=edit' . $tax_param . $tag_param . $notice_param );

    // Redirect with new query strings.
    wp_safe_redirect( $redirect_url );
    exit;

}
?>
  2. Skip to note 4 content
    Collins Mbaka
    You must log in to vote on the helpfulness of this noteVote results for this note: -1You must log in to vote on the helpfulness of this note
    add_action( 'edited_custom_taxonomy', 'custom_term_slug_edit_success', 10, 2 );

/**
 * Custom redirect on taxonomy term update, keeps users on the term page for additional updates
 *
 * @param $term_id
 * @param $tt_id
 */
function custom_term_slug_edit_success( $term_id, $tt_id ) {
  
    // Get the taxonomy slug.
    $term = get_term( $term_id );
    $tax_slug = $term->taxonomy;
    
    // Setup the redirect URL.
    $tax_param = '&taxonomy=' . $taxonomy_slug;
    $term_param = '&tag_ID=' . $term_id;
    $notice_param = '&notice=success';
    $redirect_url = admin_url( 'edit-tags.php?action=edit' . $tax_param . $tag_param . $notice_param );

    // Redirect with new query strings.
    wp_safe_redirect( $redirect_url );
    exit;

}

You must log in before being able to contribute a note or feedback.