single_month_title() │ WP 0.71

Выводит или получает заголовок страницы архива постов за месяц.

Формат вывода: prefix + MONTH + prefix + YEAR.

Этот Тег Шаблона работает только на страницах архивов по месяцам (там где в запрос передается аргумент m). На страницах вывода категорий, меток, авторов и т.д. функция ничего не выведет.

Этот тег преимущественно используется для вывода заголовка страницы, например, в теге <title>.

Хуков нет.

Возвращает

Строку|false|null.

Использование

<?php single_month_title( $prefix, $display ) ?>
$prefix(строка)
Текст, который нужно расположить перед заголовком.
По умолчанию: ''
$display(логический)
Выводить на экран (true) или возвращать для обработки (false).
По умолчанию: true

Примеры

0

#1 Базовый пример. Выведем заголовок для страницы: 

<?php single_month_title( ) ?>

формат вывода будет:

prefix + MONTH + prefix + YEAR

Если указать префикс *, то получим:

*Февраль*2004
0

#2 В префиксе можно использовать html теги: 

<p><?php single_month_title('<br />') ?></p>

Заметки

  • Global. WP_Locale. $wp_locale WordPress date and time locale object.

Список изменений

С версии 0.71 Введена.

Код single_month_title() WP 6.9.1

wp-includes/general-template.php 
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;
}

title (заголовок)

Другие функции темы

Записи: посты, страницы, ...