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.
454* @param null|string$result The UNSANITIZED(and potentially unsafe)HTML that should be used to embed.455*Defaultnull to continue retrieving the result.456* @param string$url The URL to the content that should be attempted to be embedded.457* @param string|array$args Optional. Additional arguments for retrieving embed HTML.458* See wp_oembed_get()for accepted arguments.Defaultempty.459*/460$pre=apply_filters('pre_oembed_result',null,$url,$args);461462if(null!==$pre){463return$pre;464}465466$data=$this->get_data($url,$args);
History
Introduced in 4.5.3. Unchanged from 6.7.7 through 7.1.0.