wp_embed_defaults() │ WP 2.9.0

Creates default array of embed parameters.

The width defaults to the content width as specified by the theme. If the theme does not specify a content width, then 500px is used.

The default height is 1.5 times the width, or 1000px, whichever is smaller.

The embed_defaults filter can be used to adjust either of these values.

Returns

Int[]. Indexed array of the embed width and height in pixels.

Usage

wp_embed_defaults( $url );

$url(string)

The URL that should be embedded.
Default: ''

Notes

• Global. Int. $content_width

Changelog

wp_embed_defaults() wp embed defaults code ^{WP 6.8.3}

function wp_embed_defaults( $url = '' ) {
	if ( ! empty( $GLOBALS['content_width'] ) ) {
		$width = (int) $GLOBALS['content_width'];
	}

	if ( empty( $width ) ) {
		$width = 500;
	}

	$height = min( (int) ceil( $width * 1.5 ), 1000 );

	/**
	 * Filters the default array of embed dimensions.
	 *
	 * @since 2.9.0
	 *
	 * @param int[]  $size {
	 *     Indexed array of the embed width and height in pixels.
	 *
	 *     @type int $0 The embed width.
	 *     @type int $1 The embed height.
	 * }
	 * @param string $url  The URL that should be embedded.
	 */
	return apply_filters( 'embed_defaults', compact( 'width', 'height' ), $url );
}