is_singular()

Функция is_singular() проверяет, является ли текущая страница одиночным объектом записи (single post, page или произвольного типа записи). Она охватывает все типы контента, отображаемые как отдельные элементы: записи (post), страницы (page), вложения (attachment) и любые кастомные типы записей.

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

Параметры

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

is_singular( $post_types );

Возвращает

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

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

1. Эта функция является условным тегом.
2. is_singular() объединяет поведение is_single(), is_page() и is_attachment().
3. Особенно полезна, если вы хотите применять логику ко всем одиночным записям без необходимости проверять каждый тип отдельно.
4. Подходит для кастомных типов записей: например, product, event, portfolio и т.д.
5. Работает только после основного запроса (wp, template_redirect и далее).

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

Пример 1. Проверка, является ли текущая страница одиночной записью любого типа

if ( is_singular() ) {
    echo 'Это одиночный объект публикации.';
}

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

if ( is_singular('post') ) {
    echo 'Это одиночная запись блога.';
}

Пример 3. Проверка массива типов записей

if ( is_singular( array( 'post', 'product', 'event' ) ) ) {
    echo 'Это одиночная страница записи указанного типа.';
}

Хуки

Нет

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