WordPress 4.4
[autoinstalls/wordpress.git] / wp-admin / includes / post.php
index 5fcceec0014decdfcf3bbaffa3f29287bf1ff45d..fa3e400e3c174949763b7a974d191b4837c318f1 100644 (file)
@@ -173,7 +173,7 @@ function _wp_translate_postdata( $update = false, $post_data = null ) {
  *
  * @since 1.5.0
  *
- * @global wpdb $wpdb
+ * @global wpdb $wpdb WordPress database abstraction object.
  *
  * @param array $post_data Optional.
  * @return int Post ID.
@@ -371,7 +371,7 @@ function edit_post( $post_data = null ) {
        if ( ! $success && is_callable( array( $wpdb, 'strip_invalid_text_for_column' ) ) ) {
                $fields = array( 'post_title', 'post_content', 'post_excerpt' );
 
-               foreach( $fields as $field ) {
+               foreach ( $fields as $field ) {
                        if ( isset( $post_data[ $field ] ) ) {
                                $post_data[ $field ] = $wpdb->strip_invalid_text_for_column( $wpdb->posts, $field, $post_data[ $field ] );
                        }
@@ -403,7 +403,7 @@ function edit_post( $post_data = null ) {
  *
  * @since 2.7.0
  *
- * @global wpdb $wpdb
+ * @global wpdb $wpdb WordPress database abstraction object.
  *
  * @param array $post_data Optional, the array of post data to process if not provided will use $_POST superglobal.
  * @return array
@@ -577,7 +577,8 @@ function bulk_edit_posts( $post_data = null ) {
  *
  * @since 2.0.0
  *
- * @param string $post_type A post type string, defaults to 'post'.
+ * @param string $post_type    Optional. A post type string. Default 'post'.
+ * @param bool   $create_in_db Optional. Whether to insert the post into database. Default false.
  * @return WP_Post Post object containing all the default post data as attributes
  */
 function get_default_post_to_edit( $post_type = 'post', $create_in_db = false ) {
@@ -658,7 +659,7 @@ function get_default_post_to_edit( $post_type = 'post', $create_in_db = false )
  *
  * @since 2.0.0
  *
- * @global wpdb $wpdb
+ * @global wpdb $wpdb WordPress database abstraction object.
  *
  * @param string $title Post title
  * @param string $content Optional post content
@@ -842,7 +843,7 @@ function delete_meta( $mid ) {
  *
  * @since 1.2.0
  *
- * @global wpdb $wpdb
+ * @global wpdb $wpdb WordPress database abstraction object.
  *
  * @return mixed
  */
@@ -875,7 +876,7 @@ function get_post_meta_by_id( $mid ) {
  *
  * @since 1.2.0
  *
- * @global wpdb $wpdb
+ * @global wpdb $wpdb WordPress database abstraction object.
  *
  * @param int $postid
  * @return mixed
@@ -1003,15 +1004,17 @@ function wp_edit_posts_query( $q = false ) {
                $perm = 'readable';
        }
 
-       if ( isset($q['orderby']) )
+       if ( isset( $q['orderby'] ) ) {
                $orderby = $q['orderby'];
-       elseif ( isset($q['post_status']) && in_array($q['post_status'], array('pending', 'draft')) )
+       } elseif ( isset( $q['post_status'] ) && in_array( $q['post_status'], array( 'pending', 'draft' ) ) ) {
                $orderby = 'modified';
+       }
 
-       if ( isset($q['order']) )
+       if ( isset( $q['order'] ) ) {
                $order = $q['order'];
-       elseif ( isset($q['post_status']) && 'pending' == $q['post_status'] )
+       } elseif ( isset( $q['post_status'] ) && 'pending' == $q['post_status'] ) {
                $order = 'ASC';
+       }
 
        $per_page = "edit_{$post_type}_per_page";
        $posts_per_page = (int) get_user_option( $per_page );
@@ -1067,7 +1070,7 @@ function wp_edit_posts_query( $q = false ) {
  *
  * @since 2.5.0
  *
- * @global wpdb $wpdb
+ * @global wpdb $wpdb WordPress database abstraction object.
  *
  * @param string $type
  * @return mixed
@@ -1123,7 +1126,7 @@ function wp_edit_attachments_query_vars( $q = false ) {
                unset($q['post_mime_type']);
        }
 
-       foreach( array_keys( $post_mime_types ) as $type ) {
+       foreach ( array_keys( $post_mime_types ) as $type ) {
                if ( isset( $q['attachment-filter'] ) && "post_mime_type:$type" == $q['attachment-filter'] ) {
                        $q['post_mime_type'] = $type;
                        break;
@@ -1242,20 +1245,31 @@ function get_sample_permalink($id, $title = null, $name = null) {
                }
 
                /** This filter is documented in wp-admin/edit-tag-form.php */
-               $uri = apply_filters( 'editable_slug', $uri );
+               $uri = apply_filters( 'editable_slug', $uri, $post );
                if ( !empty($uri) )
                        $uri .= '/';
                $permalink = str_replace('%pagename%', "{$uri}%pagename%", $permalink);
        }
 
        /** This filter is documented in wp-admin/edit-tag-form.php */
-       $permalink = array( $permalink, apply_filters( 'editable_slug', $post->post_name ) );
+       $permalink = array( $permalink, apply_filters( 'editable_slug', $post->post_name, $post ) );
        $post->post_status = $original_status;
        $post->post_date = $original_date;
        $post->post_name = $original_name;
        unset($post->filter);
 
-       return $permalink;
+       /**
+        * Filter the sample permalink.
+        *
+        * @since 4.4.0
+        *
+        * @param string  $permalink Sample permalink.
+        * @param int     $post_id   Post ID.
+        * @param string  $title     Post title.
+        * @param string  $name      Post name (slug).
+        * @param WP_Post $post      Post object.
+        */
+       return apply_filters( 'get_sample_permalink', $permalink, $post->ID, $title, $name, $post );
 }
 
 /**
@@ -1275,74 +1289,76 @@ function get_sample_permalink_html( $id, $new_title = null, $new_slug = null ) {
 
        list($permalink, $post_name) = get_sample_permalink($post->ID, $new_title, $new_slug);
 
-       if ( current_user_can( 'read_post', $post->ID ) ) {
-               $ptype = get_post_type_object( $post->post_type );
-               $view_post = $ptype->labels->view_item;
-       }
+       $view_link = false;
+       $preview_target = '';
 
-       if ( 'publish' == get_post_status( $post ) ) {
-               $title = __('Click to edit this part of the permalink');
-       } else {
-               $title = __('Temporary permalink. Click to edit this part.');
+       if ( current_user_can( 'read_post', $post->ID ) ) {
+               if ( 'draft' === $post->post_status ) {
+                       $draft_link = set_url_scheme( get_permalink( $post->ID ) );
+                       $view_link = get_preview_post_link( $post, array(), $draft_link );
+                       $preview_target = " target='wp-preview-{$post->ID}'";
+               } else {
+                       if ( 'publish' === $post->post_status || 'attachment' === $post->post_type ) {
+                               $view_link = get_permalink( $post );
+                       } else {
+                               // Allow non-published (private, future) to be viewed at a pretty permalink.
+                               $view_link = str_replace( array( '%pagename%', '%postname%' ), $post->post_name, urldecode( $permalink ) );
+                       }
+               }
        }
 
+       // Permalinks without a post/page name placeholder don't have anything to edit
        if ( false === strpos( $permalink, '%postname%' ) && false === strpos( $permalink, '%pagename%' ) ) {
-               $return = '<strong>' . __('Permalink:') . "</strong>\n" . '<span id="sample-permalink" tabindex="-1">' . $permalink . "</span>\n";
+               $return = '<strong>' . __( 'Permalink:' ) . "</strong>\n";
+
+               if ( false !== $view_link ) {
+                       $return .= '<a id="sample-permalink" href="' . esc_url( $view_link ) . '"' . $preview_target . '>' . $view_link . "</a>\n";
+               } else {
+                       $return .= '<span id="sample-permalink">' . $permalink . "</span>\n";
+               }
+
+               // Encourage a pretty permalink setting
                if ( '' == get_option( 'permalink_structure' ) && current_user_can( 'manage_options' ) && !( 'page' == get_option('show_on_front') && $id == get_option('page_on_front') ) ) {
                        $return .= '<span id="change-permalinks"><a href="options-permalink.php" class="button button-small" target="_blank">' . __('Change Permalinks') . "</a></span>\n";
                }
        } else {
                if ( function_exists( 'mb_strlen' ) ) {
-                       if ( mb_strlen( $post_name ) > 30 ) {
-                               $post_name_abridged = mb_substr( $post_name, 0, 14 ) . '&hellip;' . mb_substr( $post_name, -14 );
+                       if ( mb_strlen( $post_name ) > 34 ) {
+                               $post_name_abridged = mb_substr( $post_name, 0, 16 ) . '&hellip;' . mb_substr( $post_name, -16 );
                        } else {
                                $post_name_abridged = $post_name;
                        }
                } else {
-                       if ( strlen( $post_name ) > 30 ) {
-                               $post_name_abridged = substr( $post_name, 0, 14 ) . '&hellip;' . substr( $post_name, -14 );
+                       if ( strlen( $post_name ) > 34 ) {
+                               $post_name_abridged = substr( $post_name, 0, 16 ) . '&hellip;' . substr( $post_name, -16 );
                        } else {
                                $post_name_abridged = $post_name;
                        }
                }
 
-               $post_name_html = '<span id="editable-post-name" title="' . $title . '">' . $post_name_abridged . '</span>';
+               $post_name_html = '<span id="editable-post-name">' . $post_name_abridged . '</span>';
                $display_link = str_replace( array( '%pagename%', '%postname%' ), $post_name_html, urldecode( $permalink ) );
-               $pretty_permalink = str_replace( array( '%pagename%', '%postname%' ), $post_name, urldecode( $permalink ) );
 
-               $return =  '<strong>' . __( 'Permalink:' ) . "</strong>\n";
-               $return .= '<span id="sample-permalink" tabindex="-1">' . $display_link . "</span>\n";
+               $return = '<strong>' . __( 'Permalink:' ) . "</strong>\n";
+               $return .= '<span id="sample-permalink"><a href="' . esc_url( $view_link ) . '"' . $preview_target . '>' . $display_link . "</a></span>\n";
                $return .= '&lrm;'; // Fix bi-directional text display defect in RTL languages.
-               $return .= '<span id="edit-slug-buttons"><a href="#post_name" class="edit-slug button button-small hide-if-no-js" onclick="editPermalink(' . $id . '); return false;">' . __( 'Edit' ) . "</a></span>\n";
+               $return .= '<span id="edit-slug-buttons"><button type="button" class="edit-slug button button-small hide-if-no-js" aria-label="' . __( 'Edit permalink' ) . '">' . __( 'Edit' ) . "</button></span>\n";
                $return .= '<span id="editable-post-name-full">' . $post_name . "</span>\n";
        }
 
-       if ( isset( $view_post ) ) {
-               if ( 'draft' == $post->post_status ) {
-                       $preview_link = set_url_scheme( get_permalink( $post->ID ) );
-                       /** This filter is documented in wp-admin/includes/meta-boxes.php */
-                       $preview_link = apply_filters( 'preview_post_link', add_query_arg( 'preview', 'true', $preview_link ), $post );
-                       $return .= "<span id='view-post-btn'><a href='" . esc_url( $preview_link ) . "' class='button button-small' target='wp-preview-{$post->ID}'>$view_post</a></span>\n";
-               } else {
-                       if ( empty( $pretty_permalink ) ) {
-                               $pretty_permalink = $permalink;
-                       }
-
-                       $return .= "<span id='view-post-btn'><a href='" . $pretty_permalink . "' class='button button-small'>$view_post</a></span>\n";
-               }
-       }
-
        /**
         * Filter the sample permalink HTML markup.
         *
         * @since 2.9.0
+        * @since 4.4.0 Added `$post` parameter.
         *
-        * @param string      $return    Sample permalink HTML markup.
-        * @param int|WP_Post $id        Post object or ID.
-        * @param string      $new_title New sample permalink title.
-        * @param string      $new_slug  New sample permalink slug.
+        * @param string  $return    Sample permalink HTML markup.
+        * @param int     $post_id   Post ID.
+        * @param string  $new_title New sample permalink title.
+        * @param string  $new_slug  New sample permalink slug.
+        * @param WP_Post $post      Post object.
         */
-       $return = apply_filters( 'get_sample_permalink_html', $return, $id, $new_title, $new_slug );
+       $return = apply_filters( 'get_sample_permalink_html', $return, $post->ID, $new_title, $new_slug, $post );
 
        return $return;
 }
@@ -1374,12 +1390,29 @@ function _wp_post_thumbnail_html( $thumbnail_id = null, $post = null ) {
        );
 
        if ( $thumbnail_id && get_post( $thumbnail_id ) ) {
-               $old_content_width = $content_width;
-               $content_width = 266;
-               if ( !isset( $_wp_additional_image_sizes['post-thumbnail'] ) )
-                       $thumbnail_html = wp_get_attachment_image( $thumbnail_id, array( $content_width, $content_width ) );
-               else
-                       $thumbnail_html = wp_get_attachment_image( $thumbnail_id, 'post-thumbnail' );
+               $size = isset( $_wp_additional_image_sizes['post-thumbnail'] ) ? 'post-thumbnail' : array( 266, 266 );
+
+               /**
+                * Filter the size used to display the post thumbnail image in the 'Featured Image' meta box.
+                *
+                * Note: When a theme adds 'post-thumbnail' support, a special 'post-thumbnail'
+                * image size is registered, which differs from the 'thumbnail' image size
+                * managed via the Settings > Media screen. See the `$size` parameter description
+                * for more information on default values.
+                *
+                * @since 4.4.0
+                *
+                * @param string|array $size         Post thumbnail image size to display in the meta box. Accepts any valid
+                *                                   image size, or an array of width and height values in pixels (in that order).
+                *                                   If the 'post-thumbnail' size is set, default is 'post-thumbnail'. Otherwise,
+                *                                   default is an array with 266 as both the height and width values.
+                * @param int          $thumbnail_id Post thumbnail attachment ID.
+                * @param WP_Post      $post         The post object associated with the thumbnail.
+                */
+               $size = apply_filters( 'admin_post_thumbnail_size', $size, $thumbnail_id, $post );
+
+               $thumbnail_html = wp_get_attachment_image( $thumbnail_id, $size );
+
                if ( !empty( $thumbnail_html ) ) {
                        $ajax_nonce = wp_create_nonce( 'set_post_thumbnail-' . $post->ID );
                        $content = sprintf( $set_thumbnail_link,
@@ -1389,7 +1422,6 @@ function _wp_post_thumbnail_html( $thumbnail_id = null, $post = null ) {
                        );
                        $content .= '<p class="hide-if-no-js"><a href="#" id="remove-post-thumbnail" onclick="WPRemoveThumbnail(\'' . $ajax_nonce . '\');return false;">' . esc_html( $post_type_object->labels->remove_featured_image ) . '</a></p>';
                }
-               $content_width = $old_content_width;
        }
 
        /**
@@ -1508,20 +1540,17 @@ function _admin_notice_post_locked() {
        <?php
 
        if ( $locked ) {
+               $query_args = array();
                if ( get_post_type_object( $post->post_type )->public ) {
-                       $preview_link = set_url_scheme( add_query_arg( 'preview', 'true', get_permalink( $post->ID ) ) );
-
                        if ( 'publish' == $post->post_status || $user->ID != $post->post_author ) {
                                // Latest content is in autosave
                                $nonce = wp_create_nonce( 'post_preview_' . $post->ID );
-                               $preview_link = add_query_arg( array( 'preview_id' => $post->ID, 'preview_nonce' => $nonce ), $preview_link );
+                               $query_args['preview_id'] = $post->ID;
+                               $query_args['preview_nonce'] = $nonce;
                        }
-               } else {
-                       $preview_link = '';
                }
 
-               /** This filter is documented in wp-admin/includes/meta-boxes.php */
-               $preview_link = apply_filters( 'preview_post_link', $preview_link, $post );
+               $preview_link = get_preview_post_link( $post->ID, $query_args );
 
                /**
                 * Filter whether to allow the post lock to be overridden.
@@ -1582,7 +1611,7 @@ function _admin_notice_post_locked() {
                        <div class="post-locked-avatar"></div>
                        <p class="wp-tab-first" tabindex="0">
                        <span class="currently-editing"></span><br />
-                       <span class="locked-saving hidden"><img src="<?php echo esc_url( admin_url( 'images/spinner-2x.gif' ) ); ?>" width="16" height="16" /> <?php _e('Saving revision...'); ?></span>
+                       <span class="locked-saving hidden"><img src="<?php echo esc_url( admin_url( 'images/spinner-2x.gif' ) ); ?>" width="16" height="16" alt="" /> <?php _e( 'Saving revision&hellip;' ); ?></span>
                        <span class="locked-saved hidden"><?php _e('Your latest changes were saved as a revision.'); ?></span>
                        </p>
                        <?php
@@ -1707,7 +1736,7 @@ function post_preview() {
        if ( is_wp_error( $saved_post_id ) )
                wp_die( $saved_post_id->get_error_message() );
 
-       $query_args = array( 'preview' => 'true' );
+       $query_args = array();
 
        if ( $is_autosave && $saved_post_id ) {
                $query_args['preview_id'] = $post->ID;
@@ -1717,10 +1746,7 @@ function post_preview() {
                        $query_args['post_format'] = empty( $_POST['post_format'] ) ? 'standard' : sanitize_key( $_POST['post_format'] );
        }
 
-       $url = add_query_arg( $query_args, get_permalink( $post->ID ) );
-
-       /** This filter is documented in wp-admin/includes/meta-boxes.php */
-       return apply_filters( 'preview_post_link', $url, $post );
+       return get_preview_post_link( $post, $query_args );
 }
 
 /**
@@ -1766,3 +1792,52 @@ function wp_autosave( $post_data ) {
                return wp_create_post_autosave( wp_slash( $post_data ) );
        }
 }
+
+/**
+ * Redirect to previous page.
+ *
+ * @param int $post_id Optional. Post ID.
+ */
+function redirect_post($post_id = '') {
+       if ( isset($_POST['save']) || isset($_POST['publish']) ) {
+               $status = get_post_status( $post_id );
+
+               if ( isset( $_POST['publish'] ) ) {
+                       switch ( $status ) {
+                               case 'pending':
+                                       $message = 8;
+                                       break;
+                               case 'future':
+                                       $message = 9;
+                                       break;
+                               default:
+                                       $message = 6;
+                       }
+               } else {
+                       $message = 'draft' == $status ? 10 : 1;
+               }
+
+               $location = add_query_arg( 'message', $message, get_edit_post_link( $post_id, 'url' ) );
+       } elseif ( isset($_POST['addmeta']) && $_POST['addmeta'] ) {
+               $location = add_query_arg( 'message', 2, wp_get_referer() );
+               $location = explode('#', $location);
+               $location = $location[0] . '#postcustom';
+       } elseif ( isset($_POST['deletemeta']) && $_POST['deletemeta'] ) {
+               $location = add_query_arg( 'message', 3, wp_get_referer() );
+               $location = explode('#', $location);
+               $location = $location[0] . '#postcustom';
+       } else {
+               $location = add_query_arg( 'message', 4, get_edit_post_link( $post_id, 'url' ) );
+       }
+
+       /**
+        * Filter the post redirect destination URL.
+        *
+        * @since 2.9.0
+        *
+        * @param string $location The destination URL.
+        * @param int    $post_id  The post ID.
+        */
+       wp_redirect( apply_filters( 'redirect_post_location', $location, $post_id ) );
+       exit;
+}
\ No newline at end of file