## Функция is_archive() в WordPress
### Общее описание
Функция is_archive()
— это специальный условный тег в WordPress, который возвращает **true** (истина), если на сайте отображается любая страница архива. Это может быть архив по году, категории, автору или типу записи.
Архивные страницы включают в себя:
- Страницы категорий
- Страницы тегов
- Страницы авторов
- Архивы постов по типам записей
- Архивы по дате
Кроме того, is_archive()
также включает проверки для других функций, таких как:
- is_category()
- is_tag()
- is_author()
- is_day()
- is_month()
- is_year()
- И другие.
### Возвращаемое значение
Функция возвращает:
- **true** — если это архивная страница
- **false** — если это не архивная страница
### Применение
Чтобы использовать функцию is_archive()
, можно написать код следующим образом:
```php
Примеры использования
Пример 1: Вывод текста "Страница категории"
if ( is_category() ) {
echo "Страница категории";
} elseif ( is_archive() ) {
echo "Архивная страница";
}
В этом примере, если это страница категории, выводится "Страница категории". Если это другая архивная страница, отображается "Архивная страница".
Замечания
- Если вы используете функции для проверки условий (
is_category()
,is_tag()
и другие), то они могут помочь более точно определить, какая именно страница сейчас открыта. - Глобальная переменная
$wp_query
содержит объекты запроса WordPress.
Изменения
- Функция
is_archive()
была введена в версии 1.5.0 WordPress.
Код функции
Вот как выглядит код функции is_archive()
в WordPress:
function is_archive() {
global $wp_query;
if ( ! isset( $wp_query ) ) {
_doing_it_wrong( __FUNCTION__, __( 'Условные теги не работают до запуска запроса. До этого они всегда возвращают false.' ), '3.1.0' );
return false;
}
return $wp_query->is_archive();
}
Связанные функции
is_category()
is_tag()
is_author()
is_date()
is_post_type_archive()
is_tax()
Условные теги
Помимо is_archive()
, в WordPress существуют и другие условные теги, которые помогают определять типы страниц:
is_404()
is_admin()
is_attachment()
is_home()
- и многие другие.
Эти функции полезны для разработки темы или плагинов, так как позволяют подстраивать вывод контента в зависимости от типа страницы, которую сейчас просматривает пользователь.