WordPress函数：single_term_title 分类法项目列表页标题

函数原型：

single_term_title( string $prefix = '', bool $display = true ): string|void

single_term_title 函数，对于显示分类术语页面标题的分类术语模板文件很有用。

$prefix-前缀不会自动在前缀之间放置空格，因此如果应该有空格，则参数值需要在末尾有空格。

这函数还有两个语法糖包装：single_cat_title 和 single_tag_title。

参数说明：

$prefix，标题前缀，在文章标题前显示。

$display，是否直接显示，还是返回一个字符串。

函数源码：

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 $prefix . $term_name;
	}
}

包含钩子：

apply_filters( 'single_cat_title', string $term_name )

apply_filters( 'single_tag_title', string $term_name )

apply_filters( 'single_term_title', string $term_name )

使用举例：

// 输出 Currently browsing + 当前分类标题
single_term_title( 'Currently browsing ' );

// 返回一个字符串
$current_term = single_term_title( "", false );