X-Git-Url: https://scripts.mit.edu/gitweb/autoinstalls/wordpress.git/blobdiff_plain/5d244c8fd9a27c9f89dd08da2af6fbc67d4fce63..refs/tags/wordpress-4.3:/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 35a193f1..fcfcd1e3 100644 --- a/wp-admin/includes/class-wp-comments-list-table.php +++ b/wp-admin/includes/class-wp-comments-list-table.php @@ -21,6 +21,10 @@ class WP_Comments_List_Table extends WP_List_Table { public $pending_count = array(); + public $extra_items; + + private $user_can; + /** * Constructor. * @@ -29,6 +33,8 @@ class WP_Comments_List_Table extends WP_List_Table { * * @see WP_List_Table::__construct() for more information on default arguments. * + * @global int $post_id + * * @param array $args An associative array of arguments. */ public function __construct( $args = array() ) { @@ -47,10 +53,20 @@ class WP_Comments_List_Table extends WP_List_Table { ) ); } + /** + * @return bool + */ public function ajax_user_can() { return current_user_can('edit_posts'); } + /** + * + * @global int $post_id + * @global string $comment_status + * @global string $search + * @global string $comment_type + */ public function prepare_items() { global $post_id, $comment_status, $search, $comment_type; @@ -112,22 +128,22 @@ class WP_Comments_List_Table extends WP_List_Table { ); $_comments = get_comments( $args ); + if ( is_array( $_comments ) ) { + update_comment_cache( $_comments ); - update_comment_cache( $_comments ); - - $this->items = array_slice( $_comments, 0, $comments_per_page ); - $this->extra_items = array_slice( $_comments, $comments_per_page ); + $this->items = array_slice( $_comments, 0, $comments_per_page ); + $this->extra_items = array_slice( $_comments, $comments_per_page ); - $total_comments = get_comments( array_merge( $args, array('count' => true, 'offset' => 0, 'number' => 0) ) ); + $_comment_post_ids = array_unique( wp_list_pluck( $_comments, 'comment_post_ID' ) ); - $_comment_post_ids = array(); - foreach ( $_comments as $_c ) { - $_comment_post_ids[] = $_c->comment_post_ID; + $this->pending_count = get_pending_comments_num( $_comment_post_ids ); } - $_comment_post_ids = array_unique( $_comment_post_ids ); - - $this->pending_count = get_pending_comments_num( $_comment_post_ids ); + $total_comments = get_comments( array_merge( $args, array( + 'count' => true, + 'offset' => 0, + 'number' => 0 + ) ) ); $this->set_pagination_args( array( 'total_items' => $total_comments, @@ -135,6 +151,11 @@ class WP_Comments_List_Table extends WP_List_Table { ) ); } + /** + * + * @param string $comment_status + * @return int + */ public function get_per_page( $comment_status = 'all' ) { $comments_per_page = $this->get_items_per_page( 'edit_comments_per_page' ); /** @@ -145,10 +166,13 @@ class WP_Comments_List_Table extends WP_List_Table { * @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; + return apply_filters( 'comments_per_page', $comments_per_page, $comment_status ); } + /** + * + * @global string $comment_status + */ public function no_items() { global $comment_status; @@ -158,6 +182,12 @@ class WP_Comments_List_Table extends WP_List_Table { _e( 'No comments found.' ); } + /** + * + * @global int $post_id + * @global string $comment_status + * @global string $comment_type + */ protected function get_views() { global $post_id, $comment_status, $comment_type; @@ -207,10 +237,15 @@ class WP_Comments_List_Table extends WP_List_Table { * @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; + return apply_filters( 'comment_status_links', $status_links ); } + /** + * + * @global string $comment_status + * + * @return array + */ protected function get_bulk_actions() { global $comment_status; @@ -235,6 +270,13 @@ class WP_Comments_List_Table extends WP_List_Table { return $actions; } + /** + * + * @global string $comment_status + * @global string $comment_type + * + * @param string $which + */ protected function extra_tablenav( $which ) { global $comment_status, $comment_type; ?> @@ -288,6 +330,9 @@ class WP_Comments_List_Table extends WP_List_Table { echo ''; } + /** + * @return string|false + */ public function current_action() { if ( isset( $_REQUEST['delete_all'] ) || isset( $_REQUEST['delete_all2'] ) ) return 'delete_all'; @@ -295,6 +340,12 @@ class WP_Comments_List_Table extends WP_List_Table { return parent::current_action(); } + /** + * + * @global int $post_id + * + * @return array + */ public function get_columns() { global $post_id; @@ -306,12 +357,18 @@ class WP_Comments_List_Table extends WP_List_Table { $columns['author'] = __( 'Author' ); $columns['comment'] = _x( 'Comment', 'column name' ); - if ( !$post_id ) - $columns['response'] = _x( 'In Response To', 'column name' ); + if ( ! $post_id ) { + /* translators: column name or table row header */ + $columns['response'] = __( 'In Response To' ); + } return $columns; } + /** + * + * @return array + */ protected function get_sortable_columns() { return array( 'author' => 'comment_author', @@ -319,25 +376,34 @@ class WP_Comments_List_Table extends WP_List_Table { ); } + /** + * Get the name of the default primary column. + * + * @since 4.3.0 + * @access protected + * + * @return string Name of the default primary column, in this case, 'comment'. + */ + protected function get_default_primary_column_name() { + return 'comment'; + } + + /** + * @access public + */ public function display() { wp_nonce_field( "fetch-list-" . get_class( $this ), '_ajax_fetch_list_nonce' ); $this->display_tablenav( 'top' ); ?> - +
print_column_headers(); ?> - - - print_column_headers( false ); ?> - - - display_rows_or_placeholder(); ?> @@ -345,17 +411,34 @@ class WP_Comments_List_Table extends WP_List_Table { items = $this->extra_items; $this->display_rows(); ?> + + + + print_column_headers( false ); ?> + + +
display_tablenav( 'bottom' ); } + /** + * + * @global WP_Post $post + * @global object $comment + * + * @param object $a_comment + */ public function single_row( $a_comment ) { global $post, $comment; $comment = $a_comment; $the_comment_class = wp_get_comment_status( $comment->comment_ID ); + if ( ! $the_comment_class ) { + $the_comment_class = ''; + } $the_comment_class = join( ' ', get_comment_class( $the_comment_class, $comment->comment_ID, $comment->comment_post_ID ) ); $post = get_post( $comment->comment_post_ID ); @@ -367,6 +450,125 @@ class WP_Comments_List_Table extends WP_List_Table { echo "\n"; } + /** + * Generate and display row actions links. + * + * @since 4.3.0 + * @access protected + * + * @param object $comment Comment being acted upon. + * @param string $column_name Current column name. + * @param string $primary Primary column name. + * @return string|void Comment row actions output. + */ + protected function handle_row_actions( $comment, $column_name, $primary ) { + global $comment_status; + + if ( $primary !== $column_name ) { + return ''; + } + + if ( ! $this->user_can ) { + return; + } + + $the_comment_status = wp_get_comment_status( $comment->comment_ID ); + + $out = ''; + + $del_nonce = esc_html( '_wpnonce=' . wp_create_nonce( "delete-comment_$comment->comment_ID" ) ); + $approve_nonce = esc_html( '_wpnonce=' . wp_create_nonce( "approve-comment_$comment->comment_ID" ) ); + + $url = "comment.php?c=$comment->comment_ID"; + + $approve_url = esc_url( $url . "&action=approvecomment&$approve_nonce" ); + $unapprove_url = esc_url( $url . "&action=unapprovecomment&$approve_nonce" ); + $spam_url = esc_url( $url . "&action=spamcomment&$del_nonce" ); + $unspam_url = esc_url( $url . "&action=unspamcomment&$del_nonce" ); + $trash_url = esc_url( $url . "&action=trashcomment&$del_nonce" ); + $untrash_url = esc_url( $url . "&action=untrashcomment&$del_nonce" ); + $delete_url = esc_url( $url . "&action=deletecomment&$del_nonce" ); + + // Preorder it: Approve | Reply | Quick Edit | Edit | Spam | Trash. + $actions = array( + 'approve' => '', 'unapprove' => '', + 'reply' => '', + 'quickedit' => '', + 'edit' => '', + 'spam' => '', 'unspam' => '', + 'trash' => '', 'untrash' => '', 'delete' => '' + ); + + // Not looking at all comments. + if ( $comment_status && 'all' != $comment_status ) { + if ( 'approved' == $the_comment_status ) { + $actions['unapprove'] = "" . __( 'Unapprove' ) . ''; + } elseif ( 'unapproved' == $the_comment_status ) { + $actions['approve'] = "" . __( 'Approve' ) . ''; + } + } else { + $actions['approve'] = "" . __( 'Approve' ) . ''; + $actions['unapprove'] = "" . __( 'Unapprove' ) . ''; + } + + if ( 'spam' != $the_comment_status ) { + $actions['spam'] = "" . /* translators: mark as spam link */ _x( 'Spam', 'verb' ) . ''; + } elseif ( 'spam' == $the_comment_status ) { + $actions['unspam'] = "" . _x( 'Not Spam', 'comment' ) . ''; + } + + if ( 'trash' == $the_comment_status ) { + $actions['untrash'] = "" . __( 'Restore' ) . ''; + } + + if ( 'spam' == $the_comment_status || 'trash' == $the_comment_status || !EMPTY_TRASH_DAYS ) { + $actions['delete'] = "" . __( 'Delete Permanently' ) . ''; + } else { + $actions['trash'] = "" . _x( 'Trash', 'verb' ) . ''; + } + + if ( 'spam' != $the_comment_status && 'trash' != $the_comment_status ) { + $actions['edit'] = "". __( 'Edit' ) . ''; + + $format = '%s'; + + $actions['quickedit'] = sprintf( $format, $comment->comment_ID, $comment->comment_post_ID, 'edit', 'vim-q comment-inline',esc_attr__( 'Edit this item inline' ), __( 'Quick Edit' ) ); + + $actions['reply'] = sprintf( $format, $comment->comment_ID, $comment->comment_post_ID, 'replyto', 'vim-r comment-inline', esc_attr__( 'Reply to this comment' ), __( 'Reply' ) ); + } + + /** This filter is documented in wp-admin/includes/dashboard.php */ + $actions = apply_filters( 'comment_row_actions', array_filter( $actions ), $comment ); + + $i = 0; + $out .= '
'; + foreach ( $actions as $action => $link ) { + ++$i; + ( ( ( 'approve' == $action || 'unapprove' == $action ) && 2 === $i ) || 1 === $i ) ? $sep = '' : $sep = ' | '; + + // Reply and quickedit need a hide-if-no-js span when not added with ajax + if ( ( 'reply' == $action || 'quickedit' == $action ) && ! defined('DOING_AJAX') ) + $action .= ' hide-if-no-js'; + elseif ( ( $action == 'untrash' && $the_comment_status == 'trash' ) || ( $action == 'unspam' && $the_comment_status == 'spam' ) ) { + if ( '1' == get_comment_meta( $comment->comment_ID, '_wp_trash_meta_status', true ) ) + $action .= ' approve'; + else + $action .= ' unapprove'; + } + + $out .= "$sep$link"; + } + $out .= '
'; + + $out .= ''; + + return $out; + } + + /** + * + * @param object $comment + */ public function column_cb( $comment ) { if ( $this->user_can ) { ?> @@ -375,29 +577,11 @@ class WP_Comments_List_Table extends WP_List_Table { } } + /** + * @param object $comment + */ public function column_comment( $comment ) { - global $comment_status; - $post = get_post(); - - $user_can = $this->user_can; - $comment_url = esc_url( get_comment_link( $comment->comment_ID ) ); - $the_comment_status = wp_get_comment_status( $comment->comment_ID ); - - if ( $user_can ) { - $del_nonce = esc_html( '_wpnonce=' . wp_create_nonce( "delete-comment_$comment->comment_ID" ) ); - $approve_nonce = esc_html( '_wpnonce=' . wp_create_nonce( "approve-comment_$comment->comment_ID" ) ); - - $url = "comment.php?c=$comment->comment_ID"; - - $approve_url = esc_url( $url . "&action=approvecomment&$approve_nonce" ); - $unapprove_url = esc_url( $url . "&action=unapprovecomment&$approve_nonce" ); - $spam_url = esc_url( $url . "&action=spamcomment&$del_nonce" ); - $unspam_url = esc_url( $url . "&action=unspamcomment&$del_nonce" ); - $trash_url = esc_url( $url . "&action=trashcomment&$del_nonce" ); - $untrash_url = esc_url( $url . "&action=untrashcomment&$del_nonce" ); - $delete_url = esc_url( $url . "&action=deletecomment&$del_nonce" ); - } echo '
'; $this->column_author( $comment ); @@ -420,7 +604,7 @@ class WP_Comments_List_Table extends WP_List_Table { echo '
'; comment_text(); - if ( $user_can ) { ?> + if ( $this->user_can ) { ?>