is_attachment() │ WP 2.0.0

Проверяет является ли текущая страница страницей вложения. Условный Тег.

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

Эта функция относится к условным тегам и возвращает true, если запрос соответствует загруженному вложению.

Важно помнить, что её можно вызывать после запуска основного запроса WordPress. Если вызвать до этого, она всегда вернёт false и выведет уведомление через _doing_it_wrong(), так как условные теги ещё не работают.

Условный Тег is_singular() так же выведет true для страниц вложений.

Хуков нет.

Возвращает

true|false.

  • true — если страница является страницей существующего вложения.
  • false — в противном случае.

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

if( is_attachment( $attachment ) ){
	// страница вложения
}
$attachment(int|string|int[]|string[])

Идентификатор, заголовок, ярлык (slug) вложения или массив таких значений.

По умолчанию: ''

Примеры

1

#1 Проверка является ли текущая страница, страницей вложения: 

<?php
if ( is_attachment() ) {
	// код для страниц вложений
}
else {
	// код для остальных страниц
}
?>

Заметки

  • Global. WP_Query. $wp_query WordPress Query object.

Список изменений

С версии 2.0.0 Введена.

Код is_attachment() WP 7.0

wp-includes/query.php 
function is_attachment( $attachment = '' ) {
	global $wp_query;

	if ( ! isset( $wp_query ) ) {
		_doing_it_wrong( __FUNCTION__, __( 'Conditional query tags do not work before the query is run. Before then, they always return false.' ), '3.1.0' );
		return false;
	}

	return $wp_query->is_attachment( $attachment );
}

Условные теги (типов страниц и запросов)

Условные теги (все)

Запросы

Основные