Menu Adam R Brown

WP hooks navigation: Home/browseActions indexFilters index

Source View: oembed_remote_get_args

To save our bandwidth, we show only a snippet of code around each occurence of the hook. View complete file in SVN (without highlighting).

Understanding Source Code

The best way to understand what a hook does is to look at where it occurs in the source code.

Remember, this hook may occur in more than one file. Moreover, the hook's context may change from version to version.

Source View

This hook occurs 2 times in this file.

Line Code
430            * Filters oEmbed remote get arguments.
431            *
432            * @since 4.0.0
433            *
434            * @see WP_Http::request()
435            *
436            * @param array  $args oEmbed remote get arguments.
437            * @param string $url  URL to be inspected.
438            */
439           $args = apply_filters( 'oembed_remote_get_args', $args, $url );
440
441           // Fetch URL content
442           $request = wp_safe_remote_get( $url, $args );
443           if ( $html = wp_remote_retrieve_body( $request ) ) {
444
445                /**
446                 * Filters the link types that contain oEmbed provider URLs.
447                 *
448                 * @since 2.9.0
 
Line Code
541       *
542       * @param string $provider_url_with_args URL to the provider with full arguments list (url, maxheight, etc.)
543       * @param string $format Format to use
544       * @return false|object|WP_Error False on failure, otherwise the result in the form of an object.
545       */
546      private function _fetch_with_format( $provider_url_with_args, $format ) {
547           $provider_url_with_args = add_query_arg( 'format', $format, $provider_url_with_args );
548
549           /** This filter is documented in wp-includes/class-oembed.php */
550           $args = apply_filters( 'oembed_remote_get_args', array(), $provider_url_with_args );
551
552           $response = wp_safe_remote_get( $provider_url_with_args, $args );
553           if ( 501 == wp_remote_retrieve_response_code( $response ) )
554                return new WP_Error( 'not-implemented' );
555           if ( ! $body = wp_remote_retrieve_body( $response ) )
556                return false;
557           $parse_method = "_parse_$format";
558           return $this->$parse_method( $body );
559      }