WordPress 3.8

[autoinstalls/wordpress.git] / wp-admin / includes / class-wp-comments-list-table.php

diff --git a/wp-admin/includes/class-wp-comments-list-table.php b/wp-admin/includes/class-wp-comments-list-table.php
index 23f3169d04a47d5916703220f9d44d04b6952536..711d742efc8783014a390cf499417b0569f1b039 100644 (file)
--- a/wp-admin/includes/class-wp-comments-list-table.php
+++ b/wp-admin/includes/class-wp-comments-list-table.php
@@ -52,6 +52,8 @@ class WP_Comments_List_Table extends WP_List_Table {
 
                $search = ( isset( $_REQUEST['s'] ) ) ? $_REQUEST['s'] : '';
 
+               $post_type = ( isset( $_REQUEST['post_type'] ) ) ? sanitize_key( $_REQUEST['post_type'] ) : '';
+
                $user_id = ( isset( $_REQUEST['user_id'] ) ) ? $_REQUEST['user_id'] : '';
 
                $orderby = ( isset( $_REQUEST['orderby'] ) ) ? $_REQUEST['orderby'] : '';
@@ -96,6 +98,7 @@ class WP_Comments_List_Table extends WP_List_Table {
                        'type' => $comment_type,
                        'orderby' => $orderby,
                        'order' => $order,
+                       'post_type' => $post_type,
                );
 
                $_comments = get_comments( $args );
@@ -124,6 +127,14 @@ class WP_Comments_List_Table extends WP_List_Table {
 
        function get_per_page( $comment_status = 'all' ) {
                $comments_per_page = $this->get_items_per_page( 'edit_comments_per_page' );
+               /**
+                * Filter the number of comments listed per page in the comments list table.
+                *
+                * @since 2.6.0
+                *
+                * @param int    $comments_per_page The number of comments to list per page.
+                * @param string $comment_status    The comment status name. Default 'All'.
+                */
                $comments_per_page = apply_filters( 'comments_per_page', $comments_per_page, $comment_status );
                return $comments_per_page;
        }
@@ -178,6 +189,14 @@ class WP_Comments_List_Table extends WP_List_Table {
                        ) . '</a>';
                }
 
+               /**
+                * Filter the comment status links.
+                *
+                * @since 2.5.0
+                *
+                * @param array $status_links An array of fully-formed status links. Default 'All'.
+                *                            Accepts 'All', 'Pending', 'Approved', 'Spam', and 'Trash'.
+                */
                $status_links = apply_filters( 'comment_status_links', $status_links );
                return $status_links;
        }
@@ -216,6 +235,13 @@ class WP_Comments_List_Table extends WP_List_Table {
                        <select name="comment_type">
                                <option value=""><?php _e( 'Show all comment types' ); ?></option>
 <?php
+                               /**
+                                * Filter the comment types dropdown menu.
+                                *
+                                * @since 2.7.0
+                                *
+                                * @param array $comment_types An array of comment types. Accepts 'Comments', 'Pings'.
+                                */
                                $comment_types = apply_filters( 'admin_comment_types_dropdown', array(
                                        'comment' => __( 'Comments' ),
                                        'pings' => __( 'Pings' ),
@@ -226,6 +252,11 @@ class WP_Comments_List_Table extends WP_List_Table {
                        ?>
                        </select>
 <?php
+                       /**
+                        * Fires just before the Filter submit button for comment types.
+                        *
+                        * @since 3.5.0
+                        */
                        do_action( 'restrict_manage_comments' );
                        submit_button( __( 'Filter' ), 'button', false, false, array( 'id' => 'post-query-submit' ) );
                }
@@ -235,6 +266,13 @@ class WP_Comments_List_Table extends WP_List_Table {
                        $title = ( 'spam' == $comment_status ) ? esc_attr__( 'Empty Spam' ) : esc_attr__( 'Empty Trash' );
                        submit_button( $title, 'apply', 'delete_all', false );
                }
+               /**
+                * Fires after the Filter submit button for comment types.
+                *
+                * @since 2.5.0
+                *
+                * @param string $comment_status The comment status name. Default 'All'.
+                */
                do_action( 'manage_comments_nav', $comment_status );
                echo '</div>';
        }
@@ -308,7 +346,8 @@ class WP_Comments_List_Table extends WP_List_Table {
                global $post, $comment;
 
                $comment = $a_comment;
-               $the_comment_class = join( ' ', get_comment_class( wp_get_comment_status( $comment->comment_ID ) ) );
+               $the_comment_class = wp_get_comment_status( $comment->comment_ID );
+               $the_comment_class = join( ' ', get_comment_class( $the_comment_class, $comment->comment_ID, $comment->comment_post_ID ) );
 
                $post = get_post( $comment->comment_post_ID );
 
@@ -370,7 +409,10 @@ class WP_Comments_List_Table extends WP_List_Table {
                comment_text();
                if ( $user_can ) { ?>
                <div id="inline-<?php echo $comment->comment_ID; ?>" class="hidden">
-               <textarea class="comment" rows="1" cols="1"><?php echo esc_textarea( apply_filters( 'comment_edit_pre', $comment->comment_content ) ); ?></textarea>
+               <textarea class="comment" rows="1" cols="1"><?php
+                       /** This filter is documented in wp-admin/includes/comment.php */
+                       echo esc_textarea( apply_filters( 'comment_edit_pre', $comment->comment_content ) );
+               ?></textarea>
                <div class="author-email"><?php echo esc_attr( $comment->comment_author_email ); ?></div>
                <div class="author"><?php echo esc_attr( $comment->comment_author ); ?></div>
                <div class="author-url"><?php echo esc_attr( $comment->comment_author_url ); ?></div>
@@ -420,6 +462,7 @@ class WP_Comments_List_Table extends WP_List_Table {
                                $actions['reply'] = '<a onclick="commentReply.open( \''.$comment->comment_ID.'\',\''.$post->ID.'\' );return false;" class="vim-r" title="'.esc_attr__( 'Reply to this comment' ).'" href="#">' . __( 'Reply' ) . '</a>';
                        }
 
+                       /** This filter is documented in wp-admin/includes/dashboard.php */
                        $actions = apply_filters( 'comment_row_actions', array_filter( $actions ), $comment );
 
                        $i = 0;
@@ -507,6 +550,14 @@ class WP_Comments_List_Table extends WP_List_Table {
        }
 
        function column_default( $comment, $column_name ) {
+               /**
+                * Fires when the default column output is displayed for a single row.
+                *
+                * @since 2.8.0
+                *
+                * @param string $column_name         The custom column's name.
+                * @param int    $comment->comment_ID The custom column's unique ID number.
+                */
                do_action( 'manage_comments_custom_column', $column_name, $comment->comment_ID );
        }
 }