wp_oembed_get( string $url, array|string $args = '' )

Attempts to fetch the embed HTML for a provided URL using oEmbed.

Contents

Description
- See also
Parameters
Return
Source
Related
- Uses
- Used By
Changelog
User Contributed Notes

Description

See also

WP_oEmbed

Parameters

$url

(string) (Required) The URL that should be embedded.

$args

(array|string) (Optional) Additional arguments for retrieving embed HTML.

'width'
(int|string) Optional. The maxwidth value passed to the provider URL.
'height'
(int|string) Optional. The maxheight value 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: ''

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 code Collapse full source code View on Trac View on GitHub

Uses

Uses
Uses	Description
wp-includes/embed.php: _wp_oembed_get_object()	Returns the initialized WP_oEmbed object.

Used By

Used By
Used By	Description
wp-includes/widgets/class-wp-widget-media-video.php: WP_Widget_Media_Video::render_media()	Render the media on the frontend.
wp-includes/class-wp-embed.php: WP_Embed::shortcode()	The do_shortcode() callback function.

Changelog

Changelog
Version	Description
2.9.0	Introduced.

User Contributed Notes

Skip to note 1 content

You must log in to vote on the helpfulness of this noteVote results for this note: 2You must log in to vote on the helpfulness of this note

Contributed by Codex — 7 years ago
Retrieve the embed code for a URL from a supported oEmbed provider – with width argument:
```
$embed_code = wp_oembed_get( 'http://www.youtube.com/watch?v=AbcDeFg123', array( 'width' => 400 ) );
```
Log in to add feedback
Skip to note 2 content

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

Contributed by Codex — 7 years ago
Retrieve the embed code for a URL from a supported oEmbed provider:
```
$embed_code = wp_oembed_get( 'http://www.youtube.com/watch?v=AbcDeFg123' );
```
Log in to add feedback

You must log in before being able to contribute a note or feedback.