IS_YEAR() Function in WordPress: Usage and Examples

## IS_YEAR() │ WP 1.5.0

Функция **IS_YEAR()** определяет, отображается ли страница архива за определённый год (например, example.com/2009) — это страница с записями за конкретный год. Это условная метка.

Эта функция является частью функций **is_date()** и **is_archive()**, поэтому, если вы используете их вместе, сначала нужно вызывать **is_year()**. В противном случае условие **is_year()** никогда не выполнится.

Использование: **WP_Query::is_year()**
- Время выполнения: 1 раз — 0.00007 сек (очень быстро) | 50000 раз — 0.01 сек (скорость света)

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

Функция возвращает true или false. Она определяет, относится ли запрос к существующему архиву года.

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

```php
if( is_year() ){
    // код, который выполняется, если это архив года
}

Примеры

Пример 1: Отображение текста только на страницах архива за год

if( is_year() ){
    echo 'Это страница архива за год: например, такая ссылка example.com/2009';
}

Пример 2: Использование is_archive() и is_year() вместе в условных операторах

if( is_year() )
    echo 'Это страница архива за год.';
elseif( is_archive() )
    echo 'Это страница архива: день, месяц, категория, тег и т.д.';
else
    echo 'Это не страница архива за год.';

Таким образом, is_archive() следует использовать после is_year(), иначе условие is_year() никогда не выполнится.

Примечания

• Глобальный объект. $wp_query — объект WordPress Query.

Изменения

• С версии 1.5.0 — введена в систему.

Код функции is_year()

Файл: wp-includes/query.php

function is_year() {
    global $wp_query;

    if ( ! isset( $wp_query ) ) {
        _doing_it_wrong( __FUNCTION__, __( 'Условные метки не работают до выполнения запроса. До этого момента они всегда возвращают false.' ), '3.1.0' );
        return false;
    }

    return $wp_query->is_year();
}

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

Условные метки (тип страницы и запрос)

• is_404() — проверка на 404 ошибку
• is_admin() — проверка на административную панель
• is_archive() — проверка на страницу архива
• is_attachment() — проверка на страницу вложения
• is_author() — проверка на страницу автора
• is_category() — проверка на страницу категории
• is_day() — проверка на страницу с записями за день
• is_month() — проверка на страницу архива по месяцу
• is_tag() — проверка на страницу тега
• И многие другие...

Полезные функции

• get_posts() — получение записей
• the_post() — установка текущей записи
• wp_count_posts() — подсчет записей
• wp_reset_query() — сброс запроса WordPress

Эта информация поможет вам лучше понять, как использовать условные метки в WordPress и эффективно управлять контентом на вашем сайте.