WordPress 4.3-scripts
[autoinstalls/wordpress.git] / wp-includes / class-wp-embed.php
index e3426ab8b10ccc3016e6952fcd57a063cb96a135..74051970948d3b2e790d88f7f313ed8a39808f2d 100644 (file)
@@ -11,6 +11,8 @@ class WP_Embed {
        public $post_ID;
        public $usecache = true;
        public $linkifunknown = true;
+       public $last_attr = array();
+       public $last_url = '';
 
        /**
         * When an URL cannot be embedded, return false instead of returning a link
@@ -42,7 +44,7 @@ class WP_Embed {
         * this function removes all existing shortcodes, registers the [embed] shortcode,
         * calls {@link do_shortcode()}, and then re-registers the old shortcodes.
         *
-        * @uses $shortcode_tags
+        * @global array $shortcode_tags
         *
         * @param string $content Content to parse
         * @return string Content with shortcode parsed
@@ -90,7 +92,7 @@ class WP_Embed {
         *
         * @param string $id An internal ID/name for the handler. Needs to be unique.
         * @param string $regex The regex that will be used to see if this handler should be used for a URL.
-        * @param callback $callback The callback function that will be called if the regex is matched.
+        * @param callable $callback The callback function that will be called if the regex is matched.
         * @param int $priority Optional. Used to specify the order in which the registered handlers will be tested (default: 10). Lower numbers correspond with earlier testing, and handlers with the same priority are tested in the order in which they were added to the action.
         */
        public function register_handler( $id, $regex, $callback, $priority = 10 ) {
@@ -107,8 +109,7 @@ class WP_Embed {
         * @param int $priority Optional. The priority of the handler to be removed (default: 10).
         */
        public function unregister_handler( $id, $priority = 10 ) {
-               if ( isset($this->handlers[$priority][$id]) )
-                       unset($this->handlers[$priority][$id]);
+               unset( $this->handlers[ $priority ][ $id ] );
        }
 
        /**
@@ -134,13 +135,18 @@ class WP_Embed {
                        $url = $attr['src'];
                }
 
+               $this->last_url = $url;
 
-               if ( empty( $url ) )
+               if ( empty( $url ) ) {
+                       $this->last_attr = $attr;
                        return '';
+               }
 
                $rawattr = $attr;
                $attr = wp_parse_args( $attr, wp_embed_defaults( $url ) );
 
+               $this->last_attr = $attr;
+
                // kses converts & into & and we need to undo this
                // See https://core.trac.wordpress.org/ticket/11311
                $url = str_replace( '&', '&', $url );