is_page()

Функция is_page() проверяет, отображается ли в данный момент определённая страница (page). Она возвращает true, если текущая запрашиваемая страница является статической страницей (а не записью, архивом и т.д.).

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

Параметры

  • $page int|string|array
    Идентификатор (ID), слаг (slug), название страницы или массив таких значений. Если параметр не передан, функция просто проверяет, является ли текущая страница любой статической страницей.
    По умолчанию: ''
is_page( $page );

Возвращает

bool Возвращает true, если текущая страница соответствует переданным условиям (ID, слагу, названию), или если это любая страница (если параметр не передан). В противном случае — false.

Дополнительная информация

  1. Эта функция является условным тегом.
  2. is_page() работает только в основном цикле (The Loop) или после запуска wp (например, на хуке template_redirect).
  3. Если вы хотите использовать is_page() в functions.php, убедитесь, что он вызывается после инициализации запроса (init, wp, template_redirect, и т.д.).
  4. Не работает для записей (post), архивов и других типов страниц — только для статических страниц.

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

Пример 1. Проверка, является ли текущая страница страницей со слагом "about"

if ( is_page( 'about' ) ) {
    echo 'Это страница "О нас".';
}

Пример 2. Проверка по ID страницы

if ( is_page(42) ) {
    echo 'Это страница с ID 42.';
}

Пример 3. Проверка, является ли текущая страница одной из нескольких

if ( is_page( array( 'about', 'contact', 42 ) ) ) {
    echo 'Это одна из выбранных страниц.';
}

Хуки

Нет

Информация о функции

Добавлена в версии 1.5.0

wp-includes/query.php

Исходный код в Github

 

Другие функции

is_singular()

Проверяет, является ли текущая страница одиночным объектом записи (single post, page или произвольного типа записи).

is_single()

Проверяет, является ли текущая отображаемая страница одиночной записью (single post).

is_404()

Определяет, является ли текущая страница страницей ошибки 404.

the_title_attribute()

Выводит заголовок записи в html атрибутах.

wp_get_document_title()

Возвращает заголовок текущей страницы.

wp_title()

Выводит или возвращает заголовок страницы для использования в теге title.

single_post_title()

Выводит или возвращает заголовок текущего поста (записи, страницы, кастомного типа).

get_the_title()

Возвращает заголовок записи/страницы.

the_title()

Используется для вывода на экран или получения заголовка текущей записи/страницы.