WP_oEmbed::discover( string $url )

Attempts to discover link tags at the given URL for an oEmbed provider.

Parameters

$url

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

Return

(false|string) False on failure, otherwise the oEmbed provider URL.

Source

File: wp-includes/class-oembed.php 

	public function discover( $url ) {
		$providers = array();
		$args = array(
			'limit_response_size' => 153600, // 150 KB
		);

		/**
		 * Filters oEmbed remote get arguments.
		 *
		 * @since WP-4.0.0
		 *
		 * @see WP_Http::request()
		 *
		 * @param array  $args oEmbed remote get arguments.
		 * @param string $url  URL to be inspected.
		 */
		$args = apply_filters( 'oembed_remote_get_args', $args, $url );

		// Fetch URL content
		$request = wp_safe_remote_get( $url, $args );
		if ( $html = wp_remote_retrieve_body( $request ) ) {

			/**
			 * Filters the link types that contain oEmbed provider URLs.
			 *
			 * @since WP-2.9.0
			 *
			 * @param array $format Array of oEmbed link types. Accepts 'application/json+oembed',
			 *                      'text/xml+oembed', and 'application/xml+oembed' (incorrect,
			 *                      used by at least Vimeo).
			 */
			$linktypes = apply_filters( 'oembed_linktypes', array(
				'application/json+oembed' => 'json',
				'text/xml+oembed' => 'xml',
				'application/xml+oembed' => 'xml',
			) );

			// Strip <body>
			if ( $html_head_end = stripos( $html, '</head>' ) ) {
				$html = substr( $html, 0, $html_head_end );
			}

			// Do a quick check
			$tagfound = false;
			foreach ( $linktypes as $linktype => $format ) {
				if ( stripos($html, $linktype) ) {
					$tagfound = true;
					break;
				}
			}

			if ( $tagfound && preg_match_all( '#<link([^<>]+)/?>#iU', $html, $links ) ) {
				foreach ( $links[1] as $link ) {
					$atts = shortcode_parse_atts( $link );

					if ( !empty($atts['type']) && !empty($linktypes[$atts['type']]) && !empty($atts['href']) ) {
						$providers[$linktypes[$atts['type']]] = htmlspecialchars_decode( $atts['href'] );

						// Stop here if it's JSON (that's all we need)
						if ( 'json' == $linktypes[$atts['type']] )
							break;
					}
				}
			}
		}

		// JSON is preferred to XML
		if ( !empty($providers['json']) )
			return $providers['json'];
		elseif ( !empty($providers['xml']) )
			return $providers['xml'];
		else
			return false;
	}

Expand Source Code View on GitHub

Related

Uses

Uses
Uses Description
wp-includes/class-pop3.php: stripos()
wp-includes/http.php: wp_remote_retrieve_body()

Retrieve only the body from the raw response.
wp-includes/http.php: wp_safe_remote_get()

Retrieve the raw response from a safe HTTP request using the GET method.
wp-includes/plugin.php: apply_filters()

Call the functions added to a filter hook.
wp-includes/class-oembed.php: oembed_remote_get_args

Filters oEmbed remote get arguments.
wp-includes/class-oembed.php: oembed_linktypes

Filters the link types that contain oEmbed provider URLs.
wp-includes/shortcodes.php: shortcode_parse_atts()

Retrieve all attributes from the shortcodes tag.
Show 2 more uses Hide more uses

Used By

Used By
Used By Description
wp-includes/class-oembed.php: WP_oEmbed::get_provider()

Takes a URL and returns the corresponding oEmbed provider’s URL, if there is one.

Changelog

Changelog
Version Description
WP-2.9.0 Introduced.