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

返回介绍

get_terms_to_edit()

发布于 2017-09-11 字数2826 浏览 818 评论 0

get_terms_to_edit( int $post_id,  string $taxonomy = 'post_tag' )

Get comma-separated list of terms available to edit for the given post ID.


描述


参数

$post_id

(int)
(Required)

$taxonomy

(string)
(Optional)
The taxonomy for which to retrieve terms.

Default value: ‘post_tag’


返回值

(string|bool|WP_Error)


源代码

File: wp-admin/includes/taxonomy.php

function get_terms_to_edit( $post_id, $taxonomy = 'post_tag' ) {
	$post_id = (int) $post_id;
	if ( !$post_id )
		return false;

	$terms = get_object_term_cache( $post_id, $taxonomy );
	if ( false === $terms ) {
		$terms = wp_get_object_terms( $post_id, $taxonomy );
		wp_cache_add( $post_id, wp_list_pluck( $terms, 'term_id' ), $taxonomy . '_relationships' );
	}

	if ( ! $terms ) {
		return false;
	}
	if ( is_wp_error( $terms ) ) {
		return $terms;
	}
	$term_names = array();
	foreach ( $terms as $term ) {
		$term_names[] = $term->name;
	}

	$terms_to_edit = esc_attr( join( ',', $term_names ) );

	/**
	 * Filters the comma-separated list of terms available to edit.
	 *
	 * @since 2.8.0
	 *
	 * @see get_terms_to_edit()
	 *
	 * @param array  $terms_to_edit An array of terms.
	 * @param string $taxonomy     The taxonomy for which to retrieve terms. Default 'post_tag'.
	 */
	$terms_to_edit = apply_filters( 'terms_to_edit', $terms_to_edit, $taxonomy );

	return $terms_to_edit;
}

更新日志

Version 描述
2.8.0 Introduced.

相关函数

Uses

  • wp-admin/includes/taxonomy.php:
    terms_to_edit
  • wp-includes/cache.php:
    wp_cache_add()
  • wp-includes/formatting.php:
    esc_attr()
  • wp-includes/functions.php:
    wp_list_pluck()
  • wp-includes/taxonomy.php:
    get_object_term_cache()
  • wp-includes/taxonomy.php:
    wp_get_object_terms()
  • 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-press-this.php:
    WP_Press_This::tags_html()
  • wp-admin/includes/taxonomy.php:
    get_tags_to_edit()
  • wp-admin/includes/template.php:
    get_inline_data()
  • wp-admin/includes/meta-boxes.php:
    post_tags_meta_box()

User Contributed Notes

上一篇:get_terms()

下一篇:get_term_by()

发布评论

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

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