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
$resultnull|string
The UNSANITIZED (and potentially unsafe) HTML that should be used to embed. Default null to continue retrieving the result.
$urlstring
The URL to the content that should be attempted to be embedded.
$argsstring|array
Additional arguments for retrieving embed HTML. See wp_oembed_get() for accepted arguments. Default empty.
396* @param null|string$result The UNSANITIZED(and potentially unsafe)HTML that should be used to embed.397*Defaultnull to continue retrieving the result.398* @param string$url The URL to the content that should be attempted to be embedded.399* @param string|array$args Optional. Additional arguments for retrieving embed HTML.400* See wp_oembed_get()for accepted arguments.Defaultempty.401*/402$pre=apply_filters('pre_oembed_result',null,$url,$args);403404if(null!==$pre){405return$pre;406}407408$data=$this->get_data($url,$args);
History
Introduced in 4.5.3. Unchanged from 6.7.7 through 7.1.0.