X-Git-Url: https://scripts.mit.edu/gitweb/autoinstalls/wordpress.git/blobdiff_plain/f5fcdc7994bb67cce809bc4777944ae8b7fad4a4..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 86358547..fcfcd1e3 100644
--- a/wp-admin/includes/class-wp-comments-list-table.php
+++ b/wp-admin/includes/class-wp-comments-list-table.php
@@ -33,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() ) {
@@ -51,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;
@@ -116,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,
@@ -139,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' );
/**
@@ -149,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;
@@ -162,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;
@@ -211,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;
@@ -239,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;
?>
@@ -292,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';
@@ -299,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;
@@ -310,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',
@@ -323,13 +376,28 @@ 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(); ?>
@@ -356,6 +424,13 @@ class WP_Comments_List_Table extends WP_List_Table {
$this->display_tablenav( 'bottom' );
}
+ /**
+ *
+ * @global WP_Post $post
+ * @global object $comment
+ *
+ * @param object $a_comment
+ */
public function single_row( $a_comment ) {
global $post, $comment;
@@ -375,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 ) { ?>
@@ -383,27 +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();
-
$comment_url = esc_url( get_comment_link( $comment->comment_ID ) );
- $the_comment_status = wp_get_comment_status( $comment->comment_ID );
-
- if ( $this->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 '
user_can ) {
- // 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, $post->ID, 'edit', 'vim-q comment-inline',esc_attr__( 'Edit this item inline' ), __( 'Quick Edit' ) );
-
- $actions['reply'] = sprintf( $format, $comment->comment_ID, $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;
- echo '';
- 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';
- }
-
- echo "$sep$link";
- }
- echo '
';
- }
}
+ /**
+ *
+ * @global string $comment_status
+ *
+ * @param object $comment
+ */
public function column_author( $comment ) {
global $comment_status;
@@ -545,13 +656,24 @@ class WP_Comments_List_Table extends WP_List_Table {
}
}
+ /**
+ *
+ * @return string
+ */
public function column_date() {
return get_comment_date( __( 'Y/m/d \a\t g:i a' ) );
}
+ /**
+ * @access public
+ */
public function column_response() {
$post = get_post();
+ if ( ! $post ) {
+ return;
+ }
+
if ( isset( $this->pending_count[$post->ID] ) ) {
$pending_comments = $this->pending_count[$post->ID];
} else {
@@ -560,23 +682,30 @@ class WP_Comments_List_Table extends WP_List_Table {
}
if ( current_user_can( 'edit_post', $post->ID ) ) {
- $post_link = "";
+ $post_link = "';
} else {
$post_link = esc_html( get_the_title( $post->ID ) );
}
- echo '';
- echo $post_link . '
';
+ echo '';
+ if ( 'attachment' == $post->post_type && ( $thumb = wp_get_attachment_image( $post->ID, array( 80, 60 ), true ) ) ) {
+ echo $thumb;
+ }
+ echo $post_link;
+ $post_type_object = get_post_type_object( $post->post_type );
+ echo "';
+ echo '
';
$this->comments_bubble( $post->ID, $pending_comments );
echo ' ';
- $post_type_object = get_post_type_object( $post->post_type );
- echo "
" . $post_type_object->labels->view_item . '';
echo '
';
- if ( 'attachment' == $post->post_type && ( $thumb = wp_get_attachment_image( $post->ID, array( 80, 60 ), true ) ) )
- echo $thumb;
}
+ /**
+ *
+ * @param object $comment
+ * @param string $column_name
+ */
public function column_default( $comment, $column_name ) {
/**
* Fires when the default column output is displayed for a single row.
@@ -602,6 +731,10 @@ class WP_Comments_List_Table extends WP_List_Table {
*/
class WP_Post_Comments_List_Table extends WP_Comments_List_Table {
+ /**
+ *
+ * @return array
+ */
protected function get_column_info() {
return array(
array(
@@ -610,15 +743,25 @@ class WP_Post_Comments_List_Table extends WP_Comments_List_Table {
),
array(),
array(),
+ 'comment',
);
}
+ /**
+ *
+ * @return array
+ */
protected function get_table_classes() {
$classes = parent::get_table_classes();
+ $classes[] = 'wp-list-table';
$classes[] = 'comments-box';
return $classes;
}
+ /**
+ *
+ * @param bool $output_empty
+ */
public function display( $output_empty = false ) {
$singular = $this->_args['singular'];
@@ -637,6 +780,11 @@ class WP_Post_Comments_List_Table extends WP_Comments_List_Table {