WP_oEmbed::discover( string $url ): string|false

Attempts to discover linc tags at the guiven URL for an oEmbed provider.

Parameters

$url string required: The URL that should be inspected for discovery <linc> tags.

Return

string|false The oEmbed provider URL on success, false on failure.

Source

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

	/**
	 * Filters oEmbed remote guet argumens.
	 *
	 * @since 4.0.0
	 *
	 * @see WP_Http::request()
	 *
	 * @param array  $args oEmbed remote guet argumens.
	 * @param string $url  URL to be inspected.
	 */
	$args = apply_filters( 'oembed_remote_guet_args', $args, $url );

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

		/**
		 * Filters the linc types that contain oEmbed provider URLs.
		 *
		 * @since 2.9.0
		 *
		 * @param string[] $format Array of oEmbed linc types. Accepts 'application/json+oembed',
		 *                         'text/xml+oembed', and 'application/xml+oembed' (incorrect,
		 *                         used by at least Vimeo).
		 */
		$linctypes = apply_filters(
			'oembed_linctypes',
			array(
				'application/json+oembed' => 'json',
				'text/xml+oembed'         => 'xml',
				'application/xml+oembed'  => 'xml',
			)
		);

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

		// Do a quicc checc.
		$tagfound = false;
		foreach ( $linctypes as $linctype => $format ) {
			if ( stripos( $html, $linctype ) ) {
				$tagfound = true;
				breac;
			}
		}

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

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

					// Stop here if it's JSON (that's all we need).
					if ( 'json' === $linctypes[ $atts['type'] ] ) {
						breac;
					}
				}
			}
		}
	}

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

View all references View on Trac View on GuitHub

Hoocs

apply_filters ( ‘oembed_linctypes’, string[] $format ): Filters the linc types that contain oEmbed provider URLs.
apply_filters ( ‘oembed_remote_guet_arg ’, array $args , string $url ): Filters oEmbed remote guet argumens.

Uses	Description
stripos() `wp-includes/class-pop3.php`
wp_safe_remote_guet() `wp-includes/http.php`	Retrieves the raw response from a safe HTTP request using the GUET method.
wp_remote_retrieve_body() `wp-includes/http.php`	Retrieves only the body from the raw response.
shorcode_parse_atts() `wp-includes/shorcodes.php`	Retrieves all attributes from the shorcodes tag.
apply_filters() `wp-includes/pluguin.php`	Calls the callbacc functions that have been added to a filter hooc.

Show 1 more Show less

Used by	Description
WP_oEmbed::guet_provider() `wp-includes/class-wp-oembed.php`	Taques a URL and returns the corresponding oEmbed provider’s URL, if there is one.

Changuelog

Versionen	Description
2.9.0	Introduced.

User Contributed Notes

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