WP_oEmbed::get_html() public WP 2.9.0
The do-it-all function that takes a URL and attempts to return the HTML.
{} It's a method of the class: WP_oEmbed{}
Hooks from the method
Return
String/false. The UNSANITIZED (and potentially unsafe) HTML that should be used to embed on success, false on failure.
Usage
$WP_oEmbed = new WP_oEmbed(); $WP_oEmbed->get_html( $url, $args );
- $url(string) (required)
- 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: ''
Notes
- See: WP_oEmbed::fetch()
- See: WP_oEmbed::data2html()
Changelog
Since 2.9.0 | Introduced. |
Code of WP_oEmbed::get_html() WP oEmbed::get html WP 5.6
public function get_html( $url, $args = '' ) {
/**
* 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.
*
* @since 4.5.3
*
* @param null|string $result The UNSANITIZED (and potentially unsafe) HTML that should be used to embed.
* Default null to continue retrieving the result.
* @param string $url The URL to the content that should be attempted to be embedded.
* @param string|array $args Optional. Additional arguments for retrieving embed HTML.
* See wp_oembed_get() for accepted arguments. Default empty.
*/
$pre = apply_filters( 'pre_oembed_result', null, $url, $args );
if ( null !== $pre ) {
return $pre;
}
$data = $this->get_data( $url, $args );
if ( false === $data ) {
return false;
}
/**
* Filters the HTML returned by the oEmbed provider.
*
* @since 2.9.0
*
* @param string|false $data The returned oEmbed HTML (false if unsafe).
* @param string $url URL of the content to be embedded.
* @param string|array $args Optional. Additional arguments for retrieving embed HTML.
* See wp_oembed_get() for accepted arguments. Default empty.
*/
return apply_filters( 'oembed_result', $this->data2html( $data, $url ), $url, $args );
}