WordPress 4.5-scripts

[autoinstalls/wordpress.git] / wp-admin / includes / class-wp-press-this.php

diff --git a/wp-admin/includes/class-wp-press-this.php b/wp-admin/includes/class-wp-press-this.php
index cdc4ad79bb307f7b4ea5d3f8e0bbc62fc29642d6..0288ed0520a62b999e9978935d2168433e3c812b 100644 (file)
--- a/wp-admin/includes/class-wp-press-this.php
+++ b/wp-admin/includes/class-wp-press-this.php
@@ -46,7 +46,7 @@ class WP_Press_This {
                         *
                         * @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,7 +91,7 @@ class WP_Press_This {
                        }
                }
 
-               // Edxpected slashed
+               // Expected slashed
                return wp_slash( $content );
        }
 
@@ -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,33 @@ 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'] );
 
-               $updated = wp_update_post( $post, true );
+               /**
+                * Filter the post data of a Press This post before saving/updating, after
+                * side_load_images action had run.
+                *
+                * @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_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 );
                                }
                        }
@@ -167,7 +177,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 ) );
@@ -272,7 +282,7 @@ class WP_Press_This {
                        return $remote_url;
                }
 
-               $useful_html_elements = array(
+               $allowed_elements = array(
                        'img' => array(
                                'src'      => true,
                                'width'    => true,
@@ -294,7 +304,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 +379,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 '';
                }
@@ -1161,12 +1171,17 @@ class WP_Press_This {
                }
 
                /**
-                * Filter the default HTML for the Press This editor.
+                * Filter 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 );