the_terms( int $post_id, string $taxonomy, string $before = '', string $sep = ', ', string $after = '' ): void|false
Displays the terms for a post in a list.
Parameters
-
$post_idint Required -
Post ID.
-
$taxonomystring Required -
Taxonomy name.
-
$beforestring Optional -
String to use before the terms.
Default:
'' -
$sepstring Optional -
String to use between the terms.
Default:
', ' -
$afterstring Optional -
String to use after the terms.
Default:
''
Return
void|false Void on success, false on failure.
Source
File: wp-includes/category-template.php.
View all references
function the_terms( $post_id, $taxonomy, $before = '', $sep = ', ', $after = '' ) {
$term_list = get_the_term_list( $post_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 string $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 );
}
Hooks
-
apply_filters( 'the_terms',
string $term_list ,string $taxonomy ,string $before ,string $sep ,string $after ) -
Filters the list of terms to display.
Changelog
| Version | Description |
|---|---|
| 2.5.0 | Introduced. |
User Contributed Notes
You must log in before being able to contribute a note or feedback.
Get Categories of Current Post
Get a list of current post’s categories:
The output of the above code could be: categories: TV / Speaker / Monitor
I just wanted to add that the above piece of code will output the categories as href links.
E.g. Output of the code:
will be in the form:
categories: TV / Speaker / Monitor