SINGLE_MONTH_TITLE() │ WP 0.71

Функция SINGLE_MONTH_TITLE() используется для отображения заголовка архивной страницы постов на основе даты. Это полезно, когда в шаблоне нужно показать только месяц и год, если они доступны.

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

Возврат

Функция может вернуть строку, false или null. Вернётся false, если для месяца нет действительного заголовка. При получении заголовка вернётся сам заголовок.

Синтаксис

single_month_title( $prefix, $display );

• $prefix (string) — что отображать перед заголовком. По умолчанию: ''.
• $display (bool) — нужно ли отображать заголовок или вернуть его. По умолчанию: true.

Примеры использования

Пример 1: Основной пример

Давайте выведем заголовок для страницы:

Формат вывода будет следующим:

передфикс + МЕЕСЯЦ + передфикс + ГОД

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

*Февраль*2004

Пример 2: Использование HTML-тегов в префиксе

'); ?>

Результат будет: 2 строки:

Декабрь
2004

Заметки

• Эта функция использует глобальный объект $wp_locale, который со��ержит информацию о локализации даты и времени в WordPress.

Изменения

С версии 0.71 функция была введена в WordPress.

Код функции

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

Связанные функции

• get_admin_page_title() – получает заголовок страницы администратора.
• get_the_archive_title() – получает заголовок архивной страницы.
• get_the_title() – получает заголовок поста.
• single_post_title() – получает заголовок единственного поста.
• the_archive_title() – выводит заголовок архивной страницы.
• the_title() – выводит заголовок поста.
• wp_get_document_title() – получает заголовок документа для SEO.

Эта функция и ее аналоги помогут вам правильно управлять заголовками в вашем блоге и делать вашу работу с WordPress более эффективной!