W3cubDocs

/WordPress

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

Displays the terms for a post in a list.

Parameters

$post_id

(int) (Required) Post ID.

$taxonomy

(string) (Required) Taxonomy name.

$before

(string) (Optional) String to use before the terms.

Default value: ''

$sep

(string) (Optional) String to use between the terms.

Default value: ', '

$after

(string) (Optional) String to use after the terms.

Default value: ''

Return

(void|false) Void on success, false on failure.

Source

File: wp-includes/category-template.php 

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 );
}

Uses

Uses Description
wp-includes/category-template.php: get_the_term_list()

Retrieves a post’s terms as a list with specified format.
wp-includes/category-template.php: the_terms

Filters the list of terms to display.
wp-includes/plugin.php: apply_filters()

Calls the callback functions that have been added to a filter hook.
wp-includes/load.php: is_wp_error()

Check whether variable is a WordPress Error.

Changelog

Version Description
2.5.0 Introduced.

© 2003–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/the_terms