get_edit_term_link() - WordPress 函数参考中文文档

返回介绍

get_edit_term_link()

发布于 2017-09-10 字数4124 浏览 879 评论 0

get_edit_term_link( int $term_id,  string $taxonomy = '',  string $object_type = '' )

Retrieves the URL for editing a given term.


描述


参数

$term_id

(int)
(Required)
Term ID.

$taxonomy

(string)
(Optional)
Taxonomy. Defaults to the taxonomy of the term identified by $term_id.

Default value: ”

$object_type

(string)
(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 value: ”


返回值

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


源代码

File: wp-includes/link-template.php

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

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

	$args = array(
		'taxonomy' => $taxonomy,
		'tag_ID'   => $term->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 (eg. the post type).
	 */
	return apply_filters( 'get_edit_term_link', $location, $term_id, $taxonomy, $object_type );
}

更新日志

Version 描述
4.5.0 The $taxonomy argument was made optional.
3.1.0 Introduced.

相关函数

Uses

  • wp-includes/capabilities.php:
    current_user_can()
  • wp-includes/functions.php:
    add_query_arg()
  • wp-includes/taxonomy.php:
    get_term()
  • wp-includes/taxonomy.php:
    get_taxonomy()
  • wp-includes/link-template.php:
    admin_url()
  • wp-includes/link-template.php:
    get_edit_term_link
  • wp-includes/plugin.php:
    apply_filters()
  • wp-includes/load.php:
    is_wp_error()
  • Show 3 more uses
    Hide more uses


Used By

  • wp-admin/includes/class-wp-terms-list-table.php:
    WP_Terms_List_Table::handle_row_actions()
  • wp-admin/includes/class-wp-terms-list-table.php:
    WP_Terms_List_Table::column_name()
  • wp-includes/category-template.php:
    wp_tag_cloud()
  • wp-includes/link-template.php:
    get_edit_tag_link()
  • wp-includes/link-template.php:
    edit_term_link()
  • wp-includes/admin-bar.php:
    wp_admin_bar_edit_menu()
  • Show 1 more used by
    Hide more used by


User Contributed Notes

  1. Skip to note content

    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

    Contributed by Codex

    Get term’s link to edit

    $edit_link = esc_url( get_edit_term_link( $tag->term_id, $taxonomy, $this->screen->post_type ) );

上一篇:get_edit_tag_link()

下一篇:get_edit_user_link()

发布评论

需要 登录 才能够评论, 你可以免费 注册 一个本站的账号。

目前还没有任何评论,快来抢沙发吧!