single_month_title() — описание функции WordPress на русском

Сигнатура

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

Описание

Полезно, когда шаблону нужно отобразить только месяц и год, если они доступны. Prefix не добавляет пробел автоматически, поэтому, если пробел нужен, его следует указать в конце значения параметра.

Оригинал (английский)

Useful for when the template only needs to display the month and year, if either are available. 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.

Параметры

$prefix string необязательный = ''

Что отображать перед заголовком.

$display bool необязательный = true

Отображать или получать заголовок.

Возвращаемое значение

string|false|null

Исходный код

wp-includes/general-template.php:1670

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;
}

История изменений

Версия	Описание
0.71	Introduced.