wp_get_post_terms()

wp_get_post_terms( int $post_id, string|array $taxonomy…

wp_get_post_terms( int $post_id, string|array $taxonomy = ‘post_tag’, array $args = array() )

检索文章的术语。
Retrieves the terms for a post.

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


参数(Parameters)

参数 类型 说明
$post_id (int) Post ID.不默认为全局$Post的ID。默认值为0。
$taxonomy (string | array) 要检索slug或slug数组的术语。
$args (array) 术语查询参数。有关支持的参数,请参见WP_Term_Query::uu construct()字段(字符串)要检索的术语字段。默认“全部”。

源码(Source)

/**
 * Retrieve the terms for a post.
 *
 * There is only one default for this function, called 'fields' and by default
 * is set to 'all'. There are other defaults that can be overridden in
 * {@link wp_get_object_terms()}.
 *
 * @since 2.8.0
 *
 * @param int    $post_id  Optional. The Post ID. Does not default to the ID of the
 *                         global $post. Default 0.
 * @param string $taxonomy Optional. The taxonomy for which to retrieve terms. Default 'post_tag'.
 * @param array  $args     Optional. {@link wp_get_object_terms()} arguments. Default empty array.
 * @return array|WP_Error  List of post terms or empty array if no terms were found. WP_Error object
 *                         if `$taxonomy` doesn't exist.
 */
function wp_get_post_terms( $post_id = 0, $taxonomy = 'post_tag', $args = array() ) {
	$post_id = (int) $post_id;

	$defaults = array('fields' => 'all');
	$args = wp_parse_args( $args, $defaults );

	$tags = wp_get_object_terms($post_id, $taxonomy, $args);

	return $tags;
}
更新版本 源码位置 使用 被使用
2.8.0 wp-includes/post.php 15 12

笔记(Notes)

此函数与get_The峈terms()的区别在于,此函数的结果不会被缓存(因此,每次调用它时,它都会命中数据库)。

类别:WordPress 函数手册

本文收集自互联网,转载请注明来源。
如有侵权,请联系 wper_net@163.com 删除。

评论 (0)COMMENT

登录 账号发表你的看法,还没有账号?立即免费 注册