get_edit_term_link( int|WP_Term|object $term, string $taxonomy = , string $object_type =  ): string|null

Retrieves the URL for editing a given term.

Parameters

$termint|WP_Term|objectrequired
The ID or term object whose edit link will be retrieved.
$taxonomystringoptional
Taxonomy. Defaults to the taxonomy of the term identified by $term.

Default:''

$object_typestringoptional
The object type. Used to highlight the proper post type menu on the linked page. Defaults to the first object_type associated with the taxonomy.

Default:''

Return

string|null The edit term link URL for the given term, or null on failure.

Source

function get_edit_term_link( $term, $taxonomy = '', $object_type = '' ) {
	$term = get_term( $term, $taxonomy );
	if ( ! $term || is_wp_error( $term ) ) {
		return;
	}

	$tax     = get_taxonomy( $term->taxonomy );
	$term_id = $term->term_id;
	if ( ! $tax || ! current_user_can( 'edit_term', $term_id ) ) {
		return;
	}

	$args = array(
		'taxonomy' => $taxonomy,
		'tag_ID'   => $term_id,
	);

	if ( $object_type ) {
		$args['post_type'] = $object_type;
	} elseif ( ! empty( $tax->object_type ) ) {
		$args['post_type'] = reset( $tax->object_type );
	}

	if ( $tax->show_ui ) {
		$location = add_query_arg( $args, admin_url( 'term.php' ) );
	} else {
		$location = '';
	}

	/**
	 * Filters the edit link for a term.
	 *
	 * @since 3.1.0
	 *
	 * @param string $location    The edit link.
	 * @param int    $term_id     Term ID.
	 * @param string $taxonomy    Taxonomy name.
	 * @param string $object_type The object type.
	 */
	return apply_filters( 'get_edit_term_link', $location, $term_id, $taxonomy, $object_type );
}

Hooks

apply_filters( ‘get_edit_term_link’, string $location, int $term_id, string $taxonomy, string $object_type )

Filters the edit link for a term.

Changelog

VersionDescription
4.5.0The $taxonomy parameter was made optional.
3.1.0Introduced.

User Contributed Notes

  1. Skip to note 4 content

    Example from the legacy Codex:

    Using get_edit_tag_link() may be a better choice in most situations as it will apply the ‘get_edit_tag_link‘ filter, which may be implemented by plugins and themes.

    function get_edit_tag_link( $tag_id, $taxonomy = 'post_tag' ) {
    	return apply_filters( 'get_edit_tag_link', get_edit_term_link( $tag_id, $taxonomy ) );
    }

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