oembed_dataparse │ filter-hook │ WP 2.9.0

Filters the returned oEmbed HTML.

Use this filter to add support for custom data types, or to filter the result.

Usage

add_filter( 'oembed_dataparse', 'wp_kama_oembed_dataparse_filter', 10, 3 );

/**
 * Function for `oembed_dataparse` filter-hook.
 * 
 * @param string|false $return The returned oEmbed HTML, or false on failure.
 * @param object       $data   A data object result from an oEmbed provider.
 * @param string       $url    The URL of the content to be embedded.
 *
 * @return string|false
 */
function wp_kama_oembed_dataparse_filter( $return, $data, $url ){

	// filter...
	return $return;
}

$return(string|false)

The returned oEmbed HTML, or false on failure.

$data(object)

A data object result from an oEmbed provider.

$url(string)

The URL of the content to be embedded.

Changelog

Where the hook is called

return apply_filters( 'oembed_dataparse', $return, $data, $url );

Where the hook is used in WordPress

add_filter( 'oembed_dataparse', array( $this, '_strip_newlines' ), 10, 3 );

add_filter( 'oembed_dataparse', 'wp_filter_oembed_iframe_title_attribute', 5, 3 );

add_filter( 'oembed_dataparse', 'wp_filter_oembed_result', 10, 3 );