]> scripts.mit.edu Git - autoinstalls/wordpress.git/blobdiff - wp-admin/includes/ajax-actions.php
WordPress 4.3
[autoinstalls/wordpress.git] / wp-admin / includes / ajax-actions.php
index c39effe75ef42f4fb58b0bb94f5cc00d59630be9..77c32b05ed6d1701d2145a112fbcdd32d007143e 100644 (file)
@@ -6,27 +6,80 @@
  * @subpackage Administration
  */
 
  * @subpackage Administration
  */
 
-/*
- * No-privilege Ajax handlers.
- */
+//
+// No-privilege Ajax handlers.
+//
 
 
-function wp_ajax_nopriv_autosave() {
-       $id = isset( $_POST['post_ID'] ) ? (int) $_POST['post_ID'] : 0;
+/**
+ * Ajax handler for the Heartbeat API in
+ * the no-privilege context.
+ *
+ * Runs when the user is not logged in.
+ *
+ * @since 3.6.0
+ */
+function wp_ajax_nopriv_heartbeat() {
+       $response = array();
 
 
-       if ( ! $id )
-               wp_die( -1 );
+       // screen_id is the same as $current_screen->id and the JS global 'pagenow'.
+       if ( ! empty($_POST['screen_id']) )
+               $screen_id = sanitize_key($_POST['screen_id']);
+       else
+               $screen_id = 'front';
+
+       if ( ! empty($_POST['data']) ) {
+               $data = wp_unslash( (array) $_POST['data'] );
+
+               /**
+                * Filter Heartbeat AJAX response in no-privilege environments.
+                *
+                * @since 3.6.0
+                *
+                * @param array|object $response  The no-priv Heartbeat response object or array.
+                * @param array        $data      An array of data passed via $_POST.
+                * @param string       $screen_id The screen id.
+                */
+               $response = apply_filters( 'heartbeat_nopriv_received', $response, $data, $screen_id );
+       }
 
 
-       $message = sprintf( __('<strong>ALERT: You are logged out!</strong> Could not save draft. <a href="%s" target="_blank">Please log in again.</a>'), wp_login_url() );
-       $x = new WP_Ajax_Response( array(
-               'what' => 'autosave',
-               'id' => $id,
-               'data' => $message
-       ) );
-       $x->send();
+       /**
+        * Filter Heartbeat AJAX response when no data is passed.
+        *
+        * @since 3.6.0
+        *
+        * @param array|object $response  The Heartbeat response object or array.
+        * @param string       $screen_id The screen id.
+        */
+       $response = apply_filters( 'heartbeat_nopriv_send', $response, $screen_id );
+
+       /**
+        * Fires when Heartbeat ticks in no-privilege environments.
+        *
+        * Allows the transport to be easily replaced with long-polling.
+        *
+        * @since 3.6.0
+        *
+        * @param array|object $response  The no-priv Heartbeat response.
+        * @param string       $screen_id The screen id.
+        */
+       do_action( 'heartbeat_nopriv_tick', $response, $screen_id );
+
+       // Send the current time according to the server.
+       $response['server_time'] = time();
+
+       wp_send_json($response);
 }
 
 }
 
-/*
- * GET-based Ajax handlers.
+//
+// GET-based Ajax handlers.
+//
+
+/**
+ * Ajax handler for fetching a list table.
+ *
+ * @since 3.1.0
+ *
+ * @global WP_List_Table $wp_list_table
  */
 function wp_ajax_fetch_list() {
        global $wp_list_table;
  */
 function wp_ajax_fetch_list() {
        global $wp_list_table;
@@ -45,21 +98,28 @@ function wp_ajax_fetch_list() {
 
        wp_die( 0 );
 }
 
        wp_die( 0 );
 }
+
+/**
+ * Ajax handler for tag search.
+ *
+ * @since 3.1.0
+ */
 function wp_ajax_ajax_tag_search() {
 function wp_ajax_ajax_tag_search() {
-       global $wpdb;
+       if ( ! isset( $_GET['tax'] ) ) {
+               wp_die( 0 );
+       }
 
 
-       if ( isset( $_GET['tax'] ) ) {
-               $taxonomy = sanitize_key( $_GET['tax'] );
-               $tax = get_taxonomy( $taxonomy );
-               if ( ! $tax )
-                       wp_die( 0 );
-               if ( ! current_user_can( $tax->cap->assign_terms ) )
-                       wp_die( -1 );
-       } else {
+       $taxonomy = sanitize_key( $_GET['tax'] );
+       $tax = get_taxonomy( $taxonomy );
+       if ( ! $tax ) {
                wp_die( 0 );
        }
 
                wp_die( 0 );
        }
 
-       $s = stripslashes( $_GET['q'] );
+       if ( ! current_user_can( $tax->cap->assign_terms ) ) {
+               wp_die( -1 );
+       }
+
+       $s = wp_unslash( $_GET['q'] );
 
        $comma = _x( ',', 'tag delimiter' );
        if ( ',' !== $comma )
 
        $comma = _x( ',', 'tag delimiter' );
        if ( ',' !== $comma )
@@ -69,15 +129,37 @@ function wp_ajax_ajax_tag_search() {
                $s = $s[count( $s ) - 1];
        }
        $s = trim( $s );
                $s = $s[count( $s ) - 1];
        }
        $s = trim( $s );
-       if ( strlen( $s ) < 2 )
-               wp_die(); // require 2 chars for matching
 
 
-       $results = $wpdb->get_col( $wpdb->prepare( "SELECT t.name FROM $wpdb->term_taxonomy AS tt INNER JOIN $wpdb->terms AS t ON tt.term_id = t.term_id WHERE tt.taxonomy = %s AND t.name LIKE (%s)", $taxonomy, '%' . like_escape( $s ) . '%' ) );
+       /**
+        * Filter the minimum number of characters required to fire a tag search via AJAX.
+        *
+        * @since 4.0.0
+        *
+        * @param int    $characters The minimum number of characters required. Default 2.
+        * @param object $tax        The taxonomy object.
+        * @param string $s          The search term.
+        */
+       $term_search_min_chars = (int) apply_filters( 'term_search_min_chars', 2, $tax, $s );
+
+       /*
+        * Require $term_search_min_chars chars for matching (default: 2)
+        * ensure it's a non-negative, non-zero integer.
+        */
+       if ( ( $term_search_min_chars == 0 ) || ( strlen( $s ) < $term_search_min_chars ) ){
+               wp_die();
+       }
+
+       $results = get_terms( $taxonomy, array( 'name__like' => $s, 'fields' => 'names', 'hide_empty' => false ) );
 
        echo join( $results, "\n" );
        wp_die();
 }
 
 
        echo join( $results, "\n" );
        wp_die();
 }
 
