WordPress Version: 3.9
/**
* 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.
*
* @since 3.1.0
*
* @param string $prefix Optional. What to display before the title.
* @param bool $display Optional, default is true. Whether to display or retrieve title.
* @return string|null Title when retrieving, null when displaying or failure.
*/
function single_term_title($prefix = '', $display = true)
{
$term = get_queried_object();
if (!$term) {
return;
}
if (is_category()) {
/**
* Filter the category archive page title.
*
* @since 2.0.10
*
* @param string $term_name Category name for archive being displayed.
*/
$term_name = apply_filters('single_cat_title', $term->name);
} elseif (is_tag()) {
/**
* Filter the tag archive page title.
*
* @since 2.3.0
*
* @param string $term_name Tag name for archive being displayed.
*/
$term_name = apply_filters('single_tag_title', $term->name);
} elseif (is_tax()) {
/**
* Filter the custom taxonomy archive page title.
*
* @since 3.1.0
*
* @param string $term_name Term name for archive being displayed.
*/
$term_name = apply_filters('single_term_title', $term->name);
} else {
return;
}
if (empty($term_name)) {
return;
}
if ($display) {
echo $prefix . $term_name;
} else {
return $prefix . $term_name;
}
}