]> scripts.mit.edu Git - autoinstalls/wordpress.git/blobdiff - wp-admin/includes/ajax-actions.php
WordPress 4.1.3
[autoinstalls/wordpress.git] / wp-admin / includes / ajax-actions.php
index 734409fe1f1bac0f8bbb2ce48d2aec3e1f7cd4ad..a18dbe7fa1a26a03ceb0a0a1591ce8f692231a51 100644 (file)
@@ -6,19 +6,22 @@
  * @subpackage Administration
  */
 
-/*
- * No-privilege Ajax handlers.
- */
+//
+// No-privilege Ajax handlers.
+//
 
 /**
- * Heartbeat API (experimental)
+ * 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();
 
-       // screen_id is the same as $current_screen->id and the JS global 'pagenow'
+       // 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
@@ -26,22 +29,55 @@ function wp_ajax_nopriv_heartbeat() {
 
        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 );
        }
 
+       /**
+        * 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 );
 
-       // Allow the transport to be replaced with long-polling easily
+       /**
+        * 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
+       // 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
  */
 function wp_ajax_fetch_list() {
        global $wp_list_table;
@@ -60,20 +96,27 @@ function wp_ajax_fetch_list() {
 
        wp_die( 0 );
 }
+
+/**
+ * Ajax handler for tag search.
+ *
+ * @since 3.1.0
+ */
 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 );
        }
 
+       if ( ! current_user_can( $tax->cap->assign_terms ) ) {
+               wp_die( -1 );
+       }
+
        $s = wp_unslash( $_GET['q'] );
 
        $comma = _x( ',', 'tag delimiter' );
@@ -84,15 +127,37 @@ function wp_ajax_ajax_tag_search() {
                $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();
 }
 
+/**
+ * Ajax handler for compression testing.
+ *
+ * @since 3.1.0
+ */
 function wp_ajax_wp_compression_test() {
        if ( !current_user_can( 'manage_options' ) )
                wp_die( -1 );
@@ -138,6 +203,11 @@ function wp_ajax_wp_compression_test() {
        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) )
@@ -152,33 +222,53 @@ function wp_ajax_imgedit_preview() {
        wp_die();
 }
 
+/**
+ * Ajax handler for oEmbed caching.
+ *
+ * @since 3.1.0
+ */
 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 );
 
+       /** 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 ( isset( $_REQUEST['autocomplete_type'] ) )
+       // Current allowed values are `add` and `search`
+       if ( isset( $_REQUEST['autocomplete_type'] ) && 'search' === $_REQUEST['autocomplete_type'] ) {
                $type = $_REQUEST['autocomplete_type'];
-       else
+       } else {
                $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
-       if ( isset( $_REQUEST['site_id'] ) )
+       if ( isset( $_REQUEST['site_id'] ) ) {
                $id = absint( $_REQUEST['site_id'] );
-       else
+       } else {
                $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() );
@@ -195,56 +285,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 ),
-                       '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';
 
+       $pagenow = $_GET['pagenow'];
+       if ( $pagenow === 'dashboard-user' || $pagenow === 'dashboard-network' || $pagenow === 'dashboard' ) {
+               set_current_screen( $pagenow );
+       }
+
        switch ( $_GET['widget'] ) {
-               case 'dashboard_incoming_links' :
-                       wp_dashboard_incoming_links();
-                       break;
                case 'dashboard_primary' :
                        wp_dashboard_primary();
                        break;
-               case 'dashboard_secondary' :
-                       wp_dashboard_secondary();
-                       break;
-               case 'dashboard_plugins' :
-                       wp_dashboard_plugins();
-                       break;
        }
        wp_die();
 }
 
+/**
+ * Ajax handler for Customizer preview logged-in status.
+ *
+ * @since 3.4.0
+ */
 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.
  *
- * @since 2.7
+ * @since 2.7.0
  *
  * @param int $comment_id
  * @return die
  */
 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() );
