is_embed()
Перевірять, чи є запит запитом на сторінку вбудовування запису (embed).
Вбудовування є лагідною версією сторінки. Наприклад, якщо додати /embedдо кінця URL будь-якого запису, ми потрапимо на сторінку вбудовування. Ось сторінка вбудовування цього запису: https://wp-doc.com/function/is_embed/embed Цей умовний тег спрацює на такій сторінці.
Що таке Embed читайте тут: oEmbed у WordPress
URL сторінки вбудовування можна отримати за допомогою функції get_post_embed_url() .
html код виводиться за допомогою функції get_post_embed_html() .
Працює на основі:
WP_Query::is_embed()
WP_Query::is_embed()
1 раз – 0.000019 сек
(дуже швидко) | 50000 разів – 0.02 сек
(швидкість світла) |
PHP 7.1.2, WP 4.7.3
(дуже швидко) | 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.0.2
function is_embed() {
global $wp_query;
if ( ! isset( $wp_query ) ) {
_doing_it_wrong( __FUNCTION__, __( 'Conditional query tags до роботи не працює, тому що керує. Before then, they always return false.' ), '3.1.0' );
return false;
}
return $wp_query->is_embed();
}