wp_oembed_get() WordPress Function
The wp_oembed_get() function is used to get the HTML markup for an oEmbed resource. This function is used by the oEmbed feature to fetch the embed code for a given URL.
wp_oembed_get( string $url, array|string $args = '' ) #
Attempts to fetch the embed HTML for a provided URL using oEmbed.
Description
See also
Parameters
- $url
(string)(Required)The URL that should be embedded.
- $args
(array|string)(Optional)Additional arguments for retrieving embed HTML.
- 'width'
(int|string) Optional. Themaxwidthvalue passed to the provider URL. - 'height'
(int|string) Optional. Themaxheightvalue passed to the provider URL. - 'discover'
(bool) Optional. Determines whether to attempt to discover link tags at the given URL for an oEmbed provider when the provider URL is not found in the built-in providers list. Default true.
Default value: ''
- 'width'
Return
(string|false) The embed HTML on success, false on failure.
Source
File: wp-includes/embed.php
function wp_oembed_get( $url, $args = '' ) {
$oembed = _wp_oembed_get_object();
return $oembed->get_html( $url, $args );
}
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
| Version | Description |
|---|---|
| 2.9.0 | Introduced. |