1. 首页
  2. WordPress 函数手册

get_the_terms()

get_the_terms( int|WP_Post $post, string $taxonomy )

检索附加到文章的分类术语。
Retrieve the terms of the taxonomy that are attached to the post.

目录锚点:#参数#返回#源码#笔记


参数(Parameters)

参数 类型 必填 说明
$post (int | WP_Post) 必需 Post ID或对象。
$taxonomy (string) 必需 分类法名称。

返回(Return)

(WP}u Term[]|false|WP}u Error)WP}u Term对象的数组,成功时为false,如果没有术语或post不存在,则为false,失败时为WP}u Error。


源码(Source)

/**
 * Retrieve the terms of the taxonomy that are attached to the post.
 *
 * @since 2.5.0
 *
 * @param int|object $post Post ID or object.
 * @param string $taxonomy Taxonomy name.
 * @return array|false|WP_Error Array of term objects on success, false if there are no terms
 *                              or the post does not exist, WP_Error on failure.
 */
function get_the_terms( $post, $taxonomy ) {
	if ( ! $post = get_post( $post ) )
		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, $terms, $taxonomy . '_relationships');
	}

	/**
	 * Filter the list of terms attached to the given post.
	 *
	 * @since 3.1.0
	 *
	 * @param array|WP_Error $terms    List of attached terms, or WP_Error on failure.
	 * @param int            $post_id  Post ID.
	 * @param string         $taxonomy Name of the taxonomy.
	 */
	$terms = apply_filters( 'get_the_terms', $terms, $post->ID, $taxonomy );

	if ( empty( $terms ) )
		return false;

	return $terms;
}
更新版本 源码位置 使用 被使用
2.5.0 wp-includes/category-template.php:1236 10 8

笔记(Notes)

WP_Term对象属性:(因为我一直在寻找它们)
获取所有自定义分类的术语
获得逗号分隔的术语列表的优化方法。

get_the_terms() 为WP2原创文章,链接:https://www.wp2.cn/functions/get_the_terms/

发表评论

您的电子邮箱地址不会被公开。