@@ -268,16 +365,19 @@ function _wp_ajax_delete_comment_response( $comment_id, $delta = -1 ) {
 
                $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;
-                       // 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',
-               'id' => $comment_id, // here for completeness - not used
+               // Here for completeness - not used.
+               'id' => $comment_id,
                'supplemental' => array(
                        'total_items_i18n' => sprintf( _n( '1 item', '%s items', $total ), number_format_i18n( $total ) ),
                        'total_pages' => ceil( $total / $per_page ),
@@ -289,10 +389,15 @@ function _wp_ajax_delete_comment_response( $comment_id, $delta = -1 ) {
        $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));
@@ -372,6 +477,11 @@ function _wp_ajax_add_hierarchical_term() {
        $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;
 
@@ -415,6 +525,11 @@ function wp_ajax_delete_comment() {
        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" );
@@ -435,6 +550,11 @@ function wp_ajax_delete_tag() {
                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;
 
@@ -452,6 +572,11 @@ function wp_ajax_delete_link() {
                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;
 
@@ -466,6 +591,13 @@ function wp_ajax_delete_meta() {
        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';
@@ -484,6 +616,13 @@ function wp_ajax_delete_post( $action ) {
                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';
@@ -507,6 +646,13 @@ function wp_ajax_trash_post( $action ) {
        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';
@@ -531,6 +677,11 @@ function wp_ajax_delete_page( $action ) {
                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;
 
@@ -546,7 +697,7 @@ function wp_ajax_dim_comment() {
                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" );
@@ -568,6 +719,13 @@ function wp_ajax_dim_comment() {
        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';
@@ -598,11 +756,15 @@ function wp_ajax_add_link_category( $action ) {
        $x->send();
 }
 
+/**
+ * Ajax handler to add a tag.
+ *
+ * @since 3.1.0
+ */
 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);
 
@@ -629,7 +791,7 @@ function wp_ajax_add_tag() {
 
        $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();
@@ -651,17 +813,25 @@ function wp_ajax_add_tag() {
        $x->send();
 }
 
+/**
+ * Ajax handler for getting a tagcloud.
+ *
+ * @since 3.1.0
+ */
 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 );
        }
+       
+       if ( ! current_user_can( $tax->cap->assign_terms ) ) {
+               wp_die( -1 );
+       }
 
        $tags = get_terms( $taxonomy, array( 'number' => 45, 'orderby' => 'count', 'order' => 'DESC' ) );
 
@@ -687,6 +857,13 @@ function wp_ajax_get_tagcloud() {
        wp_die();
 }
 
+/**
+ * Ajax handler for getting comments.
+ *
+ * @since 3.1.0
+ *
+ * @param string $action Action to perform.
+ */
 function wp_ajax_get_comments( $action ) {
        global $wp_list_table, $post_id;
        if ( empty( $action ) )
@@ -694,9 +871,18 @@ function wp_ajax_get_comments( $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' ) );
 
-       if ( !current_user_can( 'edit_post', $post_id ) )
+       if ( ! current_user_can( 'edit_post', $post_id ) )
                wp_die( -1 );
 
        $wp_list_table->prepare_items();
@@ -722,8 +908,15 @@ function wp_ajax_get_comments( $action ) {
        $x->send();
 }
 
+/**
+ * Ajax handler for replying to a comment.
+ *
+ * @since 3.1.0
+ *
+ * @param string $action Action to perform.
+ */
 function wp_ajax_replyto_comment( $action ) {
-       global $wp_list_table, $wpdb;
+       global $wp_list_table;
        if ( empty( $action ) )
                $action = 'replyto-comment';
 
@@ -748,8 +941,12 @@ function wp_ajax_replyto_comment( $action ) {
                $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_content      = trim( $_POST['content'] );
+               $comment_type         = isset( $_POST['comment_type'] ) ? trim( $_POST['comment_type'] ) : '';
                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
@@ -762,11 +959,13 @@ function wp_ajax_replyto_comment( $action ) {
        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');
 
-       // automatically approve parent comment
+       // Automatically approve parent comment.
        if ( !empty($_POST['approve_parent']) ) {
                $parent = get_comment( $comment_parent );
 
@@ -783,19 +982,18 @@ function wp_ajax_replyto_comment( $action ) {
        $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 {
-                       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',
@@ -812,6 +1010,11 @@ function wp_ajax_replyto_comment( $action ) {
        $x->send();
 }
 
+/**
+ * Ajax handler for editing a comment.
+ *
+ * @since 3.1.0
+ */
 function wp_ajax_edit_comment() {
        global $wp_list_table;
 
@@ -824,21 +1027,21 @@ function wp_ajax_edit_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';
-       $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 );
+       if ( empty( $comment->comment_ID ) )
+               wp_die( -1 );
 
        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();
 
@@ -852,6 +1055,11 @@ function wp_ajax_edit_comment() {
        $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' );
 
@@ -905,6 +1113,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 ) )
@@ -923,6 +1132,11 @@ function wp_ajax_add_menu_item() {
        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;
@@ -934,6 +1148,8 @@ function wp_ajax_add_meta() {
                        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()
@@ -1006,6 +1222,13 @@ function wp_ajax_add_meta() {
        $x->send();
 }
 
+/**
+ * Ajax handler for adding a user.
+ *
+ * @since 3.1.0
+ *
+ * @param string $action Action to perform.
+ */
 function wp_ajax_add_user( $action ) {
        global $wp_list_table;
        if ( empty( $action ) )
@@ -1041,69 +1264,11 @@ function wp_ajax_add_user( $action ) {
        $x->send();
 }
 
-function wp_ajax_autosave() {
-       define( 'DOING_AUTOSAVE', true );
-
-       check_ajax_referer( 'autosave', 'autosavenonce' );
-
-       $_POST['post_category'] = explode(",", $_POST['catslist']);
-       if ( $_POST['post_type'] == 'page' || empty($_POST['post_category']) )
-               unset($_POST['post_category']);
-
-       $data = '';
-       $supplemental = array();
-       $id = $revision_id = 0;
-
-       $post_id = (int) $_POST['post_id'];
-       $_POST['ID'] = $_POST['post_ID'] = $post_id;
-       $post = get_post($post_id);
-       if ( 'auto-draft' == $post->post_status )
-               $_POST['post_status'] = 'draft';
-
-       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 ( ! empty( $_POST['autosave'] ) ) {
-               if ( ! wp_check_post_lock( $post->ID ) && get_current_user_id() == $post->post_author && ( 'auto-draft' == $post->post_status || 'draft' == $post->post_status ) ) {
-                       // Drafts and auto-drafts are just overwritten by autosave for the same user if the post is not locked
-                       $id = edit_post();
-               } else {
-                       // Non drafts or other users drafts are not overwritten. The autosave is stored in a special post revision for each user.
-                       $revision_id = wp_create_post_autosave( $post->ID );
-                       if ( is_wp_error($revision_id) )
-                               $id = $revision_id;
-                       else
-                               $id = $post->ID;
-               }
-
-               if ( ! is_wp_error($id) ) {
-                       /* translators: draft saved date format, see http://php.net/date */
-                       $draft_saved_date_format = __('g:i:s a');
-                       /* translators: %s: date and time */
-                       $data = sprintf( __('Draft saved at %s.'), date_i18n( $draft_saved_date_format ) );
-               }
-       } else {
-               if ( ! empty( $_POST['auto_draft'] ) )
-                       $id = 0; // This tells us it didn't actually save
-               else
-                       $id = $post->ID;
-       }
-
-       // @todo Consider exposing any errors, rather than having 'Saving draft...'
-       $x = new WP_Ajax_Response( array(
-               'what' => 'autosave',
-               'id' => $id,
-               'data' => $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();
@@ -1131,10 +1296,14 @@ function wp_ajax_closed_postboxes() {
        wp_die( 1 );
 }
 
+/**
+ * Ajax handler for hidden columns.
+ *
+ * @since 3.1.0
+ */
 function wp_ajax_hidden_columns() {
        check_ajax_referer( 'screen-options-nonce', 'screenoptionnonce' );
-       $hidden = isset( $_POST['hidden'] ) ? $_POST['hidden'] : '';
-       $hidden = explode( ',', $_POST['hidden'] );
+       $hidden = explode( ',', isset( $_POST['hidden'] ) ? $_POST['hidden'] : '' );
        $page = isset( $_POST['page'] ) ? $_POST['page'] : '';
 
        if ( $page != sanitize_key( $page ) )
@@ -1149,6 +1318,11 @@ function wp_ajax_hidden_columns() {
        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' );
 
@@ -1160,6 +1334,11 @@ function wp_ajax_update_welcome_panel() {
        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 );
@@ -1177,7 +1356,10 @@ function wp_ajax_menu_get_metabox() {
        }
 
        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,
@@ -1191,7 +1373,7 @@ function wp_ajax_menu_get_metabox() {
 
                $markup = ob_get_clean();
 
-               echo json_encode(array(
+               echo wp_json_encode(array(
                        'replace-id' => $type . '-' . $item->name,
                        'markup' => $markup,
                ));
@@ -1200,6 +1382,11 @@ function wp_ajax_menu_get_metabox() {
        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' );
 
@@ -1215,12 +1402,17 @@ function wp_ajax_wp_link_ajax() {
        if ( ! isset( $results ) )
                wp_die( 0 );
 
-       echo json_encode( $results );
+       echo wp_json_encode( $results );
        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 );
@@ -1231,6 +1423,11 @@ function wp_ajax_menu_locations_save() {
        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;
@@ -1256,6 +1453,11 @@ function wp_ajax_meta_box_order() {
        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 );
@@ -1267,12 +1469,22 @@ function wp_ajax_menu_quick_search() {
        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 ) ) );
 }
 
+/**
+ * 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;
@@ -1281,6 +1493,11 @@ function wp_ajax_sample_permalink() {
        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
+ */
 function wp_ajax_inline_save() {
        global $wp_list_table;
 
@@ -1307,18 +1524,20 @@ function wp_ajax_inline_save() {
        $data = &$_POST;
 
        $post = get_post( $post_ID, ARRAY_A );
-       $post = wp_slash($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'];
 
-       // 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'];
 
-       // status
+       // Status.
        if ( isset($data['keep_private']) && 'private' == $data['keep_private'] )
                $data['post_status'] = 'private';
        else
@@ -1335,13 +1554,11 @@ function wp_ajax_inline_save() {
                $data['post_name'] = wp_unique_post_slug( $data['post_name'], $post['ID'], $post['post_status'], $post['post_type'], $post['post_parent'] );
        }
 
-       // update the post
+       // Update the post.
        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;
@@ -1357,6 +1574,11 @@ function wp_ajax_inline_save() {
        wp_die();
 }
 
+/**
+ * Ajax handler for quick edit saving for a term.
+ *
+ * @since 3.1.0
+ */
 function wp_ajax_inline_save_tax() {
        global $wp_list_table;
 
@@ -1402,16 +1624,20 @@ function wp_ajax_inline_save_tax() {
        wp_die();
 }
 
+/**
+ * Ajax handler for querying posts for the Find Posts modal.
+ *
+ * @see window.findPosts
+ *
+ * @since 3.1.0
+ */
 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'] );
 
        $s = wp_unslash( $_POST['ps'] );
-       $searchand = $search = '';
        $args = array(
                'post_type' => array_keys( $post_types ),
                'post_status' => 'any',
@@ -1422,12 +1648,15 @@ function wp_ajax_find_posts() {
 
        $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)' );
+               $alt = ( 'alternate' == $alt ) ? '' : 'alternate';
 
                switch ( $post->post_status ) {
                        case 'publish' :
@@ -1452,19 +1681,20 @@ function wp_ajax_find_posts() {
                        $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>';
 
-       $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' );
 
@@ -1473,7 +1703,7 @@ function wp_ajax_widgets_order() {
 
        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 ) {
@@ -1496,6 +1726,11 @@ function wp_ajax_widgets_order() {
        wp_die( -1 );
 }
 
+/**
+ * Ajax handler for saving a widget.
+ *
+ * @since 3.1.0
+ */
 function wp_ajax_save_widget() {
        global $wp_registered_widgets, $wp_registered_widget_controls, $wp_registered_widget_updates;
 
@@ -1506,9 +1741,22 @@ function wp_ajax_save_widget() {
 
        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'];
@@ -1520,7 +1768,7 @@ function wp_ajax_save_widget() {
        $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]) )
@@ -1567,16 +1815,54 @@ function wp_ajax_save_widget() {
        wp_die();
 }
 
+/**
+ * Ajax handler for saving a widget.
+ *
+ * @since 3.9.0
+ */
+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' );
+       /*
+        * 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();
+       }
 
        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();
+               }
        } else {
                $post_id = null;
        }
@@ -1587,7 +1873,7 @@ function wp_ajax_upload_attachment() {
        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 );
                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.' ),
@@ -1602,7 +1888,7 @@ function wp_ajax_upload_attachment() {
        $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(),
@@ -1624,7 +1910,7 @@ function wp_ajax_upload_attachment() {
        if ( ! $attachment = wp_prepare_attachment_for_js( $attachment_id ) )
                wp_die();
 
-       echo json_encode( array(
+       echo wp_json_encode( array(
                'success' => true,
                'data'    => $attachment,
        ) );
@@ -1632,6 +1918,11 @@ function wp_ajax_upload_attachment() {
        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) )
@@ -1644,7 +1935,7 @@ function wp_ajax_image_editor() {
        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' :
@@ -1659,6 +1950,11 @@ function wp_ajax_image_editor() {
        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
 
@@ -1690,41 +1986,94 @@ function wp_ajax_set_post_thumbnail() {
        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() {
-       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() {
-       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
+ */
 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 )
-               $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();
 
-       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 ) {
@@ -1735,17 +2084,21 @@ function wp_ajax_wp_fullscreen_save_post() {
                $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 );
        }
 
-       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 );
@@ -1762,11 +2115,24 @@ function wp_ajax_wp_remove_post_lock() {
        if ( $active_lock[1] != get_current_user_id() )
                wp_die( 0 );
 
-       $new_lock = ( time() - apply_filters( 'wp_check_post_lock_window', 120 ) + 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 );
 }
 
+/**
+ * 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 ) )
@@ -1787,7 +2153,7 @@ function wp_ajax_dismiss_wp_pointer() {
 }
 
 /**
- * Get an attachment.
+ * Ajax handler for getting an attachment.
  *
  * @since 3.5.0
  */
@@ -1814,7 +2180,7 @@ function wp_ajax_get_attachment() {
 }
 
 /**
- * Query for attachments.
+ * Ajax handler for querying attachments.
  *
  * @since 3.5.0
  */
@@ -1825,14 +2191,32 @@ function wp_ajax_query_attachments() {
        $query = isset( $_REQUEST['query'] ) ? (array) $_REQUEST['query'] : array();
        $query = array_intersect_key( $query, array_flip( array(
                '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'
        ) ) );
 
        $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';
 
+       /**
+        * 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 );
@@ -1842,7 +2226,7 @@ function wp_ajax_query_attachments() {
 }
 
 /**
- * Save attachment attributes.
+ * Ajax handler for updating attachment attributes.
  *
  * @since 3.5.0
  */
@@ -1873,6 +2257,9 @@ function wp_ajax_save_attachment() {
        if ( isset( $changes['description'] ) )
                $post['post_content'] = $changes['description'];
 
+       if ( MEDIA_TRASH && isset( $changes['status'] ) )
+               $post['post_status'] = $changes['status'];
+
        if ( isset( $changes['alt'] ) ) {
                $alt = wp_unslash( $changes['alt'] );
                if ( $alt != get_post_meta( $id, '_wp_attachment_image_alt', true ) ) {
@@ -1881,12 +2268,36 @@ function wp_ajax_save_attachment() {
                }
        }
 
-       wp_update_post( $post );
+       if ( 0 === strpos( $post['post_mime_type'], 'audio/' ) ) {
+               $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();
 }
 
 /**
- * Save backwards compatible attachment attributes.
+ * Ajax handler for saving backwards compatible attachment attributes.
  *
  * @since 3.5.0
  */
@@ -1911,6 +2322,7 @@ function wp_ajax_save_attachment_compat() {
        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'] ) ) {
@@ -1931,6 +2343,11 @@ function wp_ajax_save_attachment_compat() {
        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();
@@ -1948,8 +2365,6 @@ function wp_ajax_save_attachment_order() {
        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;
@@ -1965,9 +2380,11 @@ 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.
- * 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
  */
@@ -1992,7 +2409,7 @@ function wp_ajax_send_attachment_to_editor() {
        }
 
        $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 )
@@ -2013,12 +2430,15 @@ function wp_ajax_send_attachment_to_editor() {
                $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 );
 }
 
 /**
+ * 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:
@@ -2029,6 +2449,8 @@ function wp_ajax_send_attachment_to_editor() {
  * @since 3.5.0
  */
 function wp_ajax_send_link_to_editor() {
+       global $post, $wp_embed;
+
        check_ajax_referer( 'media-send-to-editor', 'nonce' );
 
        if ( ! $src = wp_unslash( $_POST['src'] ) )
@@ -2043,9 +2465,22 @@ function wp_ajax_send_link_to_editor() {
        if ( ! $title = trim( wp_unslash( $_POST['title'] ) ) )
                $title = wp_basename( $src );
 
-       $html = '';
-       if ( $title )
+       $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 ( $title ) {
                $html = '<a href="' . esc_url( $src ) . '">' . $title . '</a>';
+       } else {
+               $html = '';
+       }
 
        // Figure out what filter to run:
        $type = 'file';
@@ -2053,15 +2488,18 @@ function wp_ajax_send_link_to_editor() {
                && ( 'audio' == $ext_type || 'video' == $ext_type ) )
                        $type = $ext_type;
 
+       /** This filter is documented in wp-admin/includes/media.php */
        $html = apply_filters( $type . '_send_to_editor_url', $html, $src, $title );
 
        wp_send_json_success( $html );
 }
 
 /**
- * Heartbeat API (experimental)
+ * 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'] ) )
@@ -2075,20 +2513,47 @@ function wp_ajax_heartbeat() {
                wp_send_json($response);
        }
 
-       // screen_id is the same as $current_screen->id and the JS global 'pagenow'
+       // 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 = (array) $_POST['data'];
+               $data = wp_unslash( (array) $_POST['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 );
 
-       // Allow the transport to be replaced with long-polling easily
+       /**
+        * 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
@@ -2097,6 +2562,11 @@ function wp_ajax_heartbeat() {
        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';
 
@@ -2123,3 +2593,239 @@ function wp_ajax_get_revision_diffs() {
        }
        wp_send_json_success( $return );
 }
+
+/**
+ * Ajax handler for auto-saving the selected color scheme for
+ * a user's own profile.
+ *
+ * @since 3.8.0
+ */
+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();
+       }
+
+       update_user_meta( get_current_user_id(), 'admin_color', $color_scheme );
+       wp_send_json_success();
+}
+
+/**
+ * Ajax handler for getting themes from themes_api().
+ *
+ * @since 3.9.0
+ */
+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.
+ */
+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'] );
+       $url = str_replace( '[embed]', '', str_replace( '[/embed]', '', $shortcode ) );
+       $parsed = false;
+       setup_postdata( $post );
+
+       $wp_embed->return_false_on_fail = true;
+
+       if ( is_ssl() && preg_match( '%^\\[embed[^\\]]*\\]http://%i', $shortcode ) ) {
+               // 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 ( ! $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
+       ) );
+}
+
+function wp_ajax_parse_media_shortcode() {
+       global $post, $wp_scripts;
+
+       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();
+       }
+
+       setup_postdata( $post );
+       $shortcode = do_shortcode( wp_unslash( $_POST['shortcode'] ) );
+
+       if ( empty( $shortcode ) ) {
+               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 $shortcode;
+
+       if ( 'playlist' === $_REQUEST['type'] ) {
+               wp_underscore_playlist_templates();
+
+               wp_print_scripts( 'wp-playlist' );
+       } else {
+               wp_print_scripts( '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 ) );
+}