IS_EMBED() │ WP 4.4.0

Функция is_embed() используется для проверки, относится ли текущий запрос к вложенному посту (встраиваемому контенту).

Как работает?

Функция возвращает значение true или false. Если запрос относится к встроенному посту, возвращается true, в противном случае — false.

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

is_embed();

Примеры

Пример 1: Добавление текста в подвал на всех страницах, кроме встроенных

add_action( 'wp_footer', 'add_footer_text' );

function add_footer_text() {
    // Пропустить встраиваемый контент
    if ( is_embed() ) {
        return;
    }

    echo 'Некоторый текст';
}

Примечания

• Глобальная переменная. Использует объект запроса WordPress: $wp_query.

Изменения

• С версии 4.4.0: Введена функция.

Код функции is_embed()

function is_embed() {
    global $wp_query;

    if ( ! isset( $wp_query ) ) {
        _doing_it_wrong( __FUNCTION__, __( 'Условные теги запросов не работают до выполнения запроса. До этого времени они всегда возвращают false.' ), '3.1.0' );
        return false;
    }

    return $wp_query->is_embed();
}

Связанные функции

• OEMBED: Ответ WordPress на запрос встраивания.
  • get_oembed_response_data_for_url()
  • get_post_embed_html()
  • get_post_embed_url()
  • wp_embed_register_handler()
  • WP_Embed::delete_oembed_caches()
  • wp_get_audio_extensions()
  • wp_get_video_extensions()
  • wp_oembed_add_provider()
  • wp_oembed_get()

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

• is_404(): Проверяет, является ли страница 404.
• is_admin(): Проверяет, находитесь ли вы в административной панели.
• is_archive(): Проверяет, является ли страница архивом.
• is_attachment(): Проверяет, является ли страница вложением.
• is_author(): Проверяет, является ли страница автором.
• и многие другие...

Главные функции

• bloginfo(): Получает информацию о блоге.
• get_footer(): Получает нижний колонтитул темы.
• get_header(): Получает верхний колонтитул темы.
• wp_head(): Добавляет необходимые скрипты и стили в шапку.

Эта статья описывает функцию is_embed() и предоставляет примеры ее использования. Теперь вы знаете, как проверить, выполняется ли запрос к встроенному посту, и можете использовать эту функцию в своем коде WordPress.