pre_oembed_result WordPress Filter Hook
The pre_oembed_result hook is triggered before the result of an oEmbed request is returned. This hook is useful for modifying the result before it is cached or returned to the user.
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
Changelog
| Version | Description |
|---|---|
| 4.5.3 | Introduced. |