WordPress.org

Ready to get started?Download WordPress

Codex

Function Reference/get the term list

Contents

Description

Returns an HTML string of taxonomy terms associated with a post and given taxonomy. Terms are linked to their respective term listing pages.

Usage

 <?php get_the_term_list$id$taxonomy$before$sep$after ?> 

Parameters

$id
(int) (required) Post ID
Default: 0
$taxonomy
(string) (required) Name of taxonomy
Default: None
$before
(string) (optional) Leading text
Default: None
$sep
(string) (optional) String to separate tags
Default: None
$after
(string) (optional) Trailing text
Default: None

Returns

(string) 
HTML string of taxonomy terms.

A Basic Example

Used inside the loop this outputs the terms from the people taxonomy for a specific post.

 <?php echo get_the_term_list( $post->ID, 'people', 'People: ', ', ', '' ); ?> 

This would return something like.

People: 
<a href="person1">Person 1</a>, 
<a href="person2">Person 2</a>, ...


Returning an HTML List

Used inside the loop this outputs the terms from the styles taxonomy for a specific post as an (x)html list.

echo '<ul class="styles">';
echo get_the_term_list( $post->ID, 'styles', '<li>', ',</li><li>', '</li>' );
echo '</ul>';

This would return something like.

<ul class="styles">
    <li><a href="person1">Style 1,</a></li> 
    <li><a href="person2">Style 2,</a></li>
</ul>

Change Log

Source File

get_the_term_list() is located in wp-includes/category-template.php.

Related

get_the_tag_list()

See also index of Function Reference and index of Template Tags.