single_term_title()

Display or retrieve page title for taxonomy term archive.

Useful for taxonomy term template files for displaying the taxonomy term page title. It has less overhead than {@link wp_title()}, because of its limited implementation.

It does not support placing the separator after the title, but by leaving the prefix parameter empty, you can set the title separator manually. The prefix does not automatically place a space between the prefix, so if there should be a space, the parameter value will need to have it at the end.

Signature

single_term_title( $prefix = '', $display = true )

prefix

 (string) Optional. What to display before the title.
Default: ''

display

 (boolean) Optional, default is true. Whether to display or retrieve title.
Default: true

Return

(string|null) Title when retrieving, null when displaying or failure.

Source

function single_term_title( $prefix = '', $display = true ) {
	$term = get_queried_object();

	if ( !$term )
		return;

	if ( is_category() )
		$term_name = apply_filters( 'single_cat_title', $term->name );
	elseif ( is_tag() )
		$term_name = apply_filters( 'single_tag_title', $term->name );
	elseif ( is_tax() )
		$term_name = apply_filters( 'single_term_title', $term->name );
	else
		return;

	if ( empty( $term_name ) )
		return;

	if ( $display )
		echo $prefix . $term_name;
	else
		return $term_name;
}

WP Trac GitHub Bitbucket