Функция is_month() в WordPress: описание и примеры использования

# IS_MONTH() │ WP 1.5.0

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

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

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

Функцию можно использовать вот так:

```php
if ( is_month() ) {
    // ...
}

Пример:

Вы можете использовать is_month() для отображения текста только на страницах месячного архива:

if ( is_month() ) {
    echo 'Это страница архива за месяц!';
}

Прочие примеры

1. Использование is_archive() и is_month() вместе в условиях if/else:

if ( is_month() ) {
    echo 'Это страница архива за месяц!';
} elseif ( is_archive() ) {
    echo 'Это страница архива.';
}

В этом случае is_archive() должен следовать за is_month(), иначе условие is_month() никогда не сработает.

Примечания

• Глобальная переменная: WP_Query. Объект WordPress Query: $wp_query.

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

Функция возвращает true или false. Это значит, что она сообщает, запрашивается ли архив за существующий месяц.

Изменения

Функция была добавлена в версии 1.5.0.

Код функции

Вот как реализована функция is_month() в файле wp-includes/query.php:

function is_month() {
    global $wp_query;

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

    return $wp_query->is_month();
}

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

Вы можете ознакомиться с другими условными тегами, такими как:

• is_404() — проверяет, является ли страница 404.
• is_admin() — проверяет, находитесь ли вы в админ панели.
• is_archive() — проверяет, является ли страница архивом.
• is_category() — проверяет, является ли страница категорией.
• is_single() — проверяет, является ли страница одиночным постом.

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