1. 首页
  2. WordPress 函数手册

get_the_term_list()

get_the_term_list( int $id, string $taxonomy, string $before = , string $sep = , string $after =  )

以指定格式的列表形式检索文章的术语。
Retrieve a post’s terms as a list with specified format.

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


参数(Parameters)

参数 类型 必填 说明
$id (int) 必需 邮政编码。
$taxonomy (string) 必需 分类法名称。
$before (string) 可选 在列表之前。
$sep (string) 可选 用这个把物品分开。
$after (string) 可选 在列表之后。

返回(Return)

(string|false|WP_Error)一个成功术语列表,如果没有术语,则为false,如果失败则为WP|u Error。


源码(Source)

/**
 * Retrieve a post's terms as a list with specified format.
 *
 * @since 2.5.0
 *
 * @param int $id Post ID.
 * @param string $taxonomy Taxonomy name.
 * @param string $before Optional. Before list.
 * @param string $sep Optional. Separate items using this.
 * @param string $after Optional. After list.
 * @return string|false|WP_Error A list of terms on success, false if there are no terms, WP_Error on failure.
 */
function get_the_term_list( $id, $taxonomy, $before = '', $sep = '', $after = '' ) {
	$terms = get_the_terms( $id, $taxonomy );

	if ( is_wp_error( $terms ) )
		return $terms;

	if ( empty( $terms ) )
		return false;

	$links = array();

	foreach ( $terms as $term ) {
		$link = get_term_link( $term, $taxonomy );
		if ( is_wp_error( $link ) ) {
			return $link;
		}
		$links[] = '' . $term->name . '';
	}

	/**
	 * Filter the term links for a given taxonomy.
	 *
	 * The dynamic portion of the filter name, `$taxonomy`, refers
	 * to the taxonomy slug.
	 *
	 * @since 2.5.0
	 *
	 * @param array $links An array of term links.
	 */
	$term_links = apply_filters( "term_links-$taxonomy", $links );

	return $before . join( $sep, $term_links ) . $after;
}
更新版本 源码位置 使用 被使用
2.5.0 wp-includes/category-template.php:1281 2 6

笔记(Notes)

基本示例
返回HTML列表
您可以将此功能与strip_tags功能一起使用,以打印未链接的术语列表:

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

发表评论

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