+/**
+ * Ajax handler for compression testing.
+ *
+ * @since 3.1.0
+ */
 function wp_ajax_wp_compression_test() {
        if ( !current_user_can( 'manage_options' ) )
                wp_die( -1 );
 function wp_ajax_wp_compression_test() {
        if ( !current_user_can( 'manage_options' ) )
                wp_die( -1 );
@@ -92,7 +174,7 @@ function wp_ajax_wp_compression_test() {
                header( 'Last-Modified: ' . gmdate( 'D, d M Y H:i:s' ) . ' GMT' );
                header( 'Cache-Control: no-cache, must-revalidate, max-age=0' );
                header( 'Pragma: no-cache' );
                header( 'Last-Modified: ' . gmdate( 'D, d M Y H:i:s' ) . ' GMT' );
                header( 'Cache-Control: no-cache, must-revalidate, max-age=0' );
                header( 'Pragma: no-cache' );
-               header('Content-Type: application/x-javascript; charset=UTF-8');
+               header('Content-Type: application/javascript; charset=UTF-8');
                $force_gzip = ( defined('ENFORCE_GZIP') && ENFORCE_GZIP );
                $test_str = '"wpCompressionTest Lorem ipsum dolor sit amet consectetuer mollis sapien urna ut a. Eu nonummy condimentum fringilla tempor pretium platea vel nibh netus Maecenas. Hac molestie amet justo quis pellentesque est ultrices interdum nibh Morbi. Cras mattis pretium Phasellus ante ipsum ipsum ut sociis Suspendisse Lorem. Ante et non molestie. Porta urna Vestibulum egestas id congue nibh eu risus gravida sit. Ac augue auctor Ut et non a elit massa id sodales. Elit eu Nulla at nibh adipiscing mattis lacus mauris at tempus. Netus nibh quis suscipit nec feugiat eget sed lorem et urna. Pellentesque lacus at ut massa consectetuer ligula ut auctor semper Pellentesque. Ut metus massa nibh quam Curabitur molestie nec mauris congue. Volutpat molestie elit justo facilisis neque ac risus Ut nascetur tristique. Vitae sit lorem tellus et quis Phasellus lacus tincidunt nunc Fusce. Pharetra wisi Suspendisse mus sagittis libero lacinia Integer consequat ac Phasellus. Et urna ac cursus tortor aliquam Aliquam amet tellus volutpat Vestibulum. Justo interdum condimentum In augue congue tellus sollicitudin Quisque quis nibh."';
 
                $force_gzip = ( defined('ENFORCE_GZIP') && ENFORCE_GZIP );
                $test_str = '"wpCompressionTest Lorem ipsum dolor sit amet consectetuer mollis sapien urna ut a. Eu nonummy condimentum fringilla tempor pretium platea vel nibh netus Maecenas. Hac molestie amet justo quis pellentesque est ultrices interdum nibh Morbi. Cras mattis pretium Phasellus ante ipsum ipsum ut sociis Suspendisse Lorem. Ante et non molestie. Porta urna Vestibulum egestas id congue nibh eu risus gravida sit. Ac augue auctor Ut et non a elit massa id sodales. Elit eu Nulla at nibh adipiscing mattis lacus mauris at tempus. Netus nibh quis suscipit nec feugiat eget sed lorem et urna. Pellentesque lacus at ut massa consectetuer ligula ut auctor semper Pellentesque. Ut metus massa nibh quam Curabitur molestie nec mauris congue. Volutpat molestie elit justo facilisis neque ac risus Ut nascetur tristique. Vitae sit lorem tellus et quis Phasellus lacus tincidunt nunc Fusce. Pharetra wisi Suspendisse mus sagittis libero lacinia Integer consequat ac Phasellus. Et urna ac cursus tortor aliquam Aliquam amet tellus volutpat Vestibulum. Justo interdum condimentum In augue congue tellus sollicitudin Quisque quis nibh."';
 
@@ -123,6 +205,11 @@ function wp_ajax_wp_compression_test() {
        wp_die( 0 );
 }
 
        wp_die( 0 );
 }
 
+/**
+ * Ajax handler for image editor previews.
+ *
+ * @since 3.1.0
+ */
 function wp_ajax_imgedit_preview() {
        $post_id = intval($_GET['postid']);
        if ( empty($post_id) || !current_user_can('edit_post', $post_id) )
 function wp_ajax_imgedit_preview() {
        $post_id = intval($_GET['postid']);
        if ( empty($post_id) || !current_user_can('edit_post', $post_id) )
@@ -137,33 +224,55 @@ function wp_ajax_imgedit_preview() {
        wp_die();
 }
 
        wp_die();
 }
 
+/**
+ * Ajax handler for oEmbed caching.
+ *
+ * @since 3.1.0
+ *
+ * @global WP_Embed $wp_embed
+ */
 function wp_ajax_oembed_cache() {
 function wp_ajax_oembed_cache() {
-       global $wp_embed;
-
-       $return = ( $wp_embed->cache_oembed( $_GET['post'] ) ) ? '1' : '0';
-       wp_die( $return );
+       $GLOBALS['wp_embed']->cache_oembed( $_GET['post'] );
+       wp_die( 0 );
 }
 
 }
 
+/**
+ * Ajax handler for user autocomplete.
+ *
+ * @since 3.4.0
+ */
 function wp_ajax_autocomplete_user() {
        if ( ! is_multisite() || ! current_user_can( 'promote_users' ) || wp_is_large_network( 'users' ) )
                wp_die( -1 );
 
 function wp_ajax_autocomplete_user() {
        if ( ! is_multisite() || ! current_user_can( 'promote_users' ) || wp_is_large_network( 'users' ) )
                wp_die( -1 );
 
+       /** This filter is documented in wp-admin/user-new.php */
        if ( ! is_super_admin() && ! apply_filters( 'autocomplete_users_for_site_admins', false ) )
                wp_die( -1 );
 
        $return = array();
 
        // Check the type of request
        if ( ! is_super_admin() && ! apply_filters( 'autocomplete_users_for_site_admins', false ) )
                wp_die( -1 );
 
        $return = array();
 
        // Check the type of request
-       if ( isset( $_REQUEST['autocomplete_type'] ) )
+       // Current allowed values are `add` and `search`
+       if ( isset( $_REQUEST['autocomplete_type'] ) && 'search' === $_REQUEST['autocomplete_type'] ) {
                $type = $_REQUEST['autocomplete_type'];
                $type = $_REQUEST['autocomplete_type'];
-       else
+       } else {
                $type = 'add';
                $type = 'add';
+       }
+
+       // Check the desired field for value
+       // Current allowed values are `user_email` and `user_login`
+       if ( isset( $_REQUEST['autocomplete_field'] ) && 'user_email' === $_REQUEST['autocomplete_field'] ) {
+               $field = $_REQUEST['autocomplete_field'];
+       } else {
+               $field = 'user_login';
+       }
 
        // Exclude current users of this blog
 
        // Exclude current users of this blog
-       if ( isset( $_REQUEST['site_id'] ) )
+       if ( isset( $_REQUEST['site_id'] ) ) {
                $id = absint( $_REQUEST['site_id'] );
                $id = absint( $_REQUEST['site_id'] );
-       else
+       } else {
                $id = get_current_blog_id();
                $id = get_current_blog_id();
+       }
 
        $include_blog_users = ( $type == 'search' ? get_users( array( 'blog_id' => $id, 'fields' => 'ID' ) ) : array() );
        $exclude_blog_users = ( $type == 'add' ? get_users( array( 'blog_id' => $id, 'fields' => 'ID' ) ) : array() );
 
        $include_blog_users = ( $type == 'search' ? get_users( array( 'blog_id' => $id, 'fields' => 'ID' ) ) : array() );
        $exclude_blog_users = ( $type == 'add' ? get_users( array( 'blog_id' => $id, 'fields' => 'ID' ) ) : array() );
@@ -180,56 +289,63 @@ function wp_ajax_autocomplete_user() {
                $return[] = array(
                        /* translators: 1: user_login, 2: user_email */
                        'label' => sprintf( __( '%1$s (%2$s)' ), $user->user_login, $user->user_email ),
                $return[] = array(
                        /* translators: 1: user_login, 2: user_email */
                        'label' => sprintf( __( '%1$s (%2$s)' ), $user->user_login, $user->user_email ),
-                       'value' => $user->user_login,
+                       'value' => $user->$field,
                );
        }
 
                );
        }
 
-       wp_die( json_encode( $return ) );
+       wp_die( wp_json_encode( $return ) );
 }
 
 }
 
+/**
+ * Ajax handler for dashboard widgets.
+ *
+ * @since 3.4.0
+ */
 function wp_ajax_dashboard_widgets() {
        require_once ABSPATH . 'wp-admin/includes/dashboard.php';
 
 function wp_ajax_dashboard_widgets() {
        require_once ABSPATH . 'wp-admin/includes/dashboard.php';
 
+       $pagenow = $_GET['pagenow'];
+       if ( $pagenow === 'dashboard-user' || $pagenow === 'dashboard-network' || $pagenow === 'dashboard' ) {
+               set_current_screen( $pagenow );
+       }
+
        switch ( $_GET['widget'] ) {
        switch ( $_GET['widget'] ) {
-               case 'dashboard_incoming_links' :
-                       wp_dashboard_incoming_links();
-                       break;
                case 'dashboard_primary' :
                        wp_dashboard_primary();
                        break;
                case 'dashboard_primary' :
                        wp_dashboard_primary();
                        break;
-               case 'dashboard_secondary' :
-                       wp_dashboard_secondary();
-                       break;
-               case 'dashboard_plugins' :
-                       wp_dashboard_plugins();
-                       break;
        }
        wp_die();
 }
 
        }
        wp_die();
 }
 
+/**
+ * Ajax handler for Customizer preview logged-in status.
+ *
+ * @since 3.4.0
+ */
 function wp_ajax_logged_in() {
        wp_die( 1 );
 }
 
 function wp_ajax_logged_in() {
        wp_die( 1 );
 }
 
-/*
- * Ajax helper.
- */
+//
+// Ajax helpers.
+//
 
 /**
  * Sends back current comment total and new page links if they need to be updated.
  *
  * Contrary to normal success AJAX response ("1"), die with time() on success.
  *
 
 /**
  * Sends back current comment total and new page links if they need to be updated.
  *
  * Contrary to normal success AJAX response ("1"), die with time() on success.
  *
- * @since 2.7
+ * @since 2.7.0
  *
  * @param int $comment_id
  *
  * @param int $comment_id
- * @return die
+ * @param int $delta
  */
 function _wp_ajax_delete_comment_response( $comment_id, $delta = -1 ) {
  */
 function _wp_ajax_delete_comment_response( $comment_id, $delta = -1 ) {
-       $total = (int) @$_POST['_total'];
-       $per_page = (int) @$_POST['_per_page'];
-       $page = (int) @$_POST['_page'];
-       $url = esc_url_raw( @$_POST['_url'] );
+       $total    = isset( $_POST['_total'] )    ? (int) $_POST['_total']    : 0;
+       $per_page = isset( $_POST['_per_page'] ) ? (int) $_POST['_per_page'] : 0;
+       $page     = isset( $_POST['_page'] )     ? (int) $_POST['_page']     : 0;
+       $url      = isset( $_POST['_url'] )      ? esc_url_raw( $_POST['_url'] ) : '';
+
        // JS didn't send us everything we need to know. Just die with success message
        if ( !$total || !$per_page || !$page || !$url )
                wp_die( time() );
        // JS didn't send us everything we need to know. Just die with success message
        if ( !$total || !$per_page || !$page || !$url )
                wp_die( time() );
@@ -253,18 +369,21 @@ function _wp_ajax_delete_comment_response( $comment_id, $delta = -1 ) {
 
                $comment_count = wp_count_comments($post_id);
 
 
                $comment_count = wp_count_comments($post_id);
 
-               if ( isset( $comment_count->$status ) ) // We're looking for a known type of comment count
+               // We're looking for a known type of comment count.
+               if ( isset( $comment_count->$status ) )
                        $total = $comment_count->$status;
                        $total = $comment_count->$status;
-                       // else use the decremented value from above
+                       // Else use the decremented value from above.
        }
 
        }
 
-       $time = time(); // The time since the last comment count
+       // The time since the last comment count.
+       $time = time();
 
        $x = new WP_Ajax_Response( array(
                'what' => 'comment',
 
        $x = new WP_Ajax_Response( array(
                'what' => 'comment',
-               'id' => $comment_id, // here for completeness - not used
+               // Here for completeness - not used.
+               'id' => $comment_id,
                'supplemental' => array(
                'supplemental' => array(
-                       'total_items_i18n' => sprintf( _n( '1 item', '%s items', $total ), number_format_i18n( $total ) ),
+                       'total_items_i18n' => sprintf( _n( '%s item', '%s items', $total ), number_format_i18n( $total ) ),
                        'total_pages' => ceil( $total / $per_page ),
                        'total_pages_i18n' => number_format_i18n( ceil( $total / $per_page ) ),
                        'total' => $total,
                        'total_pages' => ceil( $total / $per_page ),
                        'total_pages_i18n' => number_format_i18n( ceil( $total / $per_page ) ),
                        'total' => $total,
@@ -274,10 +393,15 @@ function _wp_ajax_delete_comment_response( $comment_id, $delta = -1 ) {
        $x->send();
 }
 
        $x->send();
 }
 
-/*
- * POST-based Ajax handlers.
- */
+//
+// POST-based Ajax handlers.
+//
 
 
+/**
+ * Ajax handler for adding a hierarchical term.
+ *
+ * @since 3.1.0
+ */
 function _wp_ajax_add_hierarchical_term() {
        $action = $_POST['action'];
        $taxonomy = get_taxonomy(substr($action, 4));
 function _wp_ajax_add_hierarchical_term() {
        $action = $_POST['action'];
        $taxonomy = get_taxonomy(substr($action, 4));
@@ -302,17 +426,21 @@ function _wp_ajax_add_hierarchical_term() {
                        continue;
                if ( !$cat_id = term_exists( $cat_name, $taxonomy->name, $parent ) )
                        $cat_id = wp_insert_term( $cat_name, $taxonomy->name, array( 'parent' => $parent ) );
                        continue;
                if ( !$cat_id = term_exists( $cat_name, $taxonomy->name, $parent ) )
                        $cat_id = wp_insert_term( $cat_name, $taxonomy->name, array( 'parent' => $parent ) );
-               if ( is_wp_error( $cat_id ) )
+               if ( is_wp_error( $cat_id ) ) {
                        continue;
                        continue;
-               else if ( is_array( $cat_id ) )
+               } elseif ( is_array( $cat_id ) ) {
                        $cat_id = $cat_id['term_id'];
                        $cat_id = $cat_id['term_id'];
+               }
                $checked_categories[] = $cat_id;
                if ( $parent ) // Do these all at once in a second
                        continue;
                $checked_categories[] = $cat_id;
                if ( $parent ) // Do these all at once in a second
                        continue;
+
                ob_start();
                ob_start();
-                       wp_terms_checklist( 0, array( 'taxonomy' => $taxonomy->name, 'descendants_and_self' => $cat_id, 'selected_cats' => $checked_categories, 'popular_cats' => $popular_ids ));
-               $data = ob_get_contents();
-               ob_end_clean();
+
+               wp_terms_checklist( 0, array( 'taxonomy' => $taxonomy->name, 'descendants_and_self' => $cat_id, 'selected_cats' => $checked_categories, 'popular_cats' => $popular_ids ));
+
+               $data = ob_get_clean();
+
                $add = array(
                        'what' => $taxonomy->name,
                        'id' => $cat_id,
                $add = array(
                        'what' => $taxonomy->name,
                        'id' => $cat_id,
@@ -333,9 +461,11 @@ function _wp_ajax_add_hierarchical_term() {
                }
 
                ob_start();
                }
 
                ob_start();
-                       wp_terms_checklist( 0, array('taxonomy' => $taxonomy->name, 'descendants_and_self' => $term_id, 'selected_cats' => $checked_categories, 'popular_cats' => $popular_ids));
-               $data = ob_get_contents();
-               ob_end_clean();
+
+               wp_terms_checklist( 0, array('taxonomy' => $taxonomy->name, 'descendants_and_self' => $term_id, 'selected_cats' => $checked_categories, 'popular_cats' => $popular_ids));
+
+               $data = ob_get_clean();
+
                $add = array(
                        'what' => $taxonomy->name,
                        'id' => $term_id,
                $add = array(
                        'what' => $taxonomy->name,
                        'id' => $term_id,
@@ -345,18 +475,25 @@ function _wp_ajax_add_hierarchical_term() {
        }
 
        ob_start();
        }
 
        ob_start();
-               wp_dropdown_categories( array(
-                       'taxonomy' => $taxonomy->name, 'hide_empty' => 0, 'name' => 'new'.$taxonomy->name.'_parent', 'orderby' => 'name',
-                       'hierarchical' => 1, 'show_option_none' => '&mdash; '.$taxonomy->labels->parent_item.' &mdash;'
-               ) );
-       $sup = ob_get_contents();
-       ob_end_clean();
+
+       wp_dropdown_categories( array(
+               'taxonomy' => $taxonomy->name, 'hide_empty' => 0, 'name' => 'new'.$taxonomy->name.'_parent', 'orderby' => 'name',
+               'hierarchical' => 1, 'show_option_none' => '&mdash; '.$taxonomy->labels->parent_item.' &mdash;'
+       ) );
+
+       $sup = ob_get_clean();
+
        $add['supplemental'] = array( 'newcat_parent' => $sup );
 
        $x = new WP_Ajax_Response( $add );
        $x->send();
 }
 
        $add['supplemental'] = array( 'newcat_parent' => $sup );
 
        $x = new WP_Ajax_Response( $add );
        $x->send();
 }
 
+/**
+ * Ajax handler for deleting a comment.
+ *
+ * @since 3.1.0
+ */
 function wp_ajax_delete_comment() {
        $id = isset( $_POST['id'] ) ? (int) $_POST['id'] : 0;
 
 function wp_ajax_delete_comment() {
        $id = isset( $_POST['id'] ) ? (int) $_POST['id'] : 0;
 
@@ -400,6 +537,11 @@ function wp_ajax_delete_comment() {
        wp_die( 0 );
 }
 
        wp_die( 0 );
 }
 
+/**
+ * Ajax handler for deleting a tag.
+ *
+ * @since 3.1.0
+ */
 function wp_ajax_delete_tag() {
        $tag_id = (int) $_POST['tag_ID'];
        check_ajax_referer( "delete-tag_$tag_id" );
 function wp_ajax_delete_tag() {
        $tag_id = (int) $_POST['tag_ID'];
        check_ajax_referer( "delete-tag_$tag_id" );
@@ -420,6 +562,11 @@ function wp_ajax_delete_tag() {
                wp_die( 0 );
 }
 
                wp_die( 0 );
 }
 
+/**
+ * Ajax handler for deleting a link.
+ *
+ * @since 3.1.0
+ */
 function wp_ajax_delete_link() {
        $id = isset( $_POST['id'] ) ? (int) $_POST['id'] : 0;
 
 function wp_ajax_delete_link() {
        $id = isset( $_POST['id'] ) ? (int) $_POST['id'] : 0;
 
@@ -437,6 +584,11 @@ function wp_ajax_delete_link() {
                wp_die( 0 );
 }
 
                wp_die( 0 );
 }
 
+/**
+ * Ajax handler for deleting meta.
+ *
+ * @since 3.1.0
+ */
 function wp_ajax_delete_meta() {
        $id = isset( $_POST['id'] ) ? (int) $_POST['id'] : 0;
 
 function wp_ajax_delete_meta() {
        $id = isset( $_POST['id'] ) ? (int) $_POST['id'] : 0;
 
@@ -451,6 +603,13 @@ function wp_ajax_delete_meta() {
        wp_die( 0 );
 }
 
        wp_die( 0 );
 }
 
+/**
+ * Ajax handler for deleting a post.
+ *
+ * @since 3.1.0
+ *
+ * @param string $action Action to perform.
+ */
 function wp_ajax_delete_post( $action ) {
        if ( empty( $action ) )
                $action = 'delete-post';
 function wp_ajax_delete_post( $action ) {
        if ( empty( $action ) )
                $action = 'delete-post';
@@ -469,6 +628,13 @@ function wp_ajax_delete_post( $action ) {
                wp_die( 0 );
 }
 
                wp_die( 0 );
 }
 
+/**
+ * Ajax handler for sending a post to the trash.
+ *
+ * @since 3.1.0
+ *
+ * @param string $action Action to perform.
+ */
 function wp_ajax_trash_post( $action ) {
        if ( empty( $action ) )
                $action = 'trash-post';
 function wp_ajax_trash_post( $action ) {
        if ( empty( $action ) )
                $action = 'trash-post';
@@ -492,12 +658,24 @@ function wp_ajax_trash_post( $action ) {
        wp_die( 0 );
 }
 
        wp_die( 0 );
 }
 
+/**
+ * Ajax handler to restore a post from the trash.
+ *
+ * @since 3.1.0
+ *
+ * @param string $action Action to perform.
+ */
 function wp_ajax_untrash_post( $action ) {
        if ( empty( $action ) )
                $action = 'untrash-post';
        wp_ajax_trash_post( $action );
 }
 
 function wp_ajax_untrash_post( $action ) {
        if ( empty( $action ) )
                $action = 'untrash-post';
        wp_ajax_trash_post( $action );
 }
 
+/**
+ * @since 3.1.0
+ *
+ * @param string $action
+ */
 function wp_ajax_delete_page( $action ) {
        if ( empty( $action ) )
                $action = 'delete-page';
 function wp_ajax_delete_page( $action ) {
        if ( empty( $action ) )
                $action = 'delete-page';
@@ -516,6 +694,11 @@ function wp_ajax_delete_page( $action ) {
                wp_die( 0 );
 }
 
                wp_die( 0 );
 }
 
+/**
+ * Ajax handler to dim a comment.
+ *
+ * @since 3.1.0
+ */
 function wp_ajax_dim_comment() {
        $id = isset( $_POST['id'] ) ? (int) $_POST['id'] : 0;
 
 function wp_ajax_dim_comment() {
        $id = isset( $_POST['id'] ) ? (int) $_POST['id'] : 0;
 
@@ -531,7 +714,7 @@ function wp_ajax_dim_comment() {
                wp_die( -1 );
 
        $current = wp_get_comment_status( $comment->comment_ID );
                wp_die( -1 );
 
        $current = wp_get_comment_status( $comment->comment_ID );
-       if ( $_POST['new'] == $current )
+       if ( isset( $_POST['new'] ) && $_POST['new'] == $current )
                wp_die( time() );
 
        check_ajax_referer( "approve-comment_$id" );
                wp_die( time() );
 
        check_ajax_referer( "approve-comment_$id" );
@@ -553,13 +736,20 @@ function wp_ajax_dim_comment() {
        wp_die( 0 );
 }
 
        wp_die( 0 );
 }
 
+/**
+ * Ajax handler for deleting a link category.
+ *
+ * @since 3.1.0
+ *
+ * @param string $action Action to perform.
+ */
 function wp_ajax_add_link_category( $action ) {
        if ( empty( $action ) )
                $action = 'add-link-category';
        check_ajax_referer( $action );
        if ( !current_user_can( 'manage_categories' ) )
                wp_die( -1 );
 function wp_ajax_add_link_category( $action ) {
        if ( empty( $action ) )
                $action = 'add-link-category';
        check_ajax_referer( $action );
        if ( !current_user_can( 'manage_categories' ) )
                wp_die( -1 );
-       $names = explode(',', $_POST['newcat']);
+       $names = explode(',', wp_unslash( $_POST['newcat'] ) );
        $x = new WP_Ajax_Response();
        foreach ( $names as $cat_name ) {
                $cat_name = trim($cat_name);
        $x = new WP_Ajax_Response();
        foreach ( $names as $cat_name ) {
                $cat_name = trim($cat_name);
@@ -568,11 +758,12 @@ function wp_ajax_add_link_category( $action ) {
                        continue;
                if ( !$cat_id = term_exists( $cat_name, 'link_category' ) )
                        $cat_id = wp_insert_term( $cat_name, 'link_category' );
                        continue;
                if ( !$cat_id = term_exists( $cat_name, 'link_category' ) )
                        $cat_id = wp_insert_term( $cat_name, 'link_category' );
-               if ( is_wp_error( $cat_id ) )
+               if ( is_wp_error( $cat_id ) ) {
                        continue;
                        continue;
-               else if ( is_array( $cat_id ) )
+               } elseif ( is_array( $cat_id ) ) {
                        $cat_id = $cat_id['term_id'];
                        $cat_id = $cat_id['term_id'];
-               $cat_name = esc_html(stripslashes($cat_name));
+               }
+               $cat_name = esc_html( $cat_name );
                $x->add( array(
                        'what' => 'link-category',
                        'id' => $cat_id,
                $x->add( array(
                        'what' => 'link-category',
                        'id' => $cat_id,
@@ -583,11 +774,17 @@ function wp_ajax_add_link_category( $action ) {
        $x->send();
 }
 
        $x->send();
 }
 
+/**
+ * Ajax handler to add a tag.
+ *
+ * @since 3.1.0
+ *
+ * @global WP_List_Table $wp_list_table
+ */
 function wp_ajax_add_tag() {
        global $wp_list_table;
 
        check_ajax_referer( 'add-tag', '_wpnonce_add-tag' );
 function wp_ajax_add_tag() {
        global $wp_list_table;
 
        check_ajax_referer( 'add-tag', '_wpnonce_add-tag' );
-       $post_type = !empty($_POST['post_type']) ? $_POST['post_type'] : 'post';
        $taxonomy = !empty($_POST['taxonomy']) ? $_POST['taxonomy'] : 'post_tag';
        $tax = get_taxonomy($taxonomy);
 
        $taxonomy = !empty($_POST['taxonomy']) ? $_POST['taxonomy'] : 'post_tag';
        $tax = get_taxonomy($taxonomy);
 
@@ -614,7 +811,7 @@ function wp_ajax_add_tag() {
 
        $level = 0;
        if ( is_taxonomy_hierarchical($taxonomy) ) {
 
        $level = 0;
        if ( is_taxonomy_hierarchical($taxonomy) ) {
-               $level = count( get_ancestors( $tag->term_id, $taxonomy ) );
+               $level = count( get_ancestors( $tag->term_id, $taxonomy, 'taxonomy' ) );
                ob_start();
                $wp_list_table->single_row( $tag, $level );
                $noparents = ob_get_clean();
                ob_start();
                $wp_list_table->single_row( $tag, $level );
                $noparents = ob_get_clean();
@@ -627,31 +824,39 @@ function wp_ajax_add_tag() {
        $x->add( array(
                'what' => 'taxonomy',
                'supplemental' => compact('parents', 'noparents')
        $x->add( array(
                'what' => 'taxonomy',
                'supplemental' => compact('parents', 'noparents')
-               ) );
+       ) );
        $x->add( array(
                'what' => 'term',
                'position' => $level,
                'supplemental' => (array) $tag
        $x->add( array(
                'what' => 'term',
                'position' => $level,
                'supplemental' => (array) $tag
-               ) );
+       ) );
        $x->send();
 }
 
        $x->send();
 }
 
+/**
+ * Ajax handler for getting a tagcloud.
+ *
+ * @since 3.1.0
+ */
 function wp_ajax_get_tagcloud() {
 function wp_ajax_get_tagcloud() {
-       if ( isset( $_POST['tax'] ) ) {
-               $taxonomy = sanitize_key( $_POST['tax'] );
-               $tax = get_taxonomy( $taxonomy );
-               if ( ! $tax )
-                       wp_die( 0 );
-               if ( ! current_user_can( $tax->cap->assign_terms ) )
-                       wp_die( -1 );
-       } else {
+       if ( ! isset( $_POST['tax'] ) ) {
+               wp_die( 0 );
+       }
+
+       $taxonomy = sanitize_key( $_POST['tax'] );
+       $tax = get_taxonomy( $taxonomy );
+       if ( ! $tax ) {
                wp_die( 0 );
        }
 
                wp_die( 0 );
        }
 
+       if ( ! current_user_can( $tax->cap->assign_terms ) ) {
+               wp_die( -1 );
+       }
+
        $tags = get_terms( $taxonomy, array( 'number' => 45, 'orderby' => 'count', 'order' => 'DESC' ) );
 
        if ( empty( $tags ) )
        $tags = get_terms( $taxonomy, array( 'number' => 45, 'orderby' => 'count', 'order' => 'DESC' ) );
 
        if ( empty( $tags ) )
-               wp_die( isset( $tax->no_tagcloud ) ? $tax->no_tagcloud : __('No tags found!') );
+               wp_die( $tax->labels->not_found );
 
        if ( is_wp_error( $tags ) )
                wp_die( $tags->get_error_message() );
 
        if ( is_wp_error( $tags ) )
                wp_die( $tags->get_error_message() );
@@ -672,6 +877,16 @@ function wp_ajax_get_tagcloud() {
        wp_die();
 }
 
        wp_die();
 }
 
+/**
+ * Ajax handler for getting comments.
+ *
+ * @since 3.1.0
+ *
+ * @global WP_List_Table $wp_list_table
+ * @global int           $post_id
+ *
+ * @param string $action Action to perform.
+ */
 function wp_ajax_get_comments( $action ) {
        global $wp_list_table, $post_id;
        if ( empty( $action ) )
 function wp_ajax_get_comments( $action ) {
        global $wp_list_table, $post_id;
        if ( empty( $action ) )
@@ -679,9 +894,18 @@ function wp_ajax_get_comments( $action ) {
 
        check_ajax_referer( $action );
 
 
        check_ajax_referer( $action );
 
+       if ( empty( $post_id ) && ! empty( $_REQUEST['p'] ) ) {
+               $id = absint( $_REQUEST['p'] );
+               if ( ! empty( $id ) )
+                       $post_id = $id;
+       }
+
+       if ( empty( $post_id ) )
+               wp_die( -1 );
+
        $wp_list_table = _get_list_table( 'WP_Post_Comments_List_Table', array( 'screen' => 'edit-comments' ) );
 
        $wp_list_table = _get_list_table( 'WP_Post_Comments_List_Table', array( 'screen' => 'edit-comments' ) );
 
-       if ( !current_user_can( 'edit_post', $post_id ) )
+       if ( ! current_user_can( 'edit_post', $post_id ) )
                wp_die( -1 );
 
        $wp_list_table->prepare_items();
                wp_die( -1 );
 
        $wp_list_table->prepare_items();
@@ -697,8 +921,7 @@ function wp_ajax_get_comments( $action ) {
                get_comment( $comment );
                $wp_list_table->single_row( $comment );
        }
                get_comment( $comment );
                $wp_list_table->single_row( $comment );
        }
-       $comment_list_item = ob_get_contents();
-       ob_end_clean();
+       $comment_list_item = ob_get_clean();
 
        $x->add( array(
                'what' => 'comments',
 
        $x->add( array(
                'what' => 'comments',
@@ -707,32 +930,47 @@ function wp_ajax_get_comments( $action ) {
        $x->send();
 }
 
        $x->send();
 }
 
+/**
+ * Ajax handler for replying to a comment.
+ *
+ * @since 3.1.0
+ *
+ * @global WP_List_Table $wp_list_table
+ *
+ * @param string $action Action to perform.
+ */
 function wp_ajax_replyto_comment( $action ) {
 function wp_ajax_replyto_comment( $action ) {
-       global $wp_list_table, $wpdb;
+       global $wp_list_table;
        if ( empty( $action ) )
                $action = 'replyto-comment';
 
        check_ajax_referer( $action, '_ajax_nonce-replyto-comment' );
 
        $comment_post_ID = (int) $_POST['comment_post_ID'];
        if ( empty( $action ) )
                $action = 'replyto-comment';
 
        check_ajax_referer( $action, '_ajax_nonce-replyto-comment' );
 
        $comment_post_ID = (int) $_POST['comment_post_ID'];
-       if ( !current_user_can( 'edit_post', $comment_post_ID ) )
+       $post = get_post( $comment_post_ID );
+       if ( ! $post )
                wp_die( -1 );
 
                wp_die( -1 );
 
-       $status = $wpdb->get_var( $wpdb->prepare("SELECT post_status FROM $wpdb->posts WHERE ID = %d", $comment_post_ID) );
+       if ( !current_user_can( 'edit_post', $comment_post_ID ) )
+               wp_die( -1 );
 
 
-       if ( empty($status) )
+       if ( empty( $post->post_status ) )
                wp_die( 1 );
                wp_die( 1 );
-       elseif ( in_array($status, array('draft', 'pending', 'trash') ) )
+       elseif ( in_array($post->post_status, array('draft', 'pending', 'trash') ) )
                wp_die( __('ERROR: you are replying to a comment on a draft post.') );
 
        $user = wp_get_current_user();
        if ( $user->exists() ) {
                $user_ID = $user->ID;
                wp_die( __('ERROR: you are replying to a comment on a draft post.') );
 
        $user = wp_get_current_user();
        if ( $user->exists() ) {
                $user_ID = $user->ID;
-               $comment_author       = $wpdb->escape($user->display_name);
-               $comment_author_email = $wpdb->escape($user->user_email);
-               $comment_author_url   = $wpdb->escape($user->user_url);
-               $comment_content      = trim($_POST['content']);
+               $comment_author       = wp_slash( $user->display_name );
+               $comment_author_email = wp_slash( $user->user_email );
+               $comment_author_url   = wp_slash( $user->user_url );
+               $comment_content      = trim( $_POST['content'] );
+               $comment_type         = isset( $_POST['comment_type'] ) ? trim( $_POST['comment_type'] ) : '';
                if ( current_user_can( 'unfiltered_html' ) ) {
                if ( current_user_can( 'unfiltered_html' ) ) {
+                       if ( ! isset( $_POST['_wp_unfiltered_html_comment'] ) )
+                               $_POST['_wp_unfiltered_html_comment'] = '';
+
                        if ( wp_create_nonce( 'unfiltered-html-comment' ) != $_POST['_wp_unfiltered_html_comment'] ) {
                                kses_remove_filters(); // start with a clean slate
                                kses_init_filters(); // set up the filters
                        if ( wp_create_nonce( 'unfiltered-html-comment' ) != $_POST['_wp_unfiltered_html_comment'] ) {
                                kses_remove_filters(); // start with a clean slate
                                kses_init_filters(); // set up the filters
@@ -745,11 +983,13 @@ function wp_ajax_replyto_comment( $action ) {
        if ( '' == $comment_content )
                wp_die( __( 'ERROR: please type a comment.' ) );
 
        if ( '' == $comment_content )
                wp_die( __( 'ERROR: please type a comment.' ) );
 
-       $comment_parent = absint($_POST['comment_ID']);
+       $comment_parent = 0;
+       if ( isset( $_POST['comment_ID'] ) )
+               $comment_parent = absint( $_POST['comment_ID'] );
        $comment_auto_approved = false;
        $commentdata = compact('comment_post_ID', 'comment_author', 'comment_author_email', 'comment_author_url', 'comment_content', 'comment_type', 'comment_parent', 'user_ID');
 
        $comment_auto_approved = false;
        $commentdata = compact('comment_post_ID', 'comment_author', 'comment_author_email', 'comment_author_url', 'comment_content', 'comment_type', 'comment_parent', 'user_ID');
 
-       // automatically approve parent comment
+       // Automatically approve parent comment.
        if ( !empty($_POST['approve_parent']) ) {
                $parent = get_comment( $comment_parent );
 
        if ( !empty($_POST['approve_parent']) ) {
                $parent = get_comment( $comment_parent );
 
@@ -766,19 +1006,18 @@ function wp_ajax_replyto_comment( $action ) {
        $position = ( isset($_POST['position']) && (int) $_POST['position'] ) ? (int) $_POST['position'] : '-1';
 
        ob_start();
        $position = ( isset($_POST['position']) && (int) $_POST['position'] ) ? (int) $_POST['position'] : '-1';
 
        ob_start();
-               if ( 'dashboard' == $_REQUEST['mode'] ) {
-                       require_once( ABSPATH . 'wp-admin/includes/dashboard.php' );
-                       _wp_dashboard_recent_comments_row( $comment );
+       if ( isset( $_REQUEST['mode'] ) && 'dashboard' == $_REQUEST['mode'] ) {
+               require_once( ABSPATH . 'wp-admin/includes/dashboard.php' );
+               _wp_dashboard_recent_comments_row( $comment );
+       } else {
+               if ( isset( $_REQUEST['mode'] ) && 'single' == $_REQUEST['mode'] ) {
+                       $wp_list_table = _get_list_table('WP_Post_Comments_List_Table', array( 'screen' => 'edit-comments' ) );
                } else {
                } else {
-                       if ( 'single' == $_REQUEST['mode'] ) {
-                               $wp_list_table = _get_list_table('WP_Post_Comments_List_Table', array( 'screen' => 'edit-comments' ) );
-                       } else {
-                               $wp_list_table = _get_list_table('WP_Comments_List_Table', array( 'screen' => 'edit-comments' ) );
-                       }
-                       $wp_list_table->single_row( $comment );
+                       $wp_list_table = _get_list_table('WP_Comments_List_Table', array( 'screen' => 'edit-comments' ) );
                }
                }
-               $comment_list_item = ob_get_contents();
-       ob_end_clean();
+               $wp_list_table->single_row( $comment );
+       }
+       $comment_list_item = ob_get_clean();
 
        $response =  array(
                'what' => 'comment',
 
        $response =  array(
                'what' => 'comment',
@@ -795,6 +1034,13 @@ function wp_ajax_replyto_comment( $action ) {
        $x->send();
 }
 
        $x->send();
 }
 
+/**
+ * Ajax handler for editing a comment.
+ *
+ * @since 3.1.0
+ *
+ * @global WP_List_Table $wp_list_table
+ */
 function wp_ajax_edit_comment() {
        global $wp_list_table;
 
 function wp_ajax_edit_comment() {
        global $wp_list_table;
 
@@ -807,21 +1053,21 @@ function wp_ajax_edit_comment() {
        if ( '' == $_POST['content'] )
                wp_die( __( 'ERROR: please type a comment.' ) );
 
        if ( '' == $_POST['content'] )
                wp_die( __( 'ERROR: please type a comment.' ) );
 
-       $_POST['comment_status'] = $_POST['status'];
+       if ( isset( $_POST['status'] ) )
+               $_POST['comment_status'] = $_POST['status'];
        edit_comment();
 
        $position = ( isset($_POST['position']) && (int) $_POST['position']) ? (int) $_POST['position'] : '-1';
        edit_comment();
 
        $position = ( isset($_POST['position']) && (int) $_POST['position']) ? (int) $_POST['position'] : '-1';
-       $comments_status = isset($_POST['comments_listing']) ? $_POST['comments_listing'] : '';
-
        $checkbox = ( isset($_POST['checkbox']) && true == $_POST['checkbox'] ) ? 1 : 0;
        $wp_list_table = _get_list_table( $checkbox ? 'WP_Comments_List_Table' : 'WP_Post_Comments_List_Table', array( 'screen' => 'edit-comments' ) );
 
        $comment = get_comment( $comment_id );
        $checkbox = ( isset($_POST['checkbox']) && true == $_POST['checkbox'] ) ? 1 : 0;
        $wp_list_table = _get_list_table( $checkbox ? 'WP_Comments_List_Table' : 'WP_Post_Comments_List_Table', array( 'screen' => 'edit-comments' ) );
 
        $comment = get_comment( $comment_id );
+       if ( empty( $comment->comment_ID ) )
+               wp_die( -1 );
 
        ob_start();
 
        ob_start();
-               $wp_list_table->single_row( $comment );
-               $comment_list_item = ob_get_contents();
-       ob_end_clean();
+       $wp_list_table->single_row( $comment );
+       $comment_list_item = ob_get_clean();
 
        $x = new WP_Ajax_Response();
 
 
        $x = new WP_Ajax_Response();
 
@@ -835,6 +1081,11 @@ function wp_ajax_edit_comment() {
        $x->send();
 }
 
        $x->send();
 }
 
+/**
+ * Ajax handler for adding a menu item.
+ *
+ * @since 3.1.0
+ */
 function wp_ajax_add_menu_item() {
        check_ajax_referer( 'add-menu_item', 'menu-settings-column-nonce' );
 
 function wp_ajax_add_menu_item() {
        check_ajax_referer( 'add-menu_item', 'menu-settings-column-nonce' );
 
@@ -864,7 +1115,7 @@ function wp_ajax_add_menu_item() {
                        }
 
                        $_menu_items = array_map( 'wp_setup_nav_menu_item', array( $_object ) );
                        }
 
                        $_menu_items = array_map( 'wp_setup_nav_menu_item', array( $_object ) );
-                       $_menu_item = array_shift( $_menu_items );
+                       $_menu_item = reset( $_menu_items );
 
                        // Restore the missing menu item properties
                        $menu_item_data['menu-item-description'] = $_menu_item->description;
 
                        // Restore the missing menu item properties
                        $menu_item_data['menu-item-description'] = $_menu_item->description;
@@ -888,6 +1139,7 @@ function wp_ajax_add_menu_item() {
                }
        }
 
                }
        }
 
+       /** This filter is documented in wp-admin/includes/nav-menu.php */
        $walker_class_name = apply_filters( 'wp_edit_nav_menu_walker', 'Walker_Nav_Menu_Edit', $_POST['menu'] );
 
        if ( ! class_exists( $walker_class_name ) )
        $walker_class_name = apply_filters( 'wp_edit_nav_menu_walker', 'Walker_Nav_Menu_Edit', $_POST['menu'] );
 
        if ( ! class_exists( $walker_class_name ) )
@@ -903,8 +1155,14 @@ function wp_ajax_add_menu_item() {
                );
                echo walk_nav_menu_tree( $menu_items, 0, (object) $args );
        }
                );
                echo walk_nav_menu_tree( $menu_items, 0, (object) $args );
        }
+       wp_die();
 }
 
 }
 
+/**
+ * Ajax handler for adding meta.
+ *
+ * @since 3.1.0
+ */
 function wp_ajax_add_meta() {
        check_ajax_referer( 'add-meta', '_ajax_nonce-add-meta' );
        $c = 0;
 function wp_ajax_add_meta() {
        check_ajax_referer( 'add-meta', '_ajax_nonce-add-meta' );
        $c = 0;
@@ -916,6 +1174,8 @@ function wp_ajax_add_meta() {
                        wp_die( -1 );
                if ( isset($_POST['metakeyselect']) && '#NONE#' == $_POST['metakeyselect'] && empty($_POST['metakeyinput']) )
                        wp_die( 1 );
                        wp_die( -1 );
                if ( isset($_POST['metakeyselect']) && '#NONE#' == $_POST['metakeyselect'] && empty($_POST['metakeyinput']) )
                        wp_die( 1 );
+
+               // If the post is an autodraft, save the post as a draft and then attempt to save the meta.
                if ( $post->post_status == 'auto-draft' ) {
                        $save_POST = $_POST; // Backup $_POST
                        $_POST = array(); // Make it empty for edit_post()
                if ( $post->post_status == 'auto-draft' ) {
                        $save_POST = $_POST; // Backup $_POST
                        $_POST = array(); // Make it empty for edit_post()
@@ -924,7 +1184,7 @@ function wp_ajax_add_meta() {
                        $_POST['post_type'] = $post->post_type;
                        $_POST['post_status'] = 'draft';
                        $now = current_time('timestamp', 1);
                        $_POST['post_type'] = $post->post_type;
                        $_POST['post_status'] = 'draft';
                        $now = current_time('timestamp', 1);
-                       $_POST['post_title'] = sprintf('Draft created on %s at %s', date(get_option('date_format'), $now), date(get_option('time_format'), $now));
+                       $_POST['post_title'] = sprintf( __( 'Draft created on %1$s at %2$s' ), date( get_option( 'date_format' ), $now ), date( get_option( 'time_format' ), $now ) );
 
                        if ( $pid = edit_post() ) {
                                if ( is_wp_error( $pid ) ) {
 
                        if ( $pid = edit_post() ) {
                                if ( is_wp_error( $pid ) ) {
@@ -940,7 +1200,7 @@ function wp_ajax_add_meta() {
                        } else {
                                wp_die( 0 );
                        }
                        } else {
                                wp_die( 0 );
                        }
-               } else if ( !$mid = add_meta( $pid ) ) {
+               } elseif ( ! $mid = add_meta( $pid ) ) {
                        wp_die( __( 'Please provide a custom field value.' ) );
                }
 
                        wp_die( __( 'Please provide a custom field value.' ) );
                }
 
@@ -956,8 +1216,8 @@ function wp_ajax_add_meta() {
                ) );
        } else { // Update?
                $mid = (int) key( $_POST['meta'] );
                ) );
        } else { // Update?
                $mid = (int) key( $_POST['meta'] );
-               $key = stripslashes( $_POST['meta'][$mid]['key'] );
-               $value = stripslashes( $_POST['meta'][$mid]['value'] );
+               $key = wp_unslash( $_POST['meta'][$mid]['key'] );
+               $value = wp_unslash( $_POST['meta'][$mid]['value'] );
                if ( '' == trim($key) )
                        wp_die( __( 'Please provide a custom field name.' ) );
                if ( '' == trim($value) )
                if ( '' == trim($key) )
                        wp_die( __( 'Please provide a custom field name.' ) );
                if ( '' == trim($value) )
@@ -988,6 +1248,15 @@ function wp_ajax_add_meta() {
        $x->send();
 }
 
        $x->send();
 }
 
+/**
+ * Ajax handler for adding a user.
+ *
+ * @since 3.1.0
+ *
+ * @global WP_List_Table $wp_list_table
+ *
+ * @param string $action Action to perform.
+ */
 function wp_ajax_add_user( $action ) {
        global $wp_list_table;
        if ( empty( $action ) )
 function wp_ajax_add_user( $action ) {
        global $wp_list_table;
        if ( empty( $action ) )
@@ -1023,107 +1292,11 @@ function wp_ajax_add_user( $action ) {
        $x->send();
 }
 
        $x->send();
 }
 
-function wp_ajax_autosave() {
-       global $login_grace_period;
-
-       define( 'DOING_AUTOSAVE', true );
-
-       $nonce_age = check_ajax_referer( 'autosave', 'autosavenonce' );
-
-       $_POST['post_category'] = explode(",", $_POST['catslist']);
-       if ( $_POST['post_type'] == 'page' || empty($_POST['post_category']) )
-               unset($_POST['post_category']);
-
-       $do_autosave = (bool) $_POST['autosave'];
-       $do_lock = true;
-
-       $data = $alert = '';
-       /* translators: draft saved date format, see http://php.net/date */
-       $draft_saved_date_format = __('g:i:s a');
-       /* translators: %s: date and time */
-       $message = sprintf( __('Draft saved at %s.'), date_i18n( $draft_saved_date_format ) );
-
-       $supplemental = array();
-       if ( isset($login_grace_period) )
-               $alert .= sprintf( __('Your login has expired. Please open a new browser window and <a href="%s" target="_blank">log in again</a>. '), add_query_arg( 'interim-login', 1, wp_login_url() ) );
-
-       $id = $revision_id = 0;
-
-       $post_ID = (int) $_POST['post_ID'];
-       $_POST['ID'] = $post_ID;
-       $post = get_post($post_ID);
-       if ( 'auto-draft' == $post->post_status )
-               $_POST['post_status'] = 'draft';
-
-       if ( $last = wp_check_post_lock( $post->ID ) ) {
-               $do_autosave = $do_lock = false;
-
-               $last_user = get_userdata( $last );
-               $last_user_name = $last_user ? $last_user->display_name : __( 'Someone' );
-               $data = __( 'Autosave disabled.' );
-
-               $supplemental['disable_autosave'] = 'disable';
-               $alert .= sprintf( __( '%s is currently editing this article. If you update it, you will overwrite the changes.' ), esc_html( $last_user_name ) );
-       }
-
-       if ( 'page' == $post->post_type ) {
-               if ( !current_user_can('edit_page', $post_ID) )
-                       wp_die( __( 'You are not allowed to edit this page.' ) );
-       } else {
-               if ( !current_user_can('edit_post', $post_ID) )
-                       wp_die( __( 'You are not allowed to edit this post.' ) );
-       }
-
-       if ( $do_autosave ) {
-               // Drafts and auto-drafts are just overwritten by autosave
-               if ( 'auto-draft' == $post->post_status || 'draft' == $post->post_status ) {
-                       $id = edit_post();
-               } else { // Non drafts are not overwritten. The autosave is stored in a special post revision.
-                       $revision_id = wp_create_post_autosave( $post->ID );
-                       if ( is_wp_error($revision_id) )
-                               $id = $revision_id;
-                       else
-                               $id = $post->ID;
-               }
-               $data = $message;
-       } else {
-               if ( ! empty( $_POST['auto_draft'] ) )
-                       $id = 0; // This tells us it didn't actually save
-               else
-                       $id = $post->ID;
-       }
-
-       if ( $do_lock && empty( $_POST['auto_draft'] ) && $id && is_numeric( $id ) ) {
-               $lock_result = wp_set_post_lock( $id );
-               $supplemental['active-post-lock'] = implode( ':', $lock_result );
-       }
-
-       if ( $nonce_age == 2 ) {
-               $supplemental['replace-autosavenonce'] = wp_create_nonce('autosave');
-               $supplemental['replace-getpermalinknonce'] = wp_create_nonce('getpermalink');
-               $supplemental['replace-samplepermalinknonce'] = wp_create_nonce('samplepermalink');
-               $supplemental['replace-closedpostboxesnonce'] = wp_create_nonce('closedpostboxes');
-               $supplemental['replace-_ajax_linking_nonce'] = wp_create_nonce( 'internal-linking' );
-               if ( $id ) {
-                       if ( $_POST['post_type'] == 'post' )
-                               $supplemental['replace-_wpnonce'] = wp_create_nonce('update-post_' . $id);
-                       elseif ( $_POST['post_type'] == 'page' )
-                               $supplemental['replace-_wpnonce'] = wp_create_nonce('update-page_' . $id);
-               }
-       }
-
-       if ( ! empty($alert) )
-               $supplemental['alert'] = $alert;
-
-       $x = new WP_Ajax_Response( array(
-               'what' => 'autosave',
-               'id' => $id,
-               'data' => $id ? $data : '',
-               'supplemental' => $supplemental
-       ) );
-       $x->send();
-}
-
+/**
+ * Ajax handler for closed post boxes.
+ *
+ * @since 3.1.0
+ */
 function wp_ajax_closed_postboxes() {
        check_ajax_referer( 'closedpostboxes', 'closedpostboxesnonce' );
        $closed = isset( $_POST['closed'] ) ? explode( ',', $_POST['closed']) : array();
 function wp_ajax_closed_postboxes() {
        check_ajax_referer( 'closedpostboxes', 'closedpostboxesnonce' );
        $closed = isset( $_POST['closed'] ) ? explode( ',', $_POST['closed']) : array();
@@ -1151,10 +1324,13 @@ function wp_ajax_closed_postboxes() {
        wp_die( 1 );
 }
 
        wp_die( 1 );
 }
 
+/**
+ * Ajax handler for hidden columns.
+ *
+ * @since 3.1.0
+ */
 function wp_ajax_hidden_columns() {
        check_ajax_referer( 'screen-options-nonce', 'screenoptionnonce' );
 function wp_ajax_hidden_columns() {
        check_ajax_referer( 'screen-options-nonce', 'screenoptionnonce' );
-       $hidden = isset( $_POST['hidden'] ) ? $_POST['hidden'] : '';
-       $hidden = explode( ',', $_POST['hidden'] );
        $page = isset( $_POST['page'] ) ? $_POST['page'] : '';
 
        if ( $page != sanitize_key( $page ) )
        $page = isset( $_POST['page'] ) ? $_POST['page'] : '';
 
        if ( $page != sanitize_key( $page ) )
@@ -1163,12 +1339,17 @@ function wp_ajax_hidden_columns() {
        if ( ! $user = wp_get_current_user() )
                wp_die( -1 );
 
        if ( ! $user = wp_get_current_user() )
                wp_die( -1 );
 
-       if ( is_array($hidden) )
-               update_user_option($user->ID, "manage{$page}columnshidden", $hidden, true);
+       $hidden = ! empty( $_POST['hidden'] ) ? explode( ',', $_POST['hidden'] ) : array();
+       update_user_option( $user->ID, "manage{$page}columnshidden", $hidden, true );
 
        wp_die( 1 );
 }
 
 
        wp_die( 1 );
 }
 
+/**
+ * Ajax handler for updating whether to display the welcome panel.
+ *
+ * @since 3.1.0
+ */
 function wp_ajax_update_welcome_panel() {
        check_ajax_referer( 'welcome-panel-nonce', 'welcomepanelnonce' );
 
 function wp_ajax_update_welcome_panel() {
        check_ajax_referer( 'welcome-panel-nonce', 'welcomepanelnonce' );
 
@@ -1180,6 +1361,11 @@ function wp_ajax_update_welcome_panel() {
        wp_die( 1 );
 }
 
        wp_die( 1 );
 }
 
+/**
+ * Ajax handler for retrieving menu meta boxes.
+ *
+ * @since 3.1.0
+ */
 function wp_ajax_menu_get_metabox() {
        if ( ! current_user_can( 'edit_theme_options' ) )
                wp_die( -1 );
 function wp_ajax_menu_get_metabox() {
        if ( ! current_user_can( 'edit_theme_options' ) )
                wp_die( -1 );
@@ -1197,7 +1383,10 @@ function wp_ajax_menu_get_metabox() {
        }
 
        if ( ! empty( $_POST['item-object'] ) && isset( $items[$_POST['item-object']] ) ) {
        }
 
        if ( ! empty( $_POST['item-object'] ) && isset( $items[$_POST['item-object']] ) ) {
-               $item = apply_filters( 'nav_menu_meta_box_object', $items[ $_POST['item-object'] ] );
+               $menus_meta_box_object = $items[ $_POST['item-object'] ];
+
+               /** This filter is documented in wp-admin/includes/nav-menu.php */
+               $item = apply_filters( 'nav_menu_meta_box_object', $menus_meta_box_object );
                ob_start();
                call_user_func_array($callback, array(
                        null,
                ob_start();
                call_user_func_array($callback, array(
                        null,
@@ -1211,7 +1400,7 @@ function wp_ajax_menu_get_metabox() {
 
                $markup = ob_get_clean();
 
 
                $markup = ob_get_clean();
 
-               echo json_encode(array(
+               echo wp_json_encode(array(
                        'replace-id' => $type . '-' . $item->name,
                        'markup' => $markup,
                ));
                        'replace-id' => $type . '-' . $item->name,
                        'markup' => $markup,
                ));
@@ -1220,13 +1409,18 @@ function wp_ajax_menu_get_metabox() {
        wp_die();
 }
 
        wp_die();
 }
 
+/**
+ * Ajax handler for internal linking.
+ *
+ * @since 3.1.0
+ */
 function wp_ajax_wp_link_ajax() {
        check_ajax_referer( 'internal-linking', '_ajax_linking_nonce' );
 
        $args = array();
 
        if ( isset( $_POST['search'] ) )
 function wp_ajax_wp_link_ajax() {
        check_ajax_referer( 'internal-linking', '_ajax_linking_nonce' );
 
        $args = array();
 
        if ( isset( $_POST['search'] ) )
-               $args['s'] = stripslashes( $_POST['search'] );
+               $args['s'] = wp_unslash( $_POST['search'] );
        $args['pagenum'] = ! empty( $_POST['page'] ) ? absint( $_POST['page'] ) : 1;
 
        require(ABSPATH . WPINC . '/class-wp-editor.php');
        $args['pagenum'] = ! empty( $_POST['page'] ) ? absint( $_POST['page'] ) : 1;
 
        require(ABSPATH . WPINC . '/class-wp-editor.php');
@@ -1235,12 +1429,17 @@ function wp_ajax_wp_link_ajax() {
        if ( ! isset( $results ) )
                wp_die( 0 );
 
        if ( ! isset( $results ) )
                wp_die( 0 );
 
-       echo json_encode( $results );
+       echo wp_json_encode( $results );
        echo "\n";
 
        wp_die();
 }
 
        echo "\n";
 
        wp_die();
 }
 
+/**
+ * Ajax handler for menu locations save.
+ *
+ * @since 3.1.0
+ */
 function wp_ajax_menu_locations_save() {
        if ( ! current_user_can( 'edit_theme_options' ) )
                wp_die( -1 );
 function wp_ajax_menu_locations_save() {
        if ( ! current_user_can( 'edit_theme_options' ) )
                wp_die( -1 );
@@ -1251,6 +1450,11 @@ function wp_ajax_menu_locations_save() {
        wp_die( 1 );
 }
 
        wp_die( 1 );
 }
 
+/**
+ * Ajax handler for saving the meta box order.
+ *
+ * @since 3.1.0
+ */
 function wp_ajax_meta_box_order() {
        check_ajax_referer( 'meta-box-order' );
        $order = isset( $_POST['order'] ) ? (array) $_POST['order'] : false;
 function wp_ajax_meta_box_order() {
        check_ajax_referer( 'meta-box-order' );
        $order = isset( $_POST['order'] ) ? (array) $_POST['order'] : false;
@@ -1276,6 +1480,11 @@ function wp_ajax_meta_box_order() {
        wp_die( 1 );
 }
 
        wp_die( 1 );
 }
 
+/**
+ * Ajax handler for menu quick searching.
+ *
+ * @since 3.1.0
+ */
 function wp_ajax_menu_quick_search() {
        if ( ! current_user_can( 'edit_theme_options' ) )
                wp_die( -1 );
 function wp_ajax_menu_quick_search() {
        if ( ! current_user_can( 'edit_theme_options' ) )
                wp_die( -1 );
@@ -1287,12 +1496,22 @@ function wp_ajax_menu_quick_search() {
        wp_die();
 }
 
        wp_die();
 }
 
+/**
+ * Ajax handler to retrieve a permalink.
+ *
+ * @since 3.1.0
+ */
 function wp_ajax_get_permalink() {
        check_ajax_referer( 'getpermalink', 'getpermalinknonce' );
        $post_id = isset($_POST['post_id'])? intval($_POST['post_id']) : 0;
        wp_die( add_query_arg( array( 'preview' => 'true' ), get_permalink( $post_id ) ) );
 }
 
 function wp_ajax_get_permalink() {
        check_ajax_referer( 'getpermalink', 'getpermalinknonce' );
        $post_id = isset($_POST['post_id'])? intval($_POST['post_id']) : 0;
        wp_die( add_query_arg( array( 'preview' => 'true' ), get_permalink( $post_id ) ) );
 }
 
+/**
+ * Ajax handler to retrieve a sample permalink.
+ *
+ * @since 3.1.0
+ */
 function wp_ajax_sample_permalink() {
        check_ajax_referer( 'samplepermalink', 'samplepermalinknonce' );
        $post_id = isset($_POST['post_id'])? intval($_POST['post_id']) : 0;
 function wp_ajax_sample_permalink() {
        check_ajax_referer( 'samplepermalink', 'samplepermalinknonce' );
        $post_id = isset($_POST['post_id'])? intval($_POST['post_id']) : 0;
@@ -1301,6 +1520,13 @@ function wp_ajax_sample_permalink() {
        wp_die( get_sample_permalink_html( $post_id, $title, $slug ) );
 }
 
        wp_die( get_sample_permalink_html( $post_id, $title, $slug ) );
 }
 
+/**
+ * Ajax handler for Quick Edit saving a post from a list table.
+ *
+ * @since 3.1.0
+ *
+ * @global WP_List_Table $wp_list_table
+ */
 function wp_ajax_inline_save() {
        global $wp_list_table;
 
 function wp_ajax_inline_save() {
        global $wp_list_table;
 
@@ -1327,35 +1553,54 @@ function wp_ajax_inline_save() {
        $data = &$_POST;
 
        $post = get_post( $post_ID, ARRAY_A );
        $data = &$_POST;
 
        $post = get_post( $post_ID, ARRAY_A );
-       $post = add_magic_quotes($post); //since it is from db
+
+       // Since it's coming from the database.
+       $post = wp_slash($post);
 
        $data['content'] = $post['post_content'];
        $data['excerpt'] = $post['post_excerpt'];
 
 
        $data['content'] = $post['post_content'];
        $data['excerpt'] = $post['post_excerpt'];
 
-       // rename
-       $data['user_ID'] = $GLOBALS['user_ID'];
+       // Rename.
+       $data['user_ID'] = get_current_user_id();
 
        if ( isset($data['post_parent']) )
                $data['parent_id'] = $data['post_parent'];
 
 
        if ( isset($data['post_parent']) )
                $data['parent_id'] = $data['post_parent'];
 
-       // status
-       if ( isset($data['keep_private']) && 'private' == $data['keep_private'] )
+       // Status.
+       if ( isset( $data['keep_private'] ) && 'private' == $data['keep_private'] ) {
+               $data['visibility']  = 'private';
                $data['post_status'] = 'private';
                $data['post_status'] = 'private';
-       else
+       } else {
                $data['post_status'] = $data['_status'];
                $data['post_status'] = $data['_status'];
+       }
 
        if ( empty($data['comment_status']) )
                $data['comment_status'] = 'closed';
        if ( empty($data['ping_status']) )
                $data['ping_status'] = 'closed';
 
 
        if ( empty($data['comment_status']) )
                $data['comment_status'] = 'closed';
        if ( empty($data['ping_status']) )
                $data['ping_status'] = 'closed';
 
-       // update the post
+       // Exclude terms from taxonomies that are not supposed to appear in Quick Edit.
+       if ( ! empty( $data['tax_input'] ) ) {
+               foreach ( $data['tax_input'] as $taxonomy => $terms ) {
+                       $tax_object = get_taxonomy( $taxonomy );
+                       /** This filter is documented in wp-admin/includes/class-wp-posts-list-table.php */
+                       if ( ! apply_filters( 'quick_edit_show_taxonomy', $tax_object->show_in_quick_edit, $taxonomy, $post['post_type'] ) ) {
+                               unset( $data['tax_input'][ $taxonomy ] );
+                       }
+               }
+       }
+
+       // Hack: wp_unique_post_slug() doesn't work for drafts, so we will fake that our post is published.
+       if ( ! empty( $data['post_name'] ) && in_array( $post['post_status'], array( 'draft', 'pending' ) ) ) {
+               $post['post_status'] = 'publish';
+               $data['post_name'] = wp_unique_post_slug( $data['post_name'], $post['ID'], $post['post_status'], $post['post_type'], $post['post_parent'] );
+       }
+
+       // Update the post.
        edit_post();
 
        $wp_list_table = _get_list_table( 'WP_Posts_List_Table', array( 'screen' => $_POST['screen'] ) );
 
        edit_post();
 
        $wp_list_table = _get_list_table( 'WP_Posts_List_Table', array( 'screen' => $_POST['screen'] ) );
 
-       $mode = $_POST['post_view'];
-
        $level = 0;
        $request_post = array( get_post( $_POST['post_ID'] ) );
        $parent = $request_post[0]->post_parent;
        $level = 0;
        $request_post = array( get_post( $_POST['post_ID'] ) );
        $parent = $request_post[0]->post_parent;
@@ -1371,6 +1616,13 @@ function wp_ajax_inline_save() {
        wp_die();
 }
 
        wp_die();
 }
 
+/**
+ * Ajax handler for quick edit saving for a term.
+ *
+ * @since 3.1.0
+ *
+ * @global WP_List_Table $wp_list_table
+ */
 function wp_ajax_inline_save_tax() {
        global $wp_list_table;
 
 function wp_ajax_inline_save_tax() {
        global $wp_list_table;
 
@@ -1412,20 +1664,24 @@ function wp_ajax_inline_save_tax() {
                $parent = $parent_tag->parent;
                $level++;
        }
                $parent = $parent_tag->parent;
                $level++;
        }
-       echo $wp_list_table->single_row( $tag, $level );
+       $wp_list_table->single_row( $tag, $level );
        wp_die();
 }
 
        wp_die();
 }
 
+/**
+ * Ajax handler for querying posts for the Find Posts modal.
+ *
+ * @see window.findPosts
+ *
+ * @since 3.1.0
+ */
 function wp_ajax_find_posts() {
 function wp_ajax_find_posts() {
-       global $wpdb;
-
        check_ajax_referer( 'find-posts' );
 
        $post_types = get_post_types( array( 'public' => true ), 'objects' );
        unset( $post_types['attachment'] );
 
        check_ajax_referer( 'find-posts' );
 
        $post_types = get_post_types( array( 'public' => true ), 'objects' );
        unset( $post_types['attachment'] );
 
-       $s = stripslashes( $_POST['ps'] );
-       $searchand = $search = '';
+       $s = wp_unslash( $_POST['ps'] );
        $args = array(
                'post_type' => array_keys( $post_types ),
                'post_status' => 'any',
        $args = array(
                'post_type' => array_keys( $post_types ),
                'post_status' => 'any',
@@ -1436,12 +1692,15 @@ function wp_ajax_find_posts() {
 
        $posts = get_posts( $args );
 
 
        $posts = get_posts( $args );
 
-       if ( ! $posts )
-               wp_die( __('No items found.') );
+       if ( ! $posts ) {
+               wp_send_json_error( __( 'No items found.' ) );
+       }
 
 
-       $html = '<table class="widefat" cellspacing="0"><thead><tr><th class="found-radio"><br /></th><th>'.__('Title').'</th><th class="no-break">'.__('Type').'</th><th class="no-break">'.__('Date').'</th><th class="no-break">'.__('Status').'</th></tr></thead><tbody>';
+       $html = '<table class="widefat"><thead><tr><th class="found-radio"><br /></th><th>'.__('Title').'</th><th class="no-break">'.__('Type').'</th><th class="no-break">'.__('Date').'</th><th class="no-break">'.__('Status').'</th></tr></thead><tbody>';
+       $alt = '';
        foreach ( $posts as $post ) {
                $title = trim( $post->post_title ) ? $post->post_title : __( '(no title)' );
        foreach ( $posts as $post ) {
                $title = trim( $post->post_title ) ? $post->post_title : __( '(no title)' );
+               $alt = ( 'alternate' == $alt ) ? '' : 'alternate';
 
                switch ( $post->post_status ) {
                        case 'publish' :
 
                switch ( $post->post_status ) {
                        case 'publish' :
@@ -1466,19 +1725,20 @@ function wp_ajax_find_posts() {
                        $time = mysql2date(__('Y/m/d'), $post->post_date);
                }
 
                        $time = mysql2date(__('Y/m/d'), $post->post_date);
                }
 
-               $html .= '<tr class="found-posts"><td class="found-radio"><input type="radio" id="found-'.$post->ID.'" name="found_post_id" value="' . esc_attr($post->ID) . '"></td>';
+               $html .= '<tr class="' . trim( 'found-posts ' . $alt ) . '"><td class="found-radio"><input type="radio" id="found-'.$post->ID.'" name="found_post_id" value="' . esc_attr($post->ID) . '"></td>';
                $html .= '<td><label for="found-'.$post->ID.'">' . esc_html( $title ) . '</label></td><td class="no-break">' . esc_html( $post_types[$post->post_type]->labels->singular_name ) . '</td><td class="no-break">'.esc_html( $time ) . '</td><td class="no-break">' . esc_html( $stat ). ' </td></tr>' . "\n\n";
        }
 
        $html .= '</tbody></table>';
 
                $html .= '<td><label for="found-'.$post->ID.'">' . esc_html( $title ) . '</label></td><td class="no-break">' . esc_html( $post_types[$post->post_type]->labels->singular_name ) . '</td><td class="no-break">'.esc_html( $time ) . '</td><td class="no-break">' . esc_html( $stat ). ' </td></tr>' . "\n\n";
        }
 
        $html .= '</tbody></table>';
 
-       $x = new WP_Ajax_Response();
-       $x->add( array(
-               'data' => $html
-       ));
-       $x->send();
+       wp_send_json_success( $html );
 }
 
 }
 
+/**
+ * Ajax handler for saving the widgets order.
+ *
+ * @since 3.1.0
+ */
 function wp_ajax_widgets_order() {
        check_ajax_referer( 'save-sidebar-widgets', 'savewidgets' );
 
 function wp_ajax_widgets_order() {
        check_ajax_referer( 'save-sidebar-widgets', 'savewidgets' );
 
@@ -1487,7 +1747,7 @@ function wp_ajax_widgets_order() {
 
        unset( $_POST['savewidgets'], $_POST['action'] );
 
 
        unset( $_POST['savewidgets'], $_POST['action'] );
 
-       // save widgets order for all sidebars
+       // Save widgets order for all sidebars.
        if ( is_array($_POST['sidebars']) ) {
                $sidebars = array();
                foreach ( $_POST['sidebars'] as $key => $val ) {
        if ( is_array($_POST['sidebars']) ) {
                $sidebars = array();
                foreach ( $_POST['sidebars'] as $key => $val ) {
@@ -1510,6 +1770,15 @@ function wp_ajax_widgets_order() {
        wp_die( -1 );
 }
 
        wp_die( -1 );
 }
 
+/**
+ * Ajax handler for saving a widget.
+ *
+ * @since 3.1.0
+ *
+ * @global array $wp_registered_widgets
+ * @global array $wp_registered_widget_controls
+ * @global array $wp_registered_widget_updates
+ */
 function wp_ajax_save_widget() {
        global $wp_registered_widgets, $wp_registered_widget_controls, $wp_registered_widget_updates;
 
 function wp_ajax_save_widget() {
        global $wp_registered_widgets, $wp_registered_widget_controls, $wp_registered_widget_updates;
 
@@ -1520,9 +1789,22 @@ function wp_ajax_save_widget() {
 
        unset( $_POST['savewidgets'], $_POST['action'] );
 
 
        unset( $_POST['savewidgets'], $_POST['action'] );
 
-       do_action('load-widgets.php');
-       do_action('widgets.php');
-       do_action('sidebar_admin_setup');
+       /**
+        * Fires early when editing the widgets displayed in sidebars.
+        *
+        * @since 2.8.0
+        */
+       do_action( 'load-widgets.php' );
+
+       /**
+        * Fires early when editing the widgets displayed in sidebars.
+        *
+        * @since 2.8.0
+        */
+       do_action( 'widgets.php' );
+
+       /** This action is documented in wp-admin/widgets.php */
+       do_action( 'sidebar_admin_setup' );
 
        $id_base = $_POST['id_base'];
        $widget_id = $_POST['widget-id'];
 
        $id_base = $_POST['id_base'];
        $widget_id = $_POST['widget-id'];
@@ -1534,7 +1816,7 @@ function wp_ajax_save_widget() {
        $sidebars = wp_get_sidebars_widgets();
        $sidebar = isset($sidebars[$sidebar_id]) ? $sidebars[$sidebar_id] : array();
 
        $sidebars = wp_get_sidebars_widgets();
        $sidebar = isset($sidebars[$sidebar_id]) ? $sidebars[$sidebar_id] : array();
 
-       // delete
+       // Delete.
        if ( isset($_POST['delete_widget']) && $_POST['delete_widget'] ) {
 
                if ( !isset($wp_registered_widgets[$widget_id]) )
        if ( isset($_POST['delete_widget']) && $_POST['delete_widget'] ) {
 
                if ( !isset($wp_registered_widgets[$widget_id]) )
@@ -1546,7 +1828,7 @@ function wp_ajax_save_widget() {
                if ( !$multi_number )
                        wp_die( $error );
 
                if ( !$multi_number )
                        wp_die( $error );
 
-               $_POST['widget-' . $id_base] = array( $multi_number => array_shift($settings) );
+               $_POST[ 'widget-' . $id_base ] = array( $multi_number => reset( $settings ) );
                $widget_id = $id_base . '-' . $multi_number;
                $sidebar[] = $widget_id;
        }
                $widget_id = $id_base . '-' . $multi_number;
                $sidebar[] = $widget_id;
        }
@@ -1581,16 +1863,56 @@ function wp_ajax_save_widget() {
        wp_die();
 }
 
        wp_die();
 }
 
+/**
+ * Ajax handler for saving a widget.
+ *
+ * @since 3.9.0
+ *
+ * @global WP_Customize_Manager $wp_customize
+ */
+function wp_ajax_update_widget() {
+       global $wp_customize;
+       $wp_customize->widgets->wp_ajax_update_widget();
+}
+
+/**
+ * Ajax handler for uploading attachments
+ *
+ * @since 3.3.0
+ */
 function wp_ajax_upload_attachment() {
        check_ajax_referer( 'media-form' );
 function wp_ajax_upload_attachment() {
        check_ajax_referer( 'media-form' );
+       /*
+        * This function does not use wp_send_json_success() / wp_send_json_error()
+        * as the html4 Plupload handler requires a text/html content-type for older IE.
+        * See https://core.trac.wordpress.org/ticket/31037
+        */
+
+       if ( ! current_user_can( 'upload_files' ) ) {
+               echo wp_json_encode( array(
+                       'success' => false,
+                       'data'    => array(
+                               'message'  => __( "You don't have permission to upload files." ),
+                               'filename' => $_FILES['async-upload']['name'],
+                       )
+               ) );
 
 
-       if ( ! current_user_can( 'upload_files' ) )
                wp_die();
                wp_die();
+       }
 
        if ( isset( $_REQUEST['post_id'] ) ) {
                $post_id = $_REQUEST['post_id'];
 
        if ( isset( $_REQUEST['post_id'] ) ) {
                $post_id = $_REQUEST['post_id'];
-               if ( ! current_user_can( 'edit_post', $post_id ) )
+               if ( ! current_user_can( 'edit_post', $post_id ) ) {
+                       echo wp_json_encode( array(
+                               'success' => false,
+                               'data'    => array(
+                                       'message'  => __( "You don't have permission to attach files to this post." ),
+                                       'filename' => $_FILES['async-upload']['name'],
+                               )
+                       ) );
+
                        wp_die();
                        wp_die();
+               }
        } else {
                $post_id = null;
        }
        } else {
                $post_id = null;
        }
@@ -1599,9 +1921,9 @@ function wp_ajax_upload_attachment() {
 
        // If the context is custom header or background, make sure the uploaded file is an image.
        if ( isset( $post_data['context'] ) && in_array( $post_data['context'], array( 'custom-header', 'custom-background' ) ) ) {
 
        // If the context is custom header or background, make sure the uploaded file is an image.
        if ( isset( $post_data['context'] ) && in_array( $post_data['context'], array( 'custom-header', 'custom-background' ) ) ) {
-               $wp_filetype = wp_check_filetype_and_ext( $_FILES['async-upload']['tmp_name'], $_FILES['async-upload']['name'], false );
+               $wp_filetype = wp_check_filetype_and_ext( $_FILES['async-upload']['tmp_name'], $_FILES['async-upload']['name'] );
                if ( ! wp_match_mime_types( 'image', $wp_filetype['type'] ) ) {
                if ( ! wp_match_mime_types( 'image', $wp_filetype['type'] ) ) {
-                       echo json_encode( array(
+                       echo wp_json_encode( array(
                                'success' => false,
                                'data'    => array(
                                        'message'  => __( 'The uploaded file is not a valid image. Please try again.' ),
                                'success' => false,
                                'data'    => array(
                                        'message'  => __( 'The uploaded file is not a valid image. Please try again.' ),
@@ -1616,7 +1938,7 @@ function wp_ajax_upload_attachment() {
        $attachment_id = media_handle_upload( 'async-upload', $post_id, $post_data );
 
        if ( is_wp_error( $attachment_id ) ) {
        $attachment_id = media_handle_upload( 'async-upload', $post_id, $post_data );
 
        if ( is_wp_error( $attachment_id ) ) {
-               echo json_encode( array(
+               echo wp_json_encode( array(
                        'success' => false,
                        'data'    => array(
                                'message'  => $attachment_id->get_error_message(),
                        'success' => false,
                        'data'    => array(
                                'message'  => $attachment_id->get_error_message(),
@@ -1638,7 +1960,7 @@ function wp_ajax_upload_attachment() {
        if ( ! $attachment = wp_prepare_attachment_for_js( $attachment_id ) )
                wp_die();
 
        if ( ! $attachment = wp_prepare_attachment_for_js( $attachment_id ) )
                wp_die();
 
-       echo json_encode( array(
+       echo wp_json_encode( array(
                'success' => true,
                'data'    => $attachment,
        ) );
                'success' => true,
                'data'    => $attachment,
        ) );
@@ -1646,6 +1968,11 @@ function wp_ajax_upload_attachment() {
        wp_die();
 }
 
        wp_die();
 }
 
+/**
+ * Ajax handler for image editing.
+ *
+ * @since 3.1.0
+ */
 function wp_ajax_image_editor() {
        $attachment_id = intval($_POST['postid']);
        if ( empty($attachment_id) || !current_user_can('edit_post', $attachment_id) )
 function wp_ajax_image_editor() {
        $attachment_id = intval($_POST['postid']);
        if ( empty($attachment_id) || !current_user_can('edit_post', $attachment_id) )
@@ -1658,7 +1985,7 @@ function wp_ajax_image_editor() {
        switch ( $_POST['do'] ) {
                case 'save' :
                        $msg = wp_save_image($attachment_id);
        switch ( $_POST['do'] ) {
                case 'save' :
                        $msg = wp_save_image($attachment_id);
-                       $msg = json_encode($msg);
+                       $msg = wp_json_encode($msg);
                        wp_die( $msg );
                        break;
                case 'scale' :
                        wp_die( $msg );
                        break;
                case 'scale' :
@@ -1673,6 +2000,11 @@ function wp_ajax_image_editor() {
        wp_die();
 }
 
        wp_die();
 }
 
+/**
+ * Ajax handler for setting the featured image.
+ *
+ * @since 3.1.0
+ */
 function wp_ajax_set_post_thumbnail() {
        $json = ! empty( $_REQUEST['json'] ); // New-style request
 
 function wp_ajax_set_post_thumbnail() {
        $json = ! empty( $_REQUEST['json'] ); // New-style request
 
@@ -1704,41 +2036,95 @@ function wp_ajax_set_post_thumbnail() {
        wp_die( 0 );
 }
 
        wp_die( 0 );
 }
 
+/**
+ * AJAX handler for setting the featured image for an attachment.
+ *
+ * @since 4.0.0
+ *
+ * @see set_post_thumbnail()
+ */
+function wp_ajax_set_attachment_thumbnail() {
+       if ( empty( $_POST['urls'] ) || ! is_array( $_POST['urls'] ) ) {
+               wp_send_json_error();
+       }
+
+       $thumbnail_id = (int) $_POST['thumbnail_id'];
+       if ( empty( $thumbnail_id ) ) {
+               wp_send_json_error();
+       }
+
+       $post_ids = array();
+       // For each URL, try to find its corresponding post ID.
+       foreach ( $_POST['urls'] as $url ) {
+               $post_id = attachment_url_to_postid( $url );
+               if ( ! empty( $post_id ) ) {
+                       $post_ids[] = $post_id;
+               }
+       }
+
+       if ( empty( $post_ids ) ) {
+               wp_send_json_error();
+       }
+
+       $success = 0;
+       // For each found attachment, set its thumbnail.
+       foreach ( $post_ids as $post_id ) {
+               if ( ! current_user_can( 'edit_post', $post_id ) ) {
+                       continue;
+               }
+
+               if ( set_post_thumbnail( $post_id, $thumbnail_id ) ) {
+                       $success++;
+               }
+       }
+
+       if ( 0 === $success ) {
+               wp_send_json_error();
+       } else {
+               wp_send_json_success();
+       }
+
+       wp_send_json_error();
+}
+
+/**
+ * Ajax handler for date formatting.
+ *
+ * @since 3.1.0
+ */
 function wp_ajax_date_format() {
 function wp_ajax_date_format() {
-       wp_die( date_i18n( sanitize_option( 'date_format', $_POST['date'] ) ) );
+       wp_die( date_i18n( sanitize_option( 'date_format', wp_unslash( $_POST['date'] ) ) ) );
 }
 
 }
 
+/**
+ * Ajax handler for time formatting.
+ *
+ * @since 3.1.0
+ */
 function wp_ajax_time_format() {
 function wp_ajax_time_format() {
-       wp_die( date_i18n( sanitize_option( 'time_format', $_POST['date'] ) ) );
+       wp_die( date_i18n( sanitize_option( 'time_format', wp_unslash( $_POST['date'] ) ) ) );
 }
 
 }
 
+/**
+ * Ajax handler for saving posts from the fullscreen editor.
+ *
+ * @since 3.1.0
+ * @deprecated 4.3.0
+ */
 function wp_ajax_wp_fullscreen_save_post() {
        $post_id = isset( $_POST['post_ID'] ) ? (int) $_POST['post_ID'] : 0;
 
 function wp_ajax_wp_fullscreen_save_post() {
        $post_id = isset( $_POST['post_ID'] ) ? (int) $_POST['post_ID'] : 0;
 
-       $post = $post_type = null;
+       $post = null;
 
        if ( $post_id )
                $post = get_post( $post_id );
 
 
        if ( $post_id )
                $post = get_post( $post_id );
 
-       if ( $post )
-               $post_type = $post->post_type;
-       elseif ( isset( $_POST['post_type'] ) && post_type_exists( $_POST['post_type'] ) )
-               $post_type = $_POST['post_type'];
-
        check_ajax_referer('update-post_' . $post_id, '_wpnonce');
 
        $post_id = edit_post();
 
        check_ajax_referer('update-post_' . $post_id, '_wpnonce');
 
        $post_id = edit_post();
 
-       if ( is_wp_error($post_id) ) {
-               if ( $post_id->get_error_message() )
-                       $message = $post_id->get_error_message();
-               else
-                       $message = __('Save failed');
-
-               echo json_encode( array( 'message' => $message, 'last_edited' => '' ) );
-               wp_die();
-       } else {
-               $message = __('Saved.');
+       if ( is_wp_error( $post_id ) ) {
+               wp_send_json_error();
        }
 
        if ( $post ) {
        }
 
        if ( $post ) {
@@ -1749,17 +2135,21 @@ function wp_ajax_wp_fullscreen_save_post() {
                $last_time = date_i18n( get_option('time_format') );
        }
 
                $last_time = date_i18n( get_option('time_format') );
        }
 
-       if ( $last_id = get_post_meta($post_id, '_edit_last', true) ) {
-               $last_user = get_userdata($last_id);
+       if ( $last_id = get_post_meta( $post_id, '_edit_last', true ) ) {
+               $last_user = get_userdata( $last_id );
                $last_edited = sprintf( __('Last edited by %1$s on %2$s at %3$s'), esc_html( $last_user->display_name ), $last_date, $last_time );
        } else {
                $last_edited = sprintf( __('Last edited on %1$s at %2$s'), $last_date, $last_time );
        }
 
                $last_edited = sprintf( __('Last edited by %1$s on %2$s at %3$s'), esc_html( $last_user->display_name ), $last_date, $last_time );
        } else {
                $last_edited = sprintf( __('Last edited on %1$s at %2$s'), $last_date, $last_time );
        }
 
-       echo json_encode( array( 'message' => $message, 'last_edited' => $last_edited ) );
-       wp_die();
+       wp_send_json_success( array( 'last_edited' => $last_edited ) );
 }
 
 }
 
+/**
+ * Ajax handler for removing a post lock.
+ *
+ * @since 3.1.0
+ */
 function wp_ajax_wp_remove_post_lock() {
        if ( empty( $_POST['post_ID'] ) || empty( $_POST['active_post_lock'] ) )
                wp_die( 0 );
 function wp_ajax_wp_remove_post_lock() {
        if ( empty( $_POST['post_ID'] ) || empty( $_POST['active_post_lock'] ) )
                wp_die( 0 );
@@ -1776,11 +2166,24 @@ function wp_ajax_wp_remove_post_lock() {
        if ( $active_lock[1] != get_current_user_id() )
                wp_die( 0 );
 
        if ( $active_lock[1] != get_current_user_id() )
                wp_die( 0 );
 
-       $new_lock = ( time() - apply_filters( 'wp_check_post_lock_window', AUTOSAVE_INTERVAL * 2 ) + 5 ) . ':' . $active_lock[1];
+       /**
+        * Filter the post lock window duration.
+        *
+        * @since 3.3.0
+        *
+        * @param int $interval The interval in seconds the post lock duration
+        *                      should last, plus 5 seconds. Default 150.
+        */
+       $new_lock = ( time() - apply_filters( 'wp_check_post_lock_window', 150 ) + 5 ) . ':' . $active_lock[1];
        update_post_meta( $post_id, '_edit_lock', $new_lock, implode( ':', $active_lock ) );
        wp_die( 1 );
 }
 
        update_post_meta( $post_id, '_edit_lock', $new_lock, implode( ':', $active_lock ) );
        wp_die( 1 );
 }
 
+/**
+ * Ajax handler for dismissing a WordPress pointer.
+ *
+ * @since 3.1.0
+ */
 function wp_ajax_dismiss_wp_pointer() {
        $pointer = $_POST['pointer'];
        if ( $pointer != sanitize_key( $pointer ) )
 function wp_ajax_dismiss_wp_pointer() {
        $pointer = $_POST['pointer'];
        if ( $pointer != sanitize_key( $pointer ) )
@@ -1801,7 +2204,7 @@ function wp_ajax_dismiss_wp_pointer() {
 }
 
 /**
 }
 
 /**
- * Get an attachment.
+ * Ajax handler for getting an attachment.
  *
  * @since 3.5.0
  */
  *
  * @since 3.5.0
  */
@@ -1828,7 +2231,7 @@ function wp_ajax_get_attachment() {
 }
 
 /**
 }
 
 /**
- * Query for attachments.
+ * Ajax handler for querying attachments.
  *
  * @since 3.5.0
  */
  *
  * @since 3.5.0
  */
@@ -1837,16 +2240,40 @@ function wp_ajax_query_attachments() {
                wp_send_json_error();
 
        $query = isset( $_REQUEST['query'] ) ? (array) $_REQUEST['query'] : array();
                wp_send_json_error();
 
        $query = isset( $_REQUEST['query'] ) ? (array) $_REQUEST['query'] : array();
-       $query = array_intersect_key( $query, array_flip( array(
+       $keys = array(
                's', 'order', 'orderby', 'posts_per_page', 'paged', 'post_mime_type',
                's', 'order', 'orderby', 'posts_per_page', 'paged', 'post_mime_type',
-               'post_parent', 'post__in', 'post__not_in',
-       ) ) );
+               'post_parent', 'post__in', 'post__not_in', 'year', 'monthnum'
+       );
+       foreach ( get_taxonomies_for_attachments( 'objects' ) as $t ) {
+               if ( $t->query_var && isset( $query[ $t->query_var ] ) ) {
+                       $keys[] = $t->query_var;
+               }
+       }
 
 
+       $query = array_intersect_key( $query, array_flip( $keys ) );
        $query['post_type'] = 'attachment';
        $query['post_type'] = 'attachment';
-       $query['post_status'] = 'inherit';
+       if ( MEDIA_TRASH
+               && ! empty( $_REQUEST['query']['post_status'] )
+               && 'trash' === $_REQUEST['query']['post_status'] ) {
+               $query['post_status'] = 'trash';
+       } else {
+               $query['post_status'] = 'inherit';
+       }
+
        if ( current_user_can( get_post_type_object( 'attachment' )->cap->read_private_posts ) )
                $query['post_status'] .= ',private';
 
        if ( current_user_can( get_post_type_object( 'attachment' )->cap->read_private_posts ) )
                $query['post_status'] .= ',private';
 
+       /**
+        * Filter the arguments passed to WP_Query during an AJAX
+        * call for querying attachments.
+        *
+        * @since 3.7.0
+        *
+        * @see WP_Query::parse_query()
+        *
+        * @param array $query An array of query variables.
+        */
+       $query = apply_filters( 'ajax_query_attachments_args', $query );
        $query = new WP_Query( $query );
 
        $posts = array_map( 'wp_prepare_attachment_for_js', $query->posts );
        $query = new WP_Query( $query );
 
        $posts = array_map( 'wp_prepare_attachment_for_js', $query->posts );
@@ -1856,7 +2283,7 @@ function wp_ajax_query_attachments() {
 }
 
 /**
 }
 
 /**
- * Save attachment attributes.
+ * Ajax handler for updating attachment attributes.
  *
  * @since 3.5.0
  */
  *
  * @since 3.5.0
  */
@@ -1878,6 +2305,9 @@ function wp_ajax_save_attachment() {
        if ( 'attachment' != $post['post_type'] )
                wp_send_json_error();
 
        if ( 'attachment' != $post['post_type'] )
                wp_send_json_error();
 
+       if ( isset( $changes['parent'] ) )
+               $post['post_parent'] = $changes['parent'];
+
        if ( isset( $changes['title'] ) )
                $post['post_title'] = $changes['title'];
 
        if ( isset( $changes['title'] ) )
                $post['post_title'] = $changes['title'];
 
@@ -1887,21 +2317,47 @@ function wp_ajax_save_attachment() {
        if ( isset( $changes['description'] ) )
                $post['post_content'] = $changes['description'];
 
        if ( isset( $changes['description'] ) )
                $post['post_content'] = $changes['description'];
 
+       if ( MEDIA_TRASH && isset( $changes['status'] ) )
+               $post['post_status'] = $changes['status'];
+
        if ( isset( $changes['alt'] ) ) {
        if ( isset( $changes['alt'] ) ) {
-               $alt = get_post_meta( $id, '_wp_attachment_image_alt', true );
-               $new_alt = stripslashes( $changes['alt'] );
-               if ( $alt != $new_alt ) {
-                       $new_alt = wp_strip_all_tags( $new_alt, true );
-                       update_post_meta( $id, '_wp_attachment_image_alt', addslashes( $new_alt ) );
+               $alt = wp_unslash( $changes['alt'] );
+               if ( $alt != get_post_meta( $id, '_wp_attachment_image_alt', true ) ) {
+                       $alt = wp_strip_all_tags( $alt, true );
+                       update_post_meta( $id, '_wp_attachment_image_alt', wp_slash( $alt ) );
                }
        }
 
                }
        }
 
-       wp_update_post( $post );
+       if ( wp_attachment_is( 'audio', $post['ID'] ) ) {
+               $changed = false;
+               $id3data = wp_get_attachment_metadata( $post['ID'] );
+               if ( ! is_array( $id3data ) ) {
+                       $changed = true;
+                       $id3data = array();
+               }
+               foreach ( wp_get_attachment_id3_keys( (object) $post, 'edit' ) as $key => $label ) {
+                       if ( isset( $changes[ $key ] ) ) {
+                               $changed = true;
+                               $id3data[ $key ] = sanitize_text_field( wp_unslash( $changes[ $key ] ) );
+                       }
+               }
+
+               if ( $changed ) {
+                       wp_update_attachment_metadata( $id, $id3data );
+               }
+       }
+
+       if ( MEDIA_TRASH && isset( $changes['status'] ) && 'trash' === $changes['status'] ) {
+               wp_delete_post( $id );
+       } else {
+               wp_update_post( $post );
+       }
+
        wp_send_json_success();
 }
 
 /**
        wp_send_json_success();
 }
 
 /**
- * Save backwards compatible attachment attributes.
+ * Ajax handler for saving backwards compatible attachment attributes.
  *
  * @since 3.5.0
  */
  *
  * @since 3.5.0
  */
@@ -1926,6 +2382,7 @@ function wp_ajax_save_attachment_compat() {
        if ( 'attachment' != $post['post_type'] )
                wp_send_json_error();
 
        if ( 'attachment' != $post['post_type'] )
                wp_send_json_error();
 
+       /** This filter is documented in wp-admin/includes/media.php */
        $post = apply_filters( 'attachment_fields_to_save', $post, $attachment_data );
 
        if ( isset( $post['errors'] ) ) {
        $post = apply_filters( 'attachment_fields_to_save', $post, $attachment_data );
 
        if ( isset( $post['errors'] ) ) {
@@ -1946,6 +2403,11 @@ function wp_ajax_save_attachment_compat() {
        wp_send_json_success( $attachment );
 }
 
        wp_send_json_success( $attachment );
 }
 
+/**
+ * Ajax handler for saving the attachment order.
+ *
+ * @since 3.5.0
+ */
 function wp_ajax_save_attachment_order() {
        if ( ! isset( $_REQUEST['post_id'] ) )
                wp_send_json_error();
 function wp_ajax_save_attachment_order() {
        if ( ! isset( $_REQUEST['post_id'] ) )
                wp_send_json_error();
@@ -1963,8 +2425,6 @@ function wp_ajax_save_attachment_order() {
        if ( ! current_user_can( 'edit_post', $post_id ) )
                wp_send_json_error();
 
        if ( ! current_user_can( 'edit_post', $post_id ) )
                wp_send_json_error();
 
-       $post = get_post( $post_id, ARRAY_A );
-
        foreach ( $attachments as $attachment_id => $menu_order ) {
                if ( ! current_user_can( 'edit_post', $attachment_id ) )
                        continue;
        foreach ( $attachments as $attachment_id => $menu_order ) {
                if ( ! current_user_can( 'edit_post', $attachment_id ) )
                        continue;
@@ -1980,16 +2440,18 @@ function wp_ajax_save_attachment_order() {
 }
 
 /**
 }
 
 /**
+ * Ajax handler for sending an attachment to the editor.
+ *
  * Generates the HTML to send an attachment to the editor.
  * Generates the HTML to send an attachment to the editor.
- * Backwards compatible with the media_send_to_editor filter and the chain
- * of filters that follow.
+ * Backwards compatible with the media_send_to_editor filter
+ * and the chain of filters that follow.
  *
  * @since 3.5.0
  */
 function wp_ajax_send_attachment_to_editor() {
        check_ajax_referer( 'media-send-to-editor', 'nonce' );
 
  *
  * @since 3.5.0
  */
 function wp_ajax_send_attachment_to_editor() {
        check_ajax_referer( 'media-send-to-editor', 'nonce' );
 
-       $attachment = stripslashes_deep( $_POST['attachment'] );
+       $attachment = wp_unslash( $_POST['attachment'] );
 
        $id = intval( $attachment['id'] );
 
 
        $id = intval( $attachment['id'] );
 
@@ -2007,7 +2469,7 @@ function wp_ajax_send_attachment_to_editor() {
        }
 
        $rel = $url = '';
        }
 
        $rel = $url = '';
-       $html = $title = isset( $attachment['post_title'] ) ? $attachment['post_title'] : '';
+       $html = isset( $attachment['post_title'] ) ? $attachment['post_title'] : '';
        if ( ! empty( $attachment['url'] ) ) {
                $url = $attachment['url'];
                if ( strpos( $url, 'attachment_id') || get_attachment_link( $id ) == $url )
        if ( ! empty( $attachment['url'] ) ) {
                $url = $attachment['url'];
                if ( strpos( $url, 'attachment_id') || get_attachment_link( $id ) == $url )
@@ -2015,23 +2477,34 @@ function wp_ajax_send_attachment_to_editor() {
                $html = '<a href="' . esc_url( $url ) . '"' . $rel . '>' . $html . '</a>';
        }
 
                $html = '<a href="' . esc_url( $url ) . '"' . $rel . '>' . $html . '</a>';
        }
 
-       remove_filter( 'media_send_to_editor', 'image_media_send_to_editor', 10, 3 );
+       remove_filter( 'media_send_to_editor', 'image_media_send_to_editor' );
 
        if ( 'image' === substr( $post->post_mime_type, 0, 5 ) ) {
                $align = isset( $attachment['align'] ) ? $attachment['align'] : 'none';
                $size = isset( $attachment['image-size'] ) ? $attachment['image-size'] : 'medium';
                $alt = isset( $attachment['image_alt'] ) ? $attachment['image_alt'] : '';
 
        if ( 'image' === substr( $post->post_mime_type, 0, 5 ) ) {
                $align = isset( $attachment['align'] ) ? $attachment['align'] : 'none';
                $size = isset( $attachment['image-size'] ) ? $attachment['image-size'] : 'medium';
                $alt = isset( $attachment['image_alt'] ) ? $attachment['image_alt'] : '';
+
+               // No whitespace-only captions.
                $caption = isset( $attachment['post_excerpt'] ) ? $attachment['post_excerpt'] : '';
                $caption = isset( $attachment['post_excerpt'] ) ? $attachment['post_excerpt'] : '';
+               if ( '' === trim( $caption ) ) {
+                       $caption = '';
+               }
+
                $title = ''; // We no longer insert title tags into <img> tags, as they are redundant.
                $html = get_image_send_to_editor( $id, $caption, $title, $align, $url, (bool) $rel, $size, $alt );
                $title = ''; // We no longer insert title tags into <img> tags, as they are redundant.
                $html = get_image_send_to_editor( $id, $caption, $title, $align, $url, (bool) $rel, $size, $alt );
+       } elseif ( wp_attachment_is( 'video', $post ) || wp_attachment_is( 'audio', $post )  ) {
+               $html = stripslashes_deep( $_POST['html'] );
        }
 
        }
 
+       /** This filter is documented in wp-admin/includes/media.php */
        $html = apply_filters( 'media_send_to_editor', $html, $id, $attachment );
 
        wp_send_json_success( $html );
 }
 
 /**
        $html = apply_filters( 'media_send_to_editor', $html, $id, $attachment );
 
        wp_send_json_success( $html );
 }
 
 /**
+ * Ajax handler for sending a link to the editor.
+ *
  * Generates the HTML to send a non-image embed link to the editor.
  *
  * Backwards compatible with the following filters:
  * Generates the HTML to send a non-image embed link to the editor.
  *
  * Backwards compatible with the following filters:
@@ -2040,11 +2513,16 @@ function wp_ajax_send_attachment_to_editor() {
  * - video_send_to_editor_url
  *
  * @since 3.5.0
  * - video_send_to_editor_url
  *
  * @since 3.5.0
+ *
+ * @global WP_Post  $post
+ * @global WP_Embed $wp_embed
  */
 function wp_ajax_send_link_to_editor() {
  */
 function wp_ajax_send_link_to_editor() {
+       global $post, $wp_embed;
+
        check_ajax_referer( 'media-send-to-editor', 'nonce' );
 
        check_ajax_referer( 'media-send-to-editor', 'nonce' );
 
-       if ( ! $src = stripslashes( $_POST['src'] ) )
+       if ( ! $src = wp_unslash( $_POST['src'] ) )
                wp_send_json_error();
 
        if ( ! strpos( $src, '://' ) )
                wp_send_json_error();
 
        if ( ! strpos( $src, '://' ) )
@@ -2053,12 +2531,25 @@ function wp_ajax_send_link_to_editor() {
        if ( ! $src = esc_url_raw( $src ) )
                wp_send_json_error();
 
        if ( ! $src = esc_url_raw( $src ) )
                wp_send_json_error();
 
-       if ( ! $title = trim( stripslashes( $_POST['title'] ) ) )
-               $title = wp_basename( $src );
+       if ( ! $link_text = trim( wp_unslash( $_POST['link_text'] ) ) )
+               $link_text = wp_basename( $src );
 
 
-       $html = '';
-       if ( $title )
-               $html = '<a href="' . esc_url( $src ) . '">' . $title . '</a>';
+       $post = get_post( isset( $_POST['post_id'] ) ? $_POST['post_id'] : 0 );
+
+       // Ping WordPress for an embed.
+       $check_embed = $wp_embed->run_shortcode( '[embed]'. $src .'[/embed]' );
+
+       // Fallback that WordPress creates when no oEmbed was found.
+       $fallback = $wp_embed->maybe_make_link( $src );
+
+       if ( $check_embed !== $fallback ) {
+               // TinyMCE view for [embed] will parse this
+               $html = '[embed]' . $src . '[/embed]';
+       } elseif ( $link_text ) {
+               $html = '<a href="' . esc_url( $src ) . '">' . $link_text . '</a>';
+       } else {
+               $html = '';
+       }
 
        // Figure out what filter to run:
        $type = 'file';
 
        // Figure out what filter to run:
        $type = 'file';
@@ -2066,7 +2557,620 @@ function wp_ajax_send_link_to_editor() {
                && ( 'audio' == $ext_type || 'video' == $ext_type ) )
                        $type = $ext_type;
 
                && ( 'audio' == $ext_type || 'video' == $ext_type ) )
                        $type = $ext_type;
 
-       $html = apply_filters( $type . '_send_to_editor_url', $html, $src, $title );
+       /** This filter is documented in wp-admin/includes/media.php */
+       $html = apply_filters( $type . '_send_to_editor_url', $html, $src, $link_text );
 
        wp_send_json_success( $html );
 }
 
        wp_send_json_success( $html );
 }
+
+/**
+ * Ajax handler for the Heartbeat API.
+ *
+ * Runs when the user is logged in.
+ *
+ * @since 3.6.0
+ */
+function wp_ajax_heartbeat() {
+       if ( empty( $_POST['_nonce'] ) ) {
+               wp_send_json_error();
+       }
+
+       $response = $data = array();
+       $nonce_state = wp_verify_nonce( $_POST['_nonce'], 'heartbeat-nonce' );
+
+       // screen_id is the same as $current_screen->id and the JS global 'pagenow'.
+       if ( ! empty( $_POST['screen_id'] ) ) {
+               $screen_id = sanitize_key($_POST['screen_id']);
+       } else {
+               $screen_id = 'front';
+       }
+
+       if ( ! empty( $_POST['data'] ) ) {
+               $data = wp_unslash( (array) $_POST['data'] );
+       }
+
+       if ( 1 !== $nonce_state ) {
+               $response = apply_filters( 'wp_refresh_nonces', $response, $data, $screen_id );
+
+               if ( false === $nonce_state ) {
+                       // User is logged in but nonces have expired.
+                       $response['nonces_expired'] = true;
+                       wp_send_json( $response );
+               }
+       }
+
+       if ( ! empty( $data ) ) {
+               /**
+                * Filter the Heartbeat response received.
+                *
+                * @since 3.6.0
+                *
+                * @param array|object $response  The Heartbeat response object or array.
+                * @param array        $data      The $_POST data sent.
+                * @param string       $screen_id The screen id.
+                */
+               $response = apply_filters( 'heartbeat_received', $response, $data, $screen_id );
+       }
+
+       /**
+        * Filter the Heartbeat response sent.
+        *
+        * @since 3.6.0
+        *
+        * @param array|object $response  The Heartbeat response object or array.
+        * @param string       $screen_id The screen id.
+        */
+       $response = apply_filters( 'heartbeat_send', $response, $screen_id );
+
+       /**
+        * Fires when Heartbeat ticks in logged-in environments.
+        *
+        * Allows the transport to be easily replaced with long-polling.
+        *
+        * @since 3.6.0
+        *
+        * @param array|object $response  The Heartbeat response object or array.
+        * @param string       $screen_id The screen id.
+        */
+       do_action( 'heartbeat_tick', $response, $screen_id );
+
+       // Send the current time according to the server
+       $response['server_time'] = time();
+
+       wp_send_json( $response );
+}
+
+/**
+ * Ajax handler for getting revision diffs.
+ *
+ * @since 3.6.0
+ */
+function wp_ajax_get_revision_diffs() {
+       require ABSPATH . 'wp-admin/includes/revision.php';
+
+       if ( ! $post = get_post( (int) $_REQUEST['post_id'] ) )
+               wp_send_json_error();
+
+       if ( ! current_user_can( 'read_post', $post->ID ) )
+               wp_send_json_error();
+
+       // Really just pre-loading the cache here.
+       if ( ! $revisions = wp_get_post_revisions( $post->ID, array( 'check_enabled' => false ) ) )
+               wp_send_json_error();
+
+       $return = array();
+       @set_time_limit( 0 );
+
+       foreach ( $_REQUEST['compare'] as $compare_key ) {
+               list( $compare_from, $compare_to ) = explode( ':', $compare_key ); // from:to
+
+               $return[] = array(
+                       'id' => $compare_key,
+                       'fields' => wp_get_revision_ui_diff( $post, $compare_from, $compare_to ),
+               );
+       }
+       wp_send_json_success( $return );
+}
+
+/**
+ * Ajax handler for auto-saving the selected color scheme for
+ * a user's own profile.
+ *
+ * @since 3.8.0
+ *
+ * @global array $_wp_admin_css_colors
+ */
+function wp_ajax_save_user_color_scheme() {
+       global $_wp_admin_css_colors;
+
+       check_ajax_referer( 'save-color-scheme', 'nonce' );
+
+       $color_scheme = sanitize_key( $_POST['color_scheme'] );
+
+       if ( ! isset( $_wp_admin_css_colors[ $color_scheme ] ) ) {
+               wp_send_json_error();
+       }
+
+       $previous_color_scheme = get_user_meta( get_current_user_id(), 'admin_color', true );
+       update_user_meta( get_current_user_id(), 'admin_color', $color_scheme );
+
+       wp_send_json_success( array(
+               'previousScheme' => 'admin-color-' . $previous_color_scheme,
+               'currentScheme'  => 'admin-color-' . $color_scheme
+       ) );
+}
+
+/**
+ * Ajax handler for getting themes from themes_api().
+ *
+ * @since 3.9.0
+ *
+ * @global array $themes_allowedtags
+ * @global array $theme_field_defaults
+ */
+function wp_ajax_query_themes() {
+       global $themes_allowedtags, $theme_field_defaults;
+
+       if ( ! current_user_can( 'install_themes' ) ) {
+               wp_send_json_error();
+       }
+
+       $args = wp_parse_args( wp_unslash( $_REQUEST['request'] ), array(
+               'per_page' => 20,
+               'fields'   => $theme_field_defaults
+       ) );
+
+       $old_filter = isset( $args['browse'] ) ? $args['browse'] : 'search';
+
+       /** This filter is documented in wp-admin/includes/class-wp-theme-install-list-table.php */
+       $args = apply_filters( 'install_themes_table_api_args_' . $old_filter, $args );
+
+       $api = themes_api( 'query_themes', $args );
+
+       if ( is_wp_error( $api ) ) {
+               wp_send_json_error();
+       }
+
+       $update_php = network_admin_url( 'update.php?action=install-theme' );
+       foreach ( $api->themes as &$theme ) {
+               $theme->install_url = add_query_arg( array(
+                       'theme'    => $theme->slug,
+                       '_wpnonce' => wp_create_nonce( 'install-theme_' . $theme->slug )
+               ), $update_php );
+
+               $theme->name        = wp_kses( $theme->name, $themes_allowedtags );
+               $theme->author      = wp_kses( $theme->author, $themes_allowedtags );
+               $theme->version     = wp_kses( $theme->version, $themes_allowedtags );
+               $theme->description = wp_kses( $theme->description, $themes_allowedtags );
+               $theme->num_ratings = sprintf( _n( '(based on %s rating)', '(based on %s ratings)', $theme->num_ratings ), number_format_i18n( $theme->num_ratings ) );
+               $theme->preview_url = set_url_scheme( $theme->preview_url );
+       }
+
+       wp_send_json_success( $api );
+}
+
+/**
+ * Apply [embed] AJAX handlers to a string.
+ *
+ * @since 4.0.0
+ *
+ * @global WP_Post    $post       Global $post.
+ * @global WP_Embed   $wp_embed   Embed API instance.
+ * @global WP_Scripts $wp_scripts
+ */
+function wp_ajax_parse_embed() {
+       global $post, $wp_embed;
+
+       if ( ! $post = get_post( (int) $_POST['post_ID'] ) ) {
+               wp_send_json_error();
+       }
+
+       if ( empty( $_POST['shortcode'] ) || ! current_user_can( 'edit_post', $post->ID ) ) {
+               wp_send_json_error();
+       }
+
+       $shortcode = wp_unslash( $_POST['shortcode'] );
+
+       preg_match( '/' . get_shortcode_regex() . '/s', $shortcode, $matches );
+       $atts = shortcode_parse_atts( $matches[3] );
+       if ( ! empty( $matches[5] ) ) {
+               $url = $matches[5];
+       } elseif ( ! empty( $atts['src'] ) ) {
+               $url = $atts['src'];
+       } else {
+               $url = '';
+       }
+
+       $parsed = false;
+       setup_postdata( $post );
+
+       $wp_embed->return_false_on_fail = true;
+
+       if ( is_ssl() && 0 === strpos( $url, 'http://' ) ) {
+               // Admin is ssl and the user pasted non-ssl URL.
+               // Check if the provider supports ssl embeds and use that for the preview.
+               $ssl_shortcode = preg_replace( '%^(\\[embed[^\\]]*\\])http://%i', '$1https://', $shortcode );
+               $parsed = $wp_embed->run_shortcode( $ssl_shortcode );
+
+               if ( ! $parsed ) {
+                       $no_ssl_support = true;
+               }
+       }
+
+       if ( $url && ! $parsed ) {
+               $parsed = $wp_embed->run_shortcode( $shortcode );
+       }
+
+       if ( ! $parsed ) {
+               wp_send_json_error( array(
+                       'type' => 'not-embeddable',
+                       'message' => sprintf( __( '%s failed to embed.' ), '<code>' . esc_html( $url ) . '</code>' ),
+               ) );
+       }
+
+       if ( has_shortcode( $parsed, 'audio' ) || has_shortcode( $parsed, 'video' ) ) {
+               $styles = '';
+               $mce_styles = wpview_media_sandbox_styles();
+               foreach ( $mce_styles as $style ) {
+                       $styles .= sprintf( '<link rel="stylesheet" href="%s"/>', $style );
+               }
+
+               $html = do_shortcode( $parsed );
+
+               global $wp_scripts;
+               if ( ! empty( $wp_scripts ) ) {
+                       $wp_scripts->done = array();
+               }
+               ob_start();
+               wp_print_scripts( 'wp-mediaelement' );
+               $scripts = ob_get_clean();
+
+               $parsed = $styles . $html . $scripts;
+       }
+
+
+       if ( ! empty( $no_ssl_support ) || ( is_ssl() && ( preg_match( '%<(iframe|script|embed) [^>]*src="http://%', $parsed ) ||
+               preg_match( '%<link [^>]*href="http://%', $parsed ) ) ) ) {
+               // Admin is ssl and the embed is not. Iframes, scripts, and other "active content" will be blocked.
+               wp_send_json_error( array(
+                       'type' => 'not-ssl',
+                       'message' => __( 'This preview is unavailable in the editor.' ),
+               ) );
+       }
+
+       wp_send_json_success( array(
+               'body' => $parsed,
+               'attr' => $wp_embed->last_attr
+       ) );
+}
+
+/**
+ * @since 4.0.0
+ *
+ * @global WP_Post    $post
+ * @global WP_Scripts $wp_scripts
+ */
+function wp_ajax_parse_media_shortcode() {
+       global $post, $wp_scripts;
+
+       if ( empty( $_POST['shortcode'] ) ) {
+               wp_send_json_error();
+       }
+
+       $shortcode = wp_unslash( $_POST['shortcode'] );
+
+       if ( ! empty( $_POST['post_ID'] ) ) {
+               $post = get_post( (int) $_POST['post_ID'] );
+       }
+
+       // the embed shortcode requires a post
+       if ( ! $post || ! current_user_can( 'edit_post', $post->ID ) ) {
+               if ( 'embed' === $shortcode ) {
+                       wp_send_json_error();
+               }
+       } else {
+               setup_postdata( $post );
+       }
+
+       $parsed = do_shortcode( $shortcode  );
+
+       if ( empty( $parsed ) ) {
+               wp_send_json_error( array(
+                       'type' => 'no-items',
+                       'message' => __( 'No items found.' ),
+               ) );
+       }
+
+       $head = '';
+       $styles = wpview_media_sandbox_styles();
+
+       foreach ( $styles as $style ) {
+               $head .= '<link type="text/css" rel="stylesheet" href="' . $style . '">';
+       }
+
+       if ( ! empty( $wp_scripts ) ) {
+               $wp_scripts->done = array();
+       }
+
+       ob_start();
+
+       echo $parsed;
+
+       if ( 'playlist' === $_REQUEST['type'] ) {
+               wp_underscore_playlist_templates();
+
+               wp_print_scripts( 'wp-playlist' );
+       } else {
+               wp_print_scripts( array( 'froogaloop', 'wp-mediaelement' ) );
+       }
+
+       wp_send_json_success( array(
+               'head' => $head,
+               'body' => ob_get_clean()
+       ) );
+}
+
+/**
+ * AJAX handler for destroying multiple open sessions for a user.
+ *
+ * @since 4.1.0
+ */
+function wp_ajax_destroy_sessions() {
+       $user = get_userdata( (int) $_POST['user_id'] );
+       if ( $user ) {
+               if ( ! current_user_can( 'edit_user', $user->ID ) ) {
+                       $user = false;
+               } elseif ( ! wp_verify_nonce( $_POST['nonce'], 'update-user_' . $user->ID ) ) {
+                       $user = false;
+               }
+       }
+
+       if ( ! $user ) {
+               wp_send_json_error( array(
+                       'message' => __( 'Could not log out user sessions. Please try again.' ),
+               ) );
+       }
+
+       $sessions = WP_Session_Tokens::get_instance( $user->ID );
+
+       if ( $user->ID === get_current_user_id() ) {
+               $sessions->destroy_others( wp_get_session_token() );
+               $message = __( 'You are now logged out everywhere else.' );
+       } else {
+               $sessions->destroy_all();
+               /* translators: 1: User's display name. */
+               $message = sprintf( __( '%s has been logged out.' ), $user->display_name );
+       }
+
+       wp_send_json_success( array( 'message' => $message ) );
+}
+
+
+/**
+ * AJAX handler for updating a plugin.
+ *
+ * @since 4.2.0
+ *
+ * @see Plugin_Upgrader
+ */
+function wp_ajax_update_plugin() {
+       global $wp_filesystem;
+
+       $plugin = urldecode( $_POST['plugin'] );
+
+       $status = array(
+               'update'     => 'plugin',
+               'plugin'     => $plugin,
+               'slug'       => sanitize_key( $_POST['slug'] ),
+               'oldVersion' => '',
+               'newVersion' => '',
+       );
+
+       $plugin_data = get_plugin_data( WP_PLUGIN_DIR . '/' . $plugin );
+       if ( $plugin_data['Version'] ) {
+               $status['oldVersion'] = sprintf( __( 'Version %s' ), $plugin_data['Version'] );
+       }
+
+       if ( ! current_user_can( 'update_plugins' ) ) {
+               $status['error'] = __( 'You do not have sufficient permissions to update plugins for this site.' );
+               wp_send_json_error( $status );
+       }
+
+       check_ajax_referer( 'updates' );
+
+       include_once( ABSPATH . 'wp-admin/includes/class-wp-upgrader.php' );
+
+       wp_update_plugins();
+
+       $skin = new Automatic_Upgrader_Skin();
+       $upgrader = new Plugin_Upgrader( $skin );
+       $result = $upgrader->bulk_upgrade( array( $plugin ) );
+
+       if ( is_array( $result ) && empty( $result[$plugin] ) && is_wp_error( $skin->result ) ) {
+               $result = $skin->result;
+       }
+
+       if ( is_array( $result ) && !empty( $result[ $plugin ] ) ) {
+               $plugin_update_data = current( $result );
+
+               /*
+                * If the `update_plugins` site transient is empty (e.g. when you update
+                * two plugins in quick succession before the transient repopulates),
+                * this may be the return.
+                *
+                * Preferably something can be done to ensure `update_plugins` isn't empty.
+                * For now, surface some sort of error here.
+                */
+               if ( $plugin_update_data === true ) {
+                       wp_send_json_error( $status );
+               }
+
+               $plugin_data = get_plugins( '/' . $result[ $plugin ]['destination_name'] );
+               $plugin_data = reset( $plugin_data );
+
+               if ( $plugin_data['Version'] ) {
+                       $status['newVersion'] = sprintf( __( 'Version %s' ), $plugin_data['Version'] );
+               }
+
+               wp_send_json_success( $status );
+       } else if ( is_wp_error( $result ) ) {
+               $status['error'] = $result->get_error_message();
+               wp_send_json_error( $status );
+
+       } else if ( is_bool( $result ) && ! $result ) {
+               $status['errorCode'] = 'unable_to_connect_to_filesystem';
+               $status['error'] = __( 'Unable to connect to the filesystem. Please confirm your credentials.' );
+
+               // Pass through the error from WP_Filesystem if one was raised
+               if ( is_wp_error( $wp_filesystem->errors ) && $wp_filesystem->errors->get_error_code() ) {
+                       $status['error'] = $wp_filesystem->errors->get_error_message();
+               }
+
+               wp_send_json_error( $status );
+
+       }
+}
+
+/**
+ * AJAX handler for saving a post from Press This.
+ *
+ * @since 4.2.0
+ *
+ * @global WP_Press_This $wp_press_this
+ */
+function wp_ajax_press_this_save_post() {
+       if ( empty( $GLOBALS['wp_press_this'] ) ) {
+               include( ABSPATH . 'wp-admin/includes/class-wp-press-this.php' );
+       }
+
+       $GLOBALS['wp_press_this']->save_post();
+}
+
+/**
+ * AJAX handler for creating new category from Press This.
+ *
+ * @since 4.2.0
+ *
+ * @global WP_Press_This $wp_press_this
+ */
+function wp_ajax_press_this_add_category() {
+       if ( empty( $GLOBALS['wp_press_this'] ) ) {
+               include( ABSPATH . 'wp-admin/includes/class-wp-press-this.php' );
+       }
+
+       $GLOBALS['wp_press_this']->add_category();
+}
+
+/**
+ * AJAX handler for cropping an image.
+ *
+ * @since 4.3.0
+ *
+ * @global WP_Site_Icon $wp_site_icon
+ */
+function wp_ajax_crop_image() {
+       $attachment_id = absint( $_POST['id'] );
+
+       check_ajax_referer( 'image_editor-' . $attachment_id, 'nonce' );
+       if ( ! current_user_can( 'customize' ) ) {
+               wp_send_json_error();
+       }
+
+       $context = str_replace( '_', '-', $_POST['context'] );
+       $data    = array_map( 'absint', $_POST['cropDetails'] );
+       $cropped = wp_crop_image( $attachment_id, $data['x1'], $data['y1'], $data['width'], $data['height'], $data['dst_width'], $data['dst_height'] );
+
+       if ( ! $cropped || is_wp_error( $cropped ) ) {
+               wp_send_json_error( array( 'message' => __( 'Image could not be processed.' ) ) );
+       }
+
+       switch ( $context ) {
+               case 'site-icon':
+                       require_once ABSPATH . '/wp-admin/includes/class-wp-site-icon.php';
+                       global $wp_site_icon;
+
+                       // Skip creating a new attachment if the attachment is a Site Icon.
+                       if ( get_post_meta( $attachment_id, '_wp_attachment_context', true ) == $context ) {
+
+                               // Delete the temporary cropped file, we don't need it.
+                               wp_delete_file( $cropped );
+
+                               // Additional sizes in wp_prepare_attachment_for_js().
+                               add_filter( 'image_size_names_choose', array( $wp_site_icon, 'additional_sizes' ) );
+                               break;
+                       }
+
+                       /** This filter is documented in wp-admin/custom-header.php */
+                       $cropped = apply_filters( 'wp_create_file_in_uploads', $cropped, $attachment_id ); // For replication.
+                       $object  = $wp_site_icon->create_attachment_object( $cropped, $attachment_id );
+                       unset( $object['ID'] );
+
+                       // Update the attachment.
+                       add_filter( 'intermediate_image_sizes_advanced', array( $wp_site_icon, 'additional_sizes' ) );
+                       $attachment_id = $wp_site_icon->insert_attachment( $object, $cropped );
+                       remove_filter( 'intermediate_image_sizes_advanced', array( $wp_site_icon, 'additional_sizes' ) );
+
+                       // Additional sizes in wp_prepare_attachment_for_js().
+                       add_filter( 'image_size_names_choose', array( $wp_site_icon, 'additional_sizes' ) );
+                       break;
+
+               default:
+
+                       /**
+                        * Fires before a cropped image is saved.
+                        *
+                        * Allows to add filters to modify the way a cropped image is saved.
+                        *
+                        * @since 4.3.0
+                        *
+                        * @param string $context       The Customizer control requesting the cropped image.
+                        * @param int    $attachment_id The attachment ID of the original image.
+                        * @param string $cropped       Path to the cropped image file.
+                        */
+                       do_action( 'wp_ajax_crop_image_pre_save', $context, $attachment_id, $cropped );
+
+                       /** This filter is documented in wp-admin/custom-header.php */
+                       $cropped = apply_filters( 'wp_create_file_in_uploads', $cropped, $attachment_id ); // For replication.
+
+                       $parent_url = get_post( $attachment_id )->guid;
+                       $url        = str_replace( basename( $parent_url ), basename( $cropped ), $parent_url );
+
+                       $size       = @getimagesize( $cropped );
+                       $image_type = ( $size ) ? $size['mime'] : 'image/jpeg';
+
+                       $object = array(
+                               'post_title'     => basename( $cropped ),
+                               'post_content'   => $url,
+                               'post_mime_type' => $image_type,
+                               'guid'           => $url,
+                               'context'        => $context,
+                       );
+
+                       $attachment_id = wp_insert_attachment( $object, $cropped );
+                       $metadata = wp_generate_attachment_metadata( $attachment_id, $cropped );
+
+                       /**
+                        * Filter the cropped image attachment metadata.
+                        *
+                        * @since 4.3.0
+                        *
+                        * @see wp_generate_attachment_metadata()
+                        *
+                        * @param array $metadata Attachment metadata.
+                        */
+                       $metadata = apply_filters( 'wp_ajax_cropped_attachment_metadata', $metadata );
+                       wp_update_attachment_metadata( $attachment_id, $metadata );
+
+                       /**
+                        * Filter the attachment ID for a cropped image.
+                        *
+                        * @since 4.3.0
+                        *
+                        * @param int    $attachment_id The attachment ID of the cropped image.
+                        * @param string $context       The Customizer control requesting the cropped image.
+                        */
+                       $attachment_id = apply_filters( 'wp_ajax_cropped_attachment_id', $attachment_id, $context );
+       }
+
+       wp_send_json_success( wp_prepare_attachment_for_js( $attachment_id ) );
+}