Ticket #24381: 24381.2.patch

wp-includes/class-oembed.php

@@ -78 +78 @@
         }
 
         /**
-         * The do-it-all function that takes a URL and attempts to return the HTML.
+         * Takes a URL and return the corresponding oEmbed provider URL, if there is one.
          *
          * @see WP_oEmbed::discover()
-         * @see WP_oEmbed::fetch()
-         * @see WP_oEmbed::data2html()
          *
-         * @param string $url The URL to the content that should be attempted to be embedded.
-         * @param array $args Optional arguments. Usually passed from a shortcode.
-         * @return bool|string False on failure, otherwise the UNSANITIZED (and potentially unsafe) HTML that should be used to embed.
+         * @param string $url  The URL to the content.
+         * @param array  $args Optional arguments.
+         * @return bool|string False on failure, otherwise the oEmbed provider URL.
+         * @since 3.9.0
          */
-        function get_html( $url, $args = '' ) {
+        function get_provider( $url, $args = '' ) {
+
                 $provider = false;
 
                 if ( !isset($args['discover']) )
@@ -112 +112 @@
                 if ( !$provider && $args['discover'] )
                         $provider = $this->discover( $url );
 
+                return $provider;
+        }
+
+        /**
+         * The do-it-all function that takes a URL and attempts to return the HTML.
+         *
+         * @see WP_oEmbed::fetch()
+         * @see WP_oEmbed::data2html()
+         *
+         * @param string $url The URL to the content that should be attempted to be embedded.
+         * @param array $args Optional arguments. Usually passed from a shortcode.
+         * @return bool|string False on failure, otherwise the UNSANITIZED (and potentially unsafe) HTML that should be used to embed.
+         */
+        function get_html( $url, $args = '' ) {
+                $provider = $this->get_provider( $url, $args );
+
                 if ( !$provider || false === $data = $this->fetch( $provider, $url, $args ) )
                         return false;