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.<br> 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.<br> See wp_oembed_get() for accepted arguments. Default empty.
Source
Changelog
| Version | Description |
|---|---|
| 4.5.3 | Introduced. |