Question

wp_filter_pre_oembed_result( null|string $result,  string $url,  array $args )

Filters the oEmbed result before any HTTP requests are made.

---

description

If the URL belongs to the current site, the result is fetched directly instead of going through the oEmbed discovery process.

---

参数

$result

(null|string) (Required) The UNSANITIZED (and potentially unsafe) HTML that should be used to embed. Default null.

$url

(string) (Required) The URL that should be inspected for discovery <link> tags.

$args

(array) (Required) oEmbed remote get arguments.

---

返回值

(null|string) The UNSANITIZED (and potentially unsafe) HTML that should be used to embed. Null if the URL does not belong to the current site.

---

源代码

File: wp-includes/embed.php

function wp_filter_pre_oembed_result( $result, $url, $args ) {
	$post_id = url_to_postid( $url );

	/** This filter is documented in wp-includes/class-wp-oembed-controller.php */
	$post_id = apply_filters( 'oembed_request_post_id', $post_id, $url );

	if ( ! $post_id ) {
		return $result;
	}

	$width = isset( $args['width'] ) ? $args['width'] : 0;

	$data = get_oembed_response_data( $post_id, $width );
	$data = _wp_oembed_get_object()->data2html( (object) $data, $url );

	if ( ! $data ) {
		return $result;
	}

	return $data;
}

---

更新日志

Version	description
4.5.3	Introduced.

---

相关函数

Uses

• wp-includes/embed.php: get_oembed_response_data()
• wp-includes/class-wp-oembed-controller.php: oembed_request_post_id
• wp-includes/embed.php: _wp_oembed_get_object()
• wp-includes/plugin.php: apply_filters()
• wp-includes/rewrite.php: url_to_postid()

---

User Contributed Notes