get_term_field() │ WP 2.3.0

Get sanitized Term field.

The function is for contextual reasons and for simplicity of usage.

Uses: sanitize_term_field()
Used By: term_description()

No Hooks.

Return

String|Int|null|WP_Error. Will return an empty string if $term is not an object or if $field is not set in $term.

Usage

get_term_field( $field, $term, $taxonomy, $context );
$field(string) (required)
Term field to fetch.
$term(int|WP_Term) (required)
Term ID or object.
$taxonomy(string)
Taxonomy name.
Default: ''
$context(string)
How to sanitize term fields. Look at sanitize_term_field() for available options.
Default: 'display'

Examples

0

#1 Display the description of category 34

The description is set in the admin when you create/modify a category. If there is no description, it will display the message "No description of the term was found".

$description = get_term_field( 'description', 34, 'category' );

if( is_wp_error( $description ) ){
	 echo 'No description of the term was found';
}
else {
	 echo $description;
}

Notes

Changelog

Since 2.3.0 Introduced.
Since 4.4.0 The $taxonomy parameter was made optional. $term can also now accept a WP_Term object.

get_term_field() code WP 6.1.1

wp-includes/taxonomy.php 
function get_term_field( $field, $term, $taxonomy = '', $context = 'display' ) {
	$term = get_term( $term, $taxonomy );
	if ( is_wp_error( $term ) ) {
		return $term;
	}

	if ( ! is_object( $term ) ) {
		return '';
	}

	if ( ! isset( $term->$field ) ) {
		return '';
	}

	return sanitize_term_field( $field, $term->$field, $term->term_id, $term->taxonomy, $context );
}

Term (taxonomies terms)

Taxonomies: categories, tags, ...