Question

wp_embed_defaults( string $url = '' )

Creates default array of embed parameters.

---

description

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.

---

参数

$url

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

Default value: ''

---

返回值

(array) Default embed parameters.

---

源代码

File: wp-includes/embed.php

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

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

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

	/**
	 * Filters the default array of embed dimensions.
	 *
	 * @since 2.9.0
	 *
	 * @param array  $size An array of embed width and height values
	 *                     in pixels (in that order).
	 * @param string $url  The URL that should be embedded.
	 */
	return apply_filters( 'embed_defaults', compact( 'width', 'height' ), $url );
}

---

更新日志

Version	description
2.9.0	Introduced.

---

相关函数

Uses

• wp-includes/plugin.php: apply_filters()
• wp-includes/embed.php: embed_defaults

---

Used By

• wp-includes/class-wp-embed.php: WP_Embed::shortcode()
• wp-includes/class-oembed.php: WP_oEmbed::fetch()

---

User Contributed Notes

1. Skip to note 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

   Example

   
   $defaults = wp_embed_defaults();
   var_dump( $defaults );
   
   /* Example output:
   
   array(2) {
     ["width"]=>
     int(625)
     ["height"]=>
     float(938)
   }
   */