WordPress函数:single_month_title 日期归档页标题

江河/ 2023年04月27日/ WordPress/ 浏览 626

函数原型:


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


参数说明:


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


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


函数源码:


function single_month_title( $prefix = '', $display = true ) {
	global $wp_locale;

	$m        = get_query_var( 'm' );
	$year     = get_query_var( 'year' );
	$monthnum = get_query_var( 'monthnum' );

	if ( ! empty( $monthnum ) && ! empty( $year ) ) {
		$my_year  = $year;
		$my_month = $wp_locale->get_month( $monthnum );
	} elseif ( ! empty( $m ) ) {
		$my_year  = substr( $m, 0, 4 );
		$my_month = $wp_locale->get_month( substr( $m, 4, 2 ) );
	}

	if ( empty( $my_month ) ) {
		return false;
	}

	$result = $prefix . $my_month . $prefix . $my_year;

	if ( ! $display ) {
		return $result;
	}
	echo $result;
}


1. 只有当WordPress将m或archive month参数传递到当前页面时(查看每月存档页面时会出现这种情况),此函数才有效。


2. 此函数仅适用于日期存档页面,不适用于类别模板或其他页面。


3. 不支持在标题后放置分隔符,但通过将前缀参数留空,可以手动设置标题分隔符


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


5. 会分别在 $month 和 $year 签名添加 $prefix。


使用举例:


single_month_title('<br />') ;


发表评论

暂无评论,抢个沙发...

客服 工单