wp_filter_pre_oembed_result

Advertisement

Summery Summery

Filters the oEmbed result before any HTTP requests are made.

Syntax Syntax

wp_filter_pre_oembed_result( null|string $result, string $url, array $args )

Description Description

If the URL belongs to the current site, the result is fetched directly instead of going through the oEmbed discovery process.

Parameters Parameters

$result

(null|string) (Required) The UNSANITIZED (and potentially unsafe) HTML that should be used to embed. Default null.

$url

(string) (Required) The URL that should be inspected for discovery <link> tags.

$args

(array) (Required) oEmbed remote get arguments.

Return Return

(null|string) The UNSANITIZED (and potentially unsafe) HTML that should be used to embed. Null if the URL does not belong to the current site.

Source Source

File: wp-includes/embed.php

 * going through the oEmbed discovery process.
 *
 * @since 4.5.3
 *
 * @param null|string $result The UNSANITIZED (and potentially unsafe) HTML that should be used to embed. Default null.
 * @param string      $url    The URL that should be inspected for discovery `<link>` tags.
 * @param array       $args   oEmbed remote get arguments.
 * @return null|string The UNSANITIZED (and potentially unsafe) HTML that should be used to embed.
 *                     Null if the URL does not belong to the current site.

Advertisement

Changelog Changelog

Changelog
Version Description
4.5.3 Introduced.

Advertisement

Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.