wpseek.com
A WordPress-centric search engine for devs and theme authors



pre_oembed_result › WordPress Filter Hooks

Since4.5.3
Deprecatedn/a
› apply_filters( 'pre_oembed_result', null, $url, $args )
Parameters: (3)
  • () result The UNSANITIZED (and potentially unsafe) HTML that should be used to embed. Default null to continue retrieving the result.
    Required: Yes
  • () url The URL to the content that should be attempted to be embedded.
    Required: Yes
  • () args Optional. Additional arguments for retrieving embed HTML. See wp_oembed_get() for accepted arguments. Default empty.
    Required: Yes
Defined at:
Codex:

Filters the oEmbed result before any HTTP requests are made.

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.


Related Functions: wp_filter_oembed_result, wp_filter_pre_oembed_result, wp_oembed_get, wp_embed_defaults, wp_oembed_ensure_format, _oembed_create_xml


Related Hooks: oembed_result, rest_oembed_ttl, embed_defaults, post_embed_url, oembed_providers

Source 

$pre = apply_filters( 'pre_oembed_result', null, $url, $args );