Alert: This function’s access is marked private. This means it is not intended for use by plugin or theme developers, only in other core functions. It is listed here for completeness.

WP_oEmbed::_fetch_with_format() WordPress Method

The WP_oEmbed::_fetch_with_format() method is used to fetch the oEmbed response for a given URL with a specified format. This is used internally by the oEmbed class to fetch oEmbed responses.

WP_oEmbed::_fetch_with_format( string $provider_url_with_args, string $format ) #

Fetches result from an oEmbed provider for a specific format and complete provider URL


Parameters

$provider_url_with_args

(string)(Required)URL to the provider with full arguments list (url, maxheight, etc.)

$format

(string)(Required)Format to use.


Top ↑

Return

(object|false|WP_Error) The result in the form of an object on success, false on failure.


Top ↑

Source

File: wp-includes/class-wp-oembed.php

	private function _fetch_with_format( $provider_url_with_args, $format ) {
		$provider_url_with_args = add_query_arg( 'format', $format, $provider_url_with_args );

		/** This filter is documented in wp-includes/class-wp-oembed.php */
		$args = apply_filters( 'oembed_remote_get_args', array(), $provider_url_with_args );

		$response = wp_safe_remote_get( $provider_url_with_args, $args );
		if ( 501 == wp_remote_retrieve_response_code( $response ) ) {
			return new WP_Error( 'not-implemented' );
		}
		$body = wp_remote_retrieve_body( $response );
		if ( ! $body ) {
			return false;
		}
		$parse_method = "_parse_$format";
		return $this->$parse_method( $body );
	}


Top ↑

Changelog

Changelog
VersionDescription
3.0.0Introduced.

The content displayed on this page has been created in part by processing WordPress source code files which are made available under the GPLv2 (or a later version) license by theĀ Free Software Foundation. In addition to this, the content includes user-written examples and information. All material is subject to review and curation by the WPPaste.com community.