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

Parameters

$termint|WP_Term|object

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.

Hooks fired · 1

One hook fires while get_edit_term_link() runs, in this order:

1. 1
   apply_filters( get_edit_term_link )filterline 1121 (+39 into the body)

   Filters the edit link for a term.

Uses · 7

• get_term()Gets all term data from database by term ID.
• is_wp_error()Checks whether the given variable is a WordPress Error.
• get_taxonomy()Retrieves the taxonomy object of $taxonomy.
• current_user_can()Returns whether the current user has the specified capability.
• add_query_arg()Retrieves a modified URL query string.
• admin_url()Retrieves the URL to the admin area for the current site.
• apply_filters()Calls the callback functions that have been added to a filter hook.

Used by · 6

• WP_Terms_List_Table::column_name()
• WP_Terms_List_Table::handle_row_actions()Generates and displays row action links.
• edit_term_link()Displays or retrieves the edit term link with formatting.
• get_edit_tag_link()Retrieves the edit link for a tag.
• wp_admin_bar_edit_menu()Provides an edit link for posts and terms.
• wp_tag_cloud()Displays a tag cloud.

Source

View on Trac ↗View on GitHub ↗

1082function get_edit_term_link( $term, $taxonomy = '', $object_type = '' ) {1083	$term = get_term( $term, $taxonomy );1084	if ( ! $term || is_wp_error( $term ) ) {1085		return null;1086	}1087 1088	$tax     = get_taxonomy( $term->taxonomy );1089	$term_id = $term->term_id;1090	if ( ! $tax || ! current_user_can( 'edit_term', $term_id ) ) {1091		return null;1092	}1093 1094	$args = array(1095		'taxonomy' => $tax->name,1096		'tag_ID'   => $term_id,1097	);1098 1099	if ( $object_type ) {1100		$args['post_type'] = $object_type;1101	} elseif ( ! empty( $tax->object_type ) ) {1102		$args['post_type'] = reset( $tax->object_type );1103	}1104 1105	if ( $tax->show_ui ) {1106		$location = add_query_arg( $args, admin_url( 'term.php' ) );1107	} else {1108		$location = '';1109	}1110 1111	/**1112	 * Filters the edit link for a term.1113	 *1114	 * @since 3.1.01115	 *1116	 * @param string $location    The edit link.1117	 * @param int    $term_id     Term ID.1118	 * @param string $taxonomy    Taxonomy name.1119	 * @param string $object_type The object type.1120	 */1121	return apply_filters( 'get_edit_term_link', $location, $term_id, $taxonomy, $object_type );1122}

History

Introduced in 3.1.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 7.1.0 tag, from src/wp-includes/link-template.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.