is_single()

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

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

Параметры

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

is_single( $post );

Возвращает

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

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

1. Эта функция является условным тегом.
2. is_single() работает только после инициализации запроса (wp, template_redirect и далее).
3. Не работает для страниц (page), архивов, категорий, тегов и т.п. Используйте функции is_page(), is_category().
4. Проверяет только одиночные записи (post) и кастомные типы записей.
5. Функция не проверяет тип поста напрямую — если нужно различать по типу, используйте get_post_type() совместно с is_single().

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

Пример 1. Проверка, отображается ли одиночная запись с ID 15

if ( is_single( 15 ) ) {
    echo 'Это одиночная запись с ID 15.';
}

Пример 2. Проверка по слагу записи

if ( is_single( 'hello-world' ) ) {
    echo 'Это запись с слагом hello-world';
}

Пример 3. Проверка на любую одиночную запись

if ( is_single() ) {
    echo 'Это страница одиночной записи.';
}

Пример 4. Проверка массива записей (по ID и слагу)

if ( is_single( array( 'news-post', 101 ) ) ) {
    echo 'Это одна из выбранных записей.';
}

Хуки

Нет

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