is_embed()WP 4.4.0

Проверят является ли запрос запросом на страницу встраивания записи (embed).

Встраивания представляют из себя кроткую версию страницы. Например если добавить /embed в конец URL любой записи, то мы попадем на страницу встраивания. Вот страница встраивания этой записи: https://wp-kama.ru/function/is_embed/embed Этот условные тег сработает на такой странице.

Что такое Embed читайте здесь: oEmbed в WordPress

URL страницы встраивания можно получить с помощью функции get_post_embed_url().

html код выводится с помощью функции get_post_embed_html().

Работает на основе: WP_Query::is_embed()
1 раз — 0.000019 сек (очень быстро) | 50000 раз — 0.02 сек (скорость света) | PHP 7.1.2, WP 4.7.3

Хуков нет.

Возвращает

true|false.

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

if( is_embed() ){
	// запрос для страницы встраивания записи
}

Примеры

0

#1 Добавим текст в подвал на всех страницах кроме встраиваний

add_action( 'wp_footer', 'add_footer_text' );

function add_footer_text() {

	// пропускаем встраивания
	if ( is_embed() ) {
		return;
	}

	echo 'some text';
}

Заметки

  • Global. WP_Query. $wp_query WordPress Query object.

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

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

Код is_embed() WP 6.4.3

function is_embed() {
	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_embed();
}