apply_filters( 'pre_oembed_result', null|string $result, string $url, string|array $args )

Filters the oEmbed result before any HTTP requests are made.

Description

This allows one to short-circuit the default logic, perhaps by replacing it with a routine that is more optimal for your setup.

Returning a non-null value from the filter will effectively short-circuit retrieval and return the passed value instead.

Parameters

$result

(null|string) The UNSANITIZED (and potentially unsafe) HTML that should be used to embed. Default null to continue retrieving the result.

$url

(string) The URL to the content that should be attempted to be embedded.

$args

(string|array) Additional arguments for retrieving embed HTML. See wp_oembed_get() for accepted arguments. Default empty.

Source

File: wp-includes/class-wp-oembed.php

View on Trac

Used By

Used By Description
wp-includes/class-wp-oembed.php: WP_oEmbed::get_html()

The do-it-all function that takes a URL and attempts to return the HTML.

Changelog

Version Description
4.5.3 Introduced.

© 2003–2021 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/hooks/pre_oembed_result