is_embed()
Проверят является ли запрос запросом на страницу встраивания записи (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() ){
// запрос для страницы встраивания записи
}
Примеры
#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() is embed WP 6.4.1
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();
}