]> scripts.mit.edu Git - autoinstalls/wordpress.git/blobdiff - wp-admin/includes/class-wp-press-this.php
WordPress 4.7
[autoinstalls/wordpress.git] / wp-admin / includes / class-wp-press-this.php
index 58ed28661a6a3bf1613ddfabd9390a0c8a0dd860..71ce5153d3a18b9b15d004ea431fe3eed04ee650 100644 (file)
@@ -13,8 +13,8 @@
  * @since 4.2.0
  */
 class WP_Press_This {
-
        // Used to trigger the bookmarklet update notice.
+       const VERSION = 8;
        public $version = 8;
 
        private $images = array();
@@ -42,11 +42,11 @@ class WP_Press_This {
        public function site_settings() {
                return array(
                        /**
-                        * Filter whether or not Press This should redirect the user in the parent window upon save.
+                        * Filters whether or not Press This should redirect the user in the parent window upon save.
                         *
                         * @since 4.2.0
                         *
-                        * @param bool false Whether to redirect in parent window or not. Default false.
+                        * @param bool $redirect Whether to redirect in parent window or not. Default false.
                         */
                        'redirInParent' => apply_filters( 'press_this_redirect_in_parent', false ),
                );
@@ -91,12 +91,12 @@ class WP_Press_This {
                        }
                }
 
-               // Edxpected slashed
+               // Expected slashed
                return wp_slash( $content );
        }
 
        /**
-        * AJAX handler for saving the post as draft or published.
+        * Ajax handler for saving the post as draft or published.
         *
         * @since 4.2.0
         * @access public
@@ -112,7 +112,7 @@ class WP_Press_This {
                        wp_send_json_error( array( 'errorMessage' => __( 'Invalid post.' ) ) );
                }
 
-               $post = array(
+               $post_data = array(
                        'ID'            => $post_id,
                        'post_title'    => ( ! empty( $_POST['post_title'] ) ) ? sanitize_text_field( trim( $_POST['post_title'] ) ) : '',
                        'post_content'  => ( ! empty( $_POST['post_content'] ) ) ? trim( $_POST['post_content'] ) : '',
@@ -125,23 +125,34 @@ class WP_Press_This {
 
                if ( ! empty( $_POST['post_status'] ) && 'publish' === $_POST['post_status'] ) {
                        if ( current_user_can( 'publish_posts' ) ) {
-                               $post['post_status'] = 'publish';
+                               $post_data['post_status'] = 'publish';
                        } else {
-                               $post['post_status'] = 'pending';
+                               $post_data['post_status'] = 'pending';
                        }
                }
 
-               $post['post_content'] = $this->side_load_images( $post_id, $post['post_content'] );
+               $post_data['post_content'] = $this->side_load_images( $post_id, $post_data['post_content'] );
+
+               /**
+                * Filters the post data of a Press This post before saving/updating.
+                *
+                * The {@see 'side_load_images'} action has already run at this point.
+                *
+                * @since 4.5.0
+                *
+                * @param array $post_data The post data.
+                */
+               $post_data = apply_filters( 'press_this_save_post', $post_data );
 
-               $updated = wp_update_post( $post, true );
+               $updated = wp_update_post( $post_data, true );
 
                if ( is_wp_error( $updated ) ) {
                        wp_send_json_error( array( 'errorMessage' => $updated->get_error_message() ) );
                } else {
-                       if ( isset( $post['post_format'] ) ) {
-                               if ( current_theme_supports( 'post-formats', $post['post_format'] ) ) {
-                                       set_post_format( $post_id, $post['post_format'] );
-                               } elseif ( $post['post_format'] ) {
+                       if ( isset( $post_data['post_format'] ) ) {
+                               if ( current_theme_supports( 'post-formats', $post_data['post_format'] ) ) {
+                                       set_post_format( $post_id, $post_data['post_format'] );
+                               } elseif ( $post_data['post_format'] ) {
                                        set_post_format( $post_id, false );
                                }
                        }
@@ -158,7 +169,7 @@ class WP_Press_This {
                        }
 
                        /**
-                        * Filter the URL to redirect to when Press This saves.
+                        * Filters the URL to redirect to when Press This saves.
                         *
                         * @since 4.2.0
                         *
@@ -167,7 +178,7 @@ class WP_Press_This {
                         * @param int    $post_id Post ID.
                         * @param string $status  Post status.
                         */
-                       $redirect = apply_filters( 'press_this_save_redirect', $redirect, $post_id, $post['post_status'] );
+                       $redirect = apply_filters( 'press_this_save_redirect', $redirect, $post_id, $post_data['post_status'] );
 
                        if ( $redirect ) {
                                wp_send_json_success( array( 'redirect' => $redirect, 'force' => $forceRedirect ) );
@@ -178,7 +189,7 @@ class WP_Press_This {
        }
 
        /**
-        * AJAX handler for adding a new category.
+        * Ajax handler for adding a new category.
         *
         * @since 4.2.0
         * @access public
@@ -256,8 +267,6 @@ class WP_Press_This {
         * @return string Source's HTML sanitized markup
         */
        public function fetch_source_html( $url ) {
-               global $wp_version;
-
                if ( empty( $url ) ) {
                        return new WP_Error( 'invalid-url', __( 'A valid URL was not provided.' ) );
                }
@@ -265,14 +274,14 @@ class WP_Press_This {
                $remote_url = wp_safe_remote_get( $url, array(
                        'timeout' => 30,
                        // Use an explicit user-agent for Press This
-                       'user-agent' => 'Press This (WordPress/' . $wp_version . '); ' . get_bloginfo( 'url' )
+                       'user-agent' => 'Press This (WordPress/' . get_bloginfo( 'version' ) . '); ' . get_bloginfo( 'url' )
                ) );
 
                if ( is_wp_error( $remote_url ) ) {
                        return $remote_url;
                }
 
-               $useful_html_elements = array(
+               $allowed_elements = array(
                        'img' => array(
                                'src'      => true,
                                'width'    => true,
@@ -294,7 +303,7 @@ class WP_Press_This {
                );
 
                $source_content = wp_remote_retrieve_body( $remote_url );
-               $source_content = wp_kses( $source_content, $useful_html_elements );
+               $source_content = wp_kses( $source_content, $allowed_elements );
 
                return $source_content;
        }
@@ -369,7 +378,7 @@ class WP_Press_This {
                        return ''; // Return empty rather than a truncated/invalid URL
                }
 
-               // Does not look like an URL.
+               // Does not look like a URL.
                if ( ! preg_match( '/^([!#$&-;=?-\[\]_a-z~]|%[0-9a-fA-F]{2})+$/', $url ) ) {
                        return '';
                }
@@ -390,8 +399,8 @@ class WP_Press_This {
        /**
         * Utility method to limit image source URLs.
         *
-        * Excluded URLs include share-this type buttons, loaders, spinners, spacers, WP interface images,
-        * tiny buttons or thumbs, mathtag.com or quantserve.com images, or the WP stats gif.
+        * Excluded URLs include share-this type buttons, loaders, spinners, spacers, WordPress interface images,
+        * tiny buttons or thumbs, mathtag.com or quantserve.com images, or the WordPress.com stats gif.
         *
         * @ignore
         * @since 4.2.0
@@ -402,32 +411,32 @@ class WP_Press_This {
        private function _limit_img( $src ) {
                $src = $this->_limit_url( $src );
 
-               if ( preg_match( '/\/ad[sx]{1}?\//', $src ) ) {
+               if ( preg_match( '!/ad[sx]?/!i', $src ) ) {
                        // Ads
                        return '';
-               } else if ( preg_match( '/(\/share-?this[^\.]+?\.[a-z0-9]{3,4})(\?.*)?$/', $src ) ) {
+               } else if ( preg_match( '!(/share-?this[^.]+?\.[a-z0-9]{3,4})(\?.*)?$!i', $src ) ) {
                        // Share-this type button
                        return '';
-               } else if ( preg_match( '/\/(spinner|loading|spacer|blank|rss)\.(gif|jpg|png)/', $src ) ) {
+               } else if ( preg_match( '!/(spinner|loading|spacer|blank|rss)\.(gif|jpg|png)!i', $src ) ) {
                        // Loaders, spinners, spacers
                        return '';
-               } else if ( preg_match( '/\/([^\.\/]+[-_]{1})?(spinner|loading|spacer|blank)s?([-_]{1}[^\.\/]+)?\.[a-z0-9]{3,4}/', $src ) ) {
+               } else if ( preg_match( '!/([^./]+[-_])?(spinner|loading|spacer|blank)s?([-_][^./]+)?\.[a-z0-9]{3,4}!i', $src ) ) {
                        // Fancy loaders, spinners, spacers
                        return '';
-               } else if ( preg_match( '/([^\.\/]+[-_]{1})?thumb[^.]*\.(gif|jpg|png)$/', $src ) ) {
+               } else if ( preg_match( '!([^./]+[-_])?thumb[^.]*\.(gif|jpg|png)$!i', $src ) ) {
                        // Thumbnails, too small, usually irrelevant to context
                        return '';
-               } else if ( preg_match( '/\/wp-includes\//', $src ) ) {
-                       // Classic WP interface images
+               } else if ( false !== stripos( $src, '/wp-includes/' ) ) {
+                       // Classic WordPress interface images
                        return '';
-               } else if ( preg_match( '/[^\d]{1}\d{1,2}x\d+\.(gif|jpg|png)$/', $src ) ) {
+               } else if ( preg_match( '![^\d]\d{1,2}x\d+\.(gif|jpg|png)$!i', $src ) ) {
                        // Most often tiny buttons/thumbs (< 100px wide)
                        return '';
-               } else if ( preg_match( '/\/pixel\.(mathtag|quantserve)\.com/', $src ) ) {
+               } else if ( preg_match( '!/pixel\.(mathtag|quantserve)\.com!i', $src ) ) {
                        // See mathtag.com and https://www.quantcast.com/how-we-do-it/iab-standard-measurement/how-we-collect-data/
                        return '';
-               } else if ( preg_match( '/\/[gb]\.gif(\?.+)?$/', $src ) ) {
-                       // Classic WP stats gif
+               } else if ( preg_match( '!/[gb]\.gif(\?.+)?$!i', $src ) ) {
+                       // WordPress.com stats gif
                        return '';
                }
 
@@ -452,23 +461,22 @@ class WP_Press_This {
                if ( empty( $src ) )
                        return '';
 
-               if ( preg_match( '/\/\/(m|www)\.youtube\.com\/(embed|v)\/([^\?]+)\?.+$/', $src, $src_matches ) ) {
+               if ( preg_match( '!//(m|www)\.youtube\.com/(embed|v)/([^?]+)\?.+$!i', $src, $src_matches ) ) {
                        // Embedded Youtube videos (www or mobile)
                        $src = 'https://www.youtube.com/watch?v=' . $src_matches[3];
-               } else if ( preg_match( '/\/\/player\.vimeo\.com\/video\/([\d]+)([\?\/]{1}.*)?$/', $src, $src_matches ) ) {
+               } else if ( preg_match( '!//player\.vimeo\.com/video/([\d]+)([?/].*)?$!i', $src, $src_matches ) ) {
                        // Embedded Vimeo iframe videos
                        $src = 'https://vimeo.com/' . (int) $src_matches[1];
-               } else if ( preg_match( '/\/\/vimeo\.com\/moogaloop\.swf\?clip_id=([\d]+)$/', $src, $src_matches ) ) {
+               } else if ( preg_match( '!//vimeo\.com/moogaloop\.swf\?clip_id=([\d]+)$!i', $src, $src_matches ) ) {
                        // Embedded Vimeo Flash videos
                        $src = 'https://vimeo.com/' . (int) $src_matches[1];
-               } else if ( preg_match( '/\/\/vine\.co\/v\/([^\/]+)\/embed/', $src, $src_matches ) ) {
+               } else if ( preg_match( '!//vine\.co/v/([^/]+)/embed!i', $src, $src_matches ) ) {
                        // Embedded Vine videos
                        $src = 'https://vine.co/v/' . $src_matches[1];
-               } else if ( preg_match( '/\/\/(www\.)?dailymotion\.com\/embed\/video\/([^\/\?]+)([\/\?]{1}.+)?/', $src, $src_matches ) ) {
+               } else if ( preg_match( '!//(www\.)?dailymotion\.com/embed/video/([^/?]+)([/?].+)?!i', $src, $src_matches ) ) {
                        // Embedded Daily Motion videos
                        $src = 'https://www.dailymotion.com/video/' . $src_matches[2];
                } else {
-                       require_once( ABSPATH . WPINC . '/class-oembed.php' );
                        $oembed = _wp_oembed_get_object();
 
                        if ( ! $oembed->get_provider( $src, array( 'discover' => false ) ) ) {
@@ -680,7 +688,7 @@ class WP_Press_This {
                }
 
                /**
-                * Filter whether to enable in-source media discovery in Press This.
+                * Filters whether to enable in-source media discovery in Press This.
                 *
                 * @since 4.2.0
                 *
@@ -755,7 +763,7 @@ class WP_Press_This {
                }
 
                /**
-                * Filter the Press This data array.
+                * Filters the Press This data array.
                 *
                 * @since 4.2.0
                 *
@@ -783,36 +791,7 @@ class WP_Press_This {
                        $press_this = str_replace( '.css', '-rtl.css', $press_this );
                }
 
-               $open_sans_font_url = '';
-
-               /* translators: If there are characters in your language that are not supported
-                * by Open Sans, translate this to 'off'. Do not translate into your own language.
-                */
-               if ( 'off' !== _x( 'on', 'Open Sans font: on or off' ) ) {
-                       $subsets = 'latin,latin-ext';
-
-                       /* translators: To add an additional Open Sans character subset specific to your language,
-                        * translate this to 'greek', 'cyrillic' or 'vietnamese'. Do not translate into your own language.
-                        */
-                       $subset = _x( 'no-subset', 'Open Sans font: add new subset (greek, cyrillic, vietnamese)' );
-
-                       if ( 'cyrillic' == $subset ) {
-                               $subsets .= ',cyrillic,cyrillic-ext';
-                       } elseif ( 'greek' == $subset ) {
-                               $subsets .= ',greek,greek-ext';
-                       } elseif ( 'vietnamese' == $subset ) {
-                               $subsets .= ',vietnamese';
-                       }
-
-                       $query_args = array(
-                               'family' => urlencode( 'Open Sans:400italic,700italic,400,600,700' ),
-                               'subset' => urlencode( $subsets ),
-                       );
-
-                       $open_sans_font_url = ',' . add_query_arg( $query_args, 'https://fonts.googleapis.com/css' );
-               }
-
-               return $styles . $press_this . $open_sans_font_url;
+               return $styles . $press_this;
        }
 
        /**
@@ -876,7 +855,7 @@ class WP_Press_This {
 
                if ( current_user_can( $taxonomy->cap->edit_terms ) ) {
                        ?>
-                       <button type="button" class="add-cat-toggle button-subtle" aria-expanded="false">
+                       <button type="button" class="add-cat-toggle button-link" aria-expanded="false">
                                <span class="dashicons dashicons-plus"></span><span class="screen-reader-text"><?php _e( 'Toggle add category' ); ?></span>
                        </button>
                        <div class="add-category is-hidden">
@@ -961,7 +940,7 @@ class WP_Press_This {
 
                if ( $user_can_assign_terms ) {
                        ?>
-                       <button type="button" class="button-reset button-link tagcloud-link" id="link-post_tag"><?php echo $taxonomy->labels->choose_from_most_used; ?></button>
+                       <button type="button" class="button-link tagcloud-link" id="link-post_tag" aria-expanded="false"><?php echo $taxonomy->labels->choose_from_most_used; ?></button>
                        <?php
                }
        }
@@ -984,7 +963,7 @@ class WP_Press_This {
                }
 
                if ( ! empty( $data['_embeds'] ) ) {
-                       foreach( $data['_embeds'] as $src ) {
+                       foreach ( $data['_embeds'] as $src ) {
                                $prot_relative_src = preg_replace( '/^https?:/', '', $src );
 
                                if ( in_array( $prot_relative_src, $this->embeds ) ) {
@@ -1012,7 +991,7 @@ class WP_Press_This {
                $selected_images = array();
 
                if ( ! empty( $data['_images'] ) ) {
-                       foreach( $data['_images'] as $src ) {
+                       foreach ( $data['_images'] as $src ) {
                                if ( false !== strpos( $src, 'gravatar.com' ) ) {
                                        $src = preg_replace( '%http://[\d]+\.gravatar\.com/%', 'https://secure.gravatar.com/', $src );
                                }
@@ -1161,12 +1140,17 @@ class WP_Press_This {
                }
 
                /**
-                * Filter the default HTML for the Press This editor.
+                * Filters the default HTML tags used in the suggested content for the editor.
+                *
+                * The HTML strings use printf format. After filtering the content is added at the specified places with `sprintf()`.
                 *
                 * @since 4.2.0
                 *
-                * @param array $default_html Associative array with two keys: 'quote' where %1$s is replaced with the site description
-                *                            or the selected content, and 'link' there %1$s is link href, %2$s is link text.
+                * @param array $default_html Associative array with three possible keys:
+                *                                - 'quote' where %1$s is replaced with the site description or the selected content.
+                *                                - 'link' where %1$s is link href, %2$s is link text, usually the source page title.
+                *                                - 'embed' which contains an [embed] shortcode when the source page offers embeddable content.
+                * @param array $data         Associative array containing the data from the source page.
                 */
                $default_html = apply_filters( 'press_this_suggested_html', $default_html, $data );
 
@@ -1203,11 +1187,12 @@ class WP_Press_This {
         * @access public
         *
         * @global WP_Locale $wp_locale
-        * @global string    $wp_version
         * @global bool      $is_IE
         */
        public function html() {
-               global $wp_locale, $wp_version;
+               global $wp_locale;
+
+               $wp_version = get_bloginfo( 'version' );
 
                // Get data, new (POST) and old (GET).
                $data = $this->merge_or_fetch_data();
@@ -1327,7 +1312,7 @@ class WP_Press_This {
        $admin_body_class .= ' branch-' . str_replace( array( '.', ',' ), '-', floatval( $wp_version ) );
        $admin_body_class .= ' version-' . str_replace( '.', '-', preg_replace( '/^([.0-9]+).*/', '$1', $wp_version ) );
        $admin_body_class .= ' admin-color-' . sanitize_html_class( get_user_option( 'admin_color' ), 'fresh' );
-       $admin_body_class .= ' locale-' . sanitize_html_class( strtolower( str_replace( '_', '-', get_locale() ) ) );
+       $admin_body_class .= ' locale-' . sanitize_html_class( strtolower( str_replace( '_', '-', get_user_locale() ) ) );
 
        /** This filter is documented in wp-admin/admin-header.php */
        $admin_body_classes = apply_filters( 'admin_body_class', '' );
@@ -1341,7 +1326,7 @@ class WP_Press_This {
                                <span class="current-site-name"><?php bloginfo( 'name' ); ?></span>
                        </a>
                </h1>
-               <button type="button" class="options button-subtle closed">
+               <button type="button" class="options button-link closed">
                        <span class="dashicons dashicons-tag on-closed"></span>
                        <span class="screen-reader-text on-closed"><?php _e( 'Show post options' ); ?></span>
                        <span aria-hidden="true" class="on-open"><?php _e( 'Done' ); ?></span>
@@ -1430,7 +1415,7 @@ class WP_Press_This {
                        <div class="post-options">
 
                                <?php if ( $supports_formats ) : ?>
-                                       <button type="button" class="button-reset post-option">
+                                       <button type="button" class="button-link post-option">
                                                <span class="dashicons dashicons-admin-post"></span>
                                                <span class="post-option-title"><?php _ex( 'Format', 'post format' ); ?></span>
                                                <span class="post-option-contents" id="post-option-post-format"><?php echo esc_html( get_post_format_string( $post_format ) ); ?></span>
@@ -1438,13 +1423,13 @@ class WP_Press_This {
                                        </button>
                                <?php endif; ?>
 
-                               <button type="button" class="button-reset post-option">
+                               <button type="button" class="button-link post-option">
                                        <span class="dashicons dashicons-category"></span>
                                        <span class="post-option-title"><?php _e( 'Categories' ); ?></span>
                                        <span class="dashicons post-option-forward"></span>
                                </button>
 
-                               <button type="button" class="button-reset post-option">
+                               <button type="button" class="button-link post-option">
                                        <span class="dashicons dashicons-tag"></span>
                                        <span class="post-option-title"><?php _e( 'Tags' ); ?></span>
                                        <span class="dashicons post-option-forward"></span>
@@ -1453,7 +1438,7 @@ class WP_Press_This {
 
                        <?php if ( $supports_formats ) : ?>
                                <div class="setting-modal is-off-screen is-hidden">
-                                       <button type="button" class="button-reset modal-close">
+                                       <button type="button" class="button-link modal-close">
                                                <span class="dashicons post-option-back"></span>
                                                <span class="setting-title" aria-hidden="true"><?php _ex( 'Format', 'post format' ); ?></span>
                                                <span class="screen-reader-text"><?php _e( 'Back to post options' ) ?></span>
@@ -1463,7 +1448,7 @@ class WP_Press_This {
                        <?php endif; ?>
 
                        <div class="setting-modal is-off-screen is-hidden">
-                               <button type="button" class="button-reset modal-close">
+                               <button type="button" class="button-link modal-close">
                                        <span class="dashicons post-option-back"></span>
                                        <span class="setting-title" aria-hidden="true"><?php _e( 'Categories' ); ?></span>
                                        <span class="screen-reader-text"><?php _e( 'Back to post options' ) ?></span>
@@ -1472,7 +1457,7 @@ class WP_Press_This {
                        </div>
 
                        <div class="setting-modal tags is-off-screen is-hidden">
-                               <button type="button" class="button-reset modal-close">
+                               <button type="button" class="button-link modal-close">
                                        <span class="dashicons post-option-back"></span>
                                        <span class="setting-title" aria-hidden="true"><?php _e( 'Tags' ); ?></span>
                                        <span class="screen-reader-text"><?php _e( 'Back to post options' ) ?></span>
@@ -1484,7 +1469,7 @@ class WP_Press_This {
 
        <div class="press-this-actions">
                <div class="pressthis-media-buttons">
-                       <button type="button" class="insert-media button-subtle" data-editor="pressthis">
+                       <button type="button" class="insert-media button-link" data-editor="pressthis">
                                <span class="dashicons dashicons-admin-media"></span>
                                <span class="screen-reader-text"><?php _e( 'Add Media' ); ?></span>
                        </button>
@@ -1495,16 +1480,16 @@ class WP_Press_This {
                                <div class="split-button-head">
                                        <button type="button" class="publish-button split-button-primary" aria-live="polite">
                                                <span class="publish"><?php echo ( current_user_can( 'publish_posts' ) ) ? __( 'Publish' ) : __( 'Submit for Review' ); ?></span>
-                                               <span class="saving-draft"><?php _e( 'Saving...' ); ?></span>
+                                               <span class="saving-draft"><?php _e( 'Saving&hellip;' ); ?></span>
                                        </button><button type="button" class="split-button-toggle" aria-haspopup="true" aria-expanded="false">
                                                <i class="dashicons dashicons-arrow-down-alt2"></i>
                                                <span class="screen-reader-text"><?php _e('More actions'); ?></span>
                                        </button>
                                </div>
                                <ul class="split-button-body">
-                                       <li><button type="button" class="button-subtle draft-button split-button-option"><?php _e( 'Save Draft' ); ?></button></li>
-                                       <li><button type="button" class="button-subtle standard-editor-button split-button-option"><?php _e( 'Standard Editor' ); ?></button></li>
-                                       <li><button type="button" class="button-subtle preview-button split-button-option"><?php _e( 'Preview' ); ?></button></li>
+                                       <li><button type="button" class="button-link draft-button split-button-option"><?php _e( 'Save Draft' ); ?></button></li>
+                                       <li><button type="button" class="button-link standard-editor-button split-button-option"><?php _e( 'Standard Editor' ); ?></button></li>
+                                       <li><button type="button" class="button-link preview-button split-button-option"><?php _e( 'Preview' ); ?></button></li>
                                </ul>
                        </div>
                </div>
@@ -1515,6 +1500,9 @@ class WP_Press_This {
        /** This action is documented in wp-admin/admin-footer.php */
        do_action( 'admin_footer' );
 
+       /** This action is documented in wp-admin/admin-footer.php */
+       do_action( 'admin_print_footer_scripts-press-this.php' );
+
        /** This action is documented in wp-admin/admin-footer.php */
        do_action( 'admin_print_footer_scripts' );
 
@@ -1527,9 +1515,3 @@ class WP_Press_This {
                die();
        }
 }
-
-/**
- *
- * @global WP_Press_This $wp_press_this
- */
-$GLOBALS['wp_press_this'] = new WP_Press_This;