embed_oembed_html │ filter-hook │ WP 2.9.0

Filters the cached oEmbed HTML.

Usage

add_filter( 'embed_oembed_html', 'wp_kama_embed_oembed_html_filter', 10, 4 );

/**
 * Function for `embed_oembed_html` filter-hook.
 * 
 * @param string|false $cache   The cached HTML result, stored in post meta.
 * @param string       $url     The attempted embed URL.
 * @param array        $attr    An array of shortcode attributes.
 * @param int          $post_id Post ID.
 *
 * @return string|false
 */
function wp_kama_embed_oembed_html_filter( $cache, $url, $attr, $post_id ){

	// filter...
	return $cache;
}

$cache(string|false)

The cached HTML result, stored in post meta.

$url(string)

The attempted embed URL.

$attr(array)

An array of shortcode attributes.

$post_id(int)

Post ID.

Changelog

Where the hook is called

return apply_filters( 'embed_oembed_html', $cache, $url, $attr, $post_id );

return apply_filters( 'embed_oembed_html', $html, $url, $attr, $post_id );

Where the hook is used in WordPress

add_filter( 'embed_oembed_html', 'wp_maybe_enqueue_oembed_host_js' );