On this page
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|object Required-
The ID or term object whose edit link will be retrieved.
$taxonomystring Optional-
Taxonomy. Defaults to the taxonomy of the term identified by
$term.Default:
'' $object_typestring Optional-
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
File: wp-includes/link-template.php. View all references
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.
Related
Uses
| Uses | Description |
|---|---|
| current_user_can() wp-includes/capabilities.php | Returns whether the current user has the specified capability. |
| add_query_arg() wp-includes/functions.php | Retrieves a modified URL query string. |
| get_term() wp-includes/taxonomy.php | Gets all term data from database by term ID. |
| get_taxonomy() wp-includes/taxonomy.php | Retrieves the taxonomy object of $taxonomy. |
| admin_url() wp-includes/link-template.php | Retrieves the URL to the admin area for the current site. |
| apply_filters() wp-includes/plugin.php | Calls the callback functions that have been added to a filter hook. |
| is_wp_error() wp-includes/load.php | Checks whether the given variable is a WordPress Error. |
Used By
| Used By | Description |
|---|---|
| WP_Terms_List_Table::handle_row_actions() wp-admin/includes/class-wp-terms-list-table.php | Generates and displays row action links. |
| WP_Terms_List_Table::column_name() wp-admin/includes/class-wp-terms-list-table.php | |
| wp_tag_cloud() wp-includes/category-template.php | Displays a tag cloud. |
| get_edit_tag_link() wp-includes/link-template.php | Retrieves the edit link for a tag. |
| edit_term_link() wp-includes/link-template.php | Displays or retrieves the edit term link with formatting. |
| wp_admin_bar_edit_menu() wp-includes/admin-bar.php | Provides an edit link for posts and terms. |
Changelog
© 2003–2022 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/get_edit_term_link