wp_oembed_get( string $url, array|string $args = '' ): string|false
Attempts to fetch the embed HTML for a provided URL using oEmbed.
Contents
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|stringOptional. Themaxwidth
value passed to the provider URL.height
int|stringOptional. Themaxheight
value passed to the provider URL.discover
boolOptional. 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:
''
Return
string|false The embed HTML on success, false on failure.
Source
File: wp-includes/embed.php
.
View all references
function wp_oembed_get( $url, $args = '' ) {
$oembed = _wp_oembed_get_object();
return $oembed->get_html( $url, $args );
}
Changelog
Version | Description |
---|---|
2.9.0 | Introduced. |
User Contributed Notes
You must log in before being able to contribute a note or feedback.
Retrieve the embed code for a URL from a supported
oEmbed
provider – withwidth
argument:Retrieve the embed code for a URL from a supported
oEmbed
provider: