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

返回介绍

the_terms()

发布于 2017-09-11 字数3171 浏览 1049 评论 0

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

Display the terms in a list.


描述


参数

$id

(int)
(Required)
Post ID.

$taxonomy

(string)
(Required)
Taxonomy name.

$before

(string)
(Optional)
Before list.

Default value: ”

$sep

(string)
(Optional)
Separate items using this.

Default value: ‘, ‘

$after

(string)
(Optional)
After list.

Default value: ”


返回值

(false|void) False on WordPress error.


源代码

File: wp-includes/category-template.php

function the_terms( $id, $taxonomy, $before = '', $sep = ', ', $after = '' ) {
	$term_list = get_the_term_list( $id, $taxonomy, $before, $sep, $after );

	if ( is_wp_error( $term_list ) )
		return false;

	/**
	 * Filters the list of terms to display.
	 *
	 * @since 2.9.0
	 *
	 * @param array  $term_list List of terms to display.
	 * @param string $taxonomy  The taxonomy name.
	 * @param string $before    String to use before the terms.
	 * @param string $sep       String to use between the terms.
	 * @param string $after     String to use after the terms.
	 */
	echo apply_filters( 'the_terms', $term_list, $taxonomy, $before, $sep, $after );
}

更新日志

Version 描述
2.5.0 Introduced.

相关函数

Uses

  • wp-includes/category-template.php:
    get_the_term_list()
  • wp-includes/category-template.php:
    the_terms
  • wp-includes/plugin.php:
    apply_filters()
  • wp-includes/load.php:
    is_wp_error()

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 Categories of Current Post
    Get a list of current post’s categories:

    
    <?php the_terms( $post->ID, 'category', 'categories: ', ' / ' ); ?>
    

    The output of the above code could be: categories: TV / Speaker / Monitor

  2. I just wanted to add that the above piece of code will output the categories as href links.

    E.g. Output of the code:

    <?php the_terms( $post->ID, 'category', 'categories: ', ' / ' ); ?>

    will be in the form:
    categories: TV / Speaker / Monitor

上一篇:the_taxonomies()

下一篇:the_time()

发布评论

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

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