2010-10-24 22:57:43 -04:00
|
|
|
<?php
|
|
|
|
/**
|
2015-10-17 11:13:25 -04:00
|
|
|
* List Table API: WP_Comments_List_Table class
|
2010-10-24 22:57:43 -04:00
|
|
|
*
|
|
|
|
* @package WordPress
|
2015-10-17 11:13:25 -04:00
|
|
|
* @subpackage Administration
|
2010-10-25 00:04:18 -04:00
|
|
|
* @since 3.1.0
|
2010-10-24 22:57:43 -04:00
|
|
|
*/
|
|
|
|
|
2010-10-25 00:04:18 -04:00
|
|
|
/**
|
2015-10-17 11:13:25 -04:00
|
|
|
* Core class used to implement displaying comments in a list table.
|
2010-10-25 00:04:18 -04:00
|
|
|
*
|
|
|
|
* @since 3.1.0
|
2015-10-17 11:13:25 -04:00
|
|
|
*
|
|
|
|
* @see WP_List_Table
|
2010-10-25 00:04:18 -04:00
|
|
|
*/
|
2010-11-04 04:07:03 -04:00
|
|
|
class WP_Comments_List_Table extends WP_List_Table {
|
2010-10-24 22:57:43 -04:00
|
|
|
|
2014-05-18 19:59:15 -04:00
|
|
|
public $checkbox = true;
|
2010-10-24 22:57:43 -04:00
|
|
|
|
2014-05-18 19:59:15 -04:00
|
|
|
public $pending_count = array();
|
2010-10-24 22:57:43 -04:00
|
|
|
|
2014-12-20 18:27:25 -05:00
|
|
|
public $extra_items;
|
|
|
|
|
2015-01-12 11:02:24 -05:00
|
|
|
private $user_can;
|
|
|
|
|
2014-08-09 22:18:17 -04:00
|
|
|
/**
|
|
|
|
* Constructor.
|
2014-09-04 11:23:16 -04:00
|
|
|
*
|
2014-08-09 22:18:17 -04:00
|
|
|
* @since 3.1.0
|
|
|
|
*
|
|
|
|
* @see WP_List_Table::__construct() for more information on default arguments.
|
|
|
|
*
|
2016-02-05 13:50:25 -05:00
|
|
|
* @global int $post_id
|
2015-05-28 17:41:30 -04:00
|
|
|
*
|
2014-08-09 22:18:17 -04:00
|
|
|
* @param array $args An associative array of arguments.
|
2014-09-04 11:23:16 -04:00
|
|
|
*/
|
2014-05-18 19:59:15 -04:00
|
|
|
public function __construct( $args = array() ) {
|
2010-11-29 15:15:04 -05:00
|
|
|
global $post_id;
|
2010-10-24 22:57:43 -04:00
|
|
|
|
2016-02-05 13:50:25 -05:00
|
|
|
$post_id = isset( $_REQUEST['p'] ) ? absint( $_REQUEST['p'] ) : 0;
|
2010-10-24 22:57:43 -04:00
|
|
|
|
2015-08-31 16:59:21 -04:00
|
|
|
if ( get_option( 'show_avatars' ) ) {
|
|
|
|
add_filter( 'comment_author', array( $this, 'floated_admin_avatar' ), 10, 2 );
|
|
|
|
}
|
2010-10-24 22:57:43 -04:00
|
|
|
|
2017-11-30 18:11:00 -05:00
|
|
|
parent::__construct(
|
|
|
|
array(
|
|
|
|
'plural' => 'comments',
|
|
|
|
'singular' => 'comment',
|
|
|
|
'ajax' => true,
|
|
|
|
'screen' => isset( $args['screen'] ) ? $args['screen'] : null,
|
|
|
|
)
|
|
|
|
);
|
2010-10-24 22:57:43 -04:00
|
|
|
}
|
|
|
|
|
2020-03-25 10:43:11 -04:00
|
|
|
/**
|
|
|
|
* Adds avatars to comment author names.
|
|
|
|
*
|
|
|
|
* @since 3.1.0
|
|
|
|
*
|
|
|
|
* @param string $name Comment author name.
|
2021-04-18 09:55:07 -04:00
|
|
|
* @param int $comment_id Comment ID.
|
2020-03-25 10:43:11 -04:00
|
|
|
* @return string Avatar with the user name.
|
|
|
|
*/
|
2021-04-18 09:55:07 -04:00
|
|
|
public function floated_admin_avatar( $name, $comment_id ) {
|
|
|
|
$comment = get_comment( $comment_id );
|
2017-11-30 18:11:00 -05:00
|
|
|
$avatar = get_avatar( $comment, 32, 'mystery' );
|
2015-08-31 16:59:21 -04:00
|
|
|
return "$avatar $name";
|
|
|
|
}
|
|
|
|
|
2015-05-29 16:17:26 -04:00
|
|
|
/**
|
|
|
|
* @return bool
|
|
|
|
*/
|
2014-05-18 19:59:15 -04:00
|
|
|
public function ajax_user_can() {
|
2017-11-30 18:11:00 -05:00
|
|
|
return current_user_can( 'edit_posts' );
|
2010-10-24 22:57:43 -04:00
|
|
|
}
|
|
|
|
|
2015-05-28 17:41:30 -04:00
|
|
|
/**
|
2020-07-28 12:55:04 -04:00
|
|
|
* @global string $mode List table view mode.
|
2016-02-05 13:50:25 -05:00
|
|
|
* @global int $post_id
|
2015-05-28 17:41:30 -04:00
|
|
|
* @global string $comment_status
|
|
|
|
* @global string $comment_type
|
2020-07-10 12:04:05 -04:00
|
|
|
* @global string $search
|
2015-05-28 17:41:30 -04:00
|
|
|
*/
|
2014-05-18 19:59:15 -04:00
|
|
|
public function prepare_items() {
|
2020-07-28 12:55:04 -04:00
|
|
|
global $mode, $post_id, $comment_status, $comment_type, $search;
|
2020-07-10 12:04:05 -04:00
|
|
|
|
|
|
|
if ( ! empty( $_REQUEST['mode'] ) ) {
|
2020-07-12 07:36:04 -04:00
|
|
|
$mode = 'excerpt' === $_REQUEST['mode'] ? 'excerpt' : 'list';
|
2020-07-10 12:04:05 -04:00
|
|
|
set_user_setting( 'posts_list_mode', $mode );
|
2020-07-28 12:55:04 -04:00
|
|
|
} else {
|
|
|
|
$mode = get_user_setting( 'posts_list_mode', 'list' );
|
2020-07-10 12:04:05 -04:00
|
|
|
}
|
2010-10-24 22:57:43 -04:00
|
|
|
|
|
|
|
$comment_status = isset( $_REQUEST['comment_status'] ) ? $_REQUEST['comment_status'] : 'all';
|
2021-05-03 10:10:00 -04:00
|
|
|
|
2020-04-04 23:02:11 -04:00
|
|
|
if ( ! in_array( $comment_status, array( 'all', 'mine', 'moderated', 'approved', 'spam', 'trash' ), true ) ) {
|
2010-10-24 22:57:43 -04:00
|
|
|
$comment_status = 'all';
|
2017-11-30 18:11:00 -05:00
|
|
|
}
|
2010-10-24 22:57:43 -04:00
|
|
|
|
2017-11-30 18:11:00 -05:00
|
|
|
$comment_type = ! empty( $_REQUEST['comment_type'] ) ? $_REQUEST['comment_type'] : '';
|
2010-10-24 22:57:43 -04:00
|
|
|
|
|
|
|
$search = ( isset( $_REQUEST['s'] ) ) ? $_REQUEST['s'] : '';
|
|
|
|
|
2013-09-20 16:16:11 -04:00
|
|
|
$post_type = ( isset( $_REQUEST['post_type'] ) ) ? sanitize_key( $_REQUEST['post_type'] ) : '';
|
|
|
|
|
2010-10-24 22:57:43 -04:00
|
|
|
$user_id = ( isset( $_REQUEST['user_id'] ) ) ? $_REQUEST['user_id'] : '';
|
|
|
|
|
2010-11-24 06:19:23 -05:00
|
|
|
$orderby = ( isset( $_REQUEST['orderby'] ) ) ? $_REQUEST['orderby'] : '';
|
2017-11-30 18:11:00 -05:00
|
|
|
$order = ( isset( $_REQUEST['order'] ) ) ? $_REQUEST['order'] : '';
|
2010-12-13 16:21:50 -05:00
|
|
|
|
2010-12-29 10:58:46 -05:00
|
|
|
$comments_per_page = $this->get_per_page( $comment_status );
|
2010-10-24 22:57:43 -04:00
|
|
|
|
2016-08-23 10:33:30 -04:00
|
|
|
$doing_ajax = wp_doing_ajax();
|
2010-12-14 06:53:31 -05:00
|
|
|
|
|
|
|
if ( isset( $_REQUEST['number'] ) ) {
|
|
|
|
$number = (int) $_REQUEST['number'];
|
2017-11-30 18:11:00 -05:00
|
|
|
} else {
|
2020-01-28 19:45:18 -05:00
|
|
|
$number = $comments_per_page + min( 8, $comments_per_page ); // Grab a few extra.
|
2010-12-14 06:53:31 -05:00
|
|
|
}
|
2010-10-24 22:57:43 -04:00
|
|
|
|
|
|
|
$page = $this->get_pagenum();
|
2011-01-05 23:11:14 -05:00
|
|
|
|
2010-12-22 14:03:43 -05:00
|
|
|
if ( isset( $_REQUEST['start'] ) ) {
|
|
|
|
$start = $_REQUEST['start'];
|
|
|
|
} else {
|
|
|
|
$start = ( $page - 1 ) * $comments_per_page;
|
|
|
|
}
|
2011-01-05 23:11:14 -05:00
|
|
|
|
2010-12-14 06:53:31 -05:00
|
|
|
if ( $doing_ajax && isset( $_REQUEST['offset'] ) ) {
|
|
|
|
$start += $_REQUEST['offset'];
|
|
|
|
}
|
2010-10-24 22:57:43 -04:00
|
|
|
|
|
|
|
$status_map = array(
|
2018-02-09 13:46:31 -05:00
|
|
|
'mine' => '',
|
2010-10-24 22:57:43 -04:00
|
|
|
'moderated' => 'hold',
|
2017-11-30 18:11:00 -05:00
|
|
|
'approved' => 'approve',
|
|
|
|
'all' => '',
|
2010-10-24 22:57:43 -04:00
|
|
|
);
|
2010-12-13 16:21:50 -05:00
|
|
|
|
2010-10-24 22:57:43 -04:00
|
|
|
$args = array(
|
2017-11-30 18:11:00 -05:00
|
|
|
'status' => isset( $status_map[ $comment_status ] ) ? $status_map[ $comment_status ] : $comment_status,
|
|
|
|
'search' => $search,
|
|
|
|
'user_id' => $user_id,
|
|
|
|
'offset' => $start,
|
|
|
|
'number' => $number,
|
|
|
|
'post_id' => $post_id,
|
|
|
|
'type' => $comment_type,
|
|
|
|
'orderby' => $orderby,
|
|
|
|
'order' => $order,
|
2013-09-20 16:16:11 -04:00
|
|
|
'post_type' => $post_type,
|
2010-10-24 22:57:43 -04:00
|
|
|
);
|
|
|
|
|
2017-12-29 13:21:52 -05:00
|
|
|
/**
|
|
|
|
* Filters the arguments for the comment query in the comments list table.
|
|
|
|
*
|
2019-01-09 20:40:51 -05:00
|
|
|
* @since 5.1.0
|
2017-12-29 13:21:52 -05:00
|
|
|
*
|
|
|
|
* @param array $args An array of get_comments() arguments.
|
|
|
|
*/
|
|
|
|
$args = apply_filters( 'comments_list_table_query_args', $args );
|
|
|
|
|
2010-10-24 22:57:43 -04:00
|
|
|
$_comments = get_comments( $args );
|
2021-05-03 10:10:00 -04:00
|
|
|
|
2015-05-25 13:59:25 -04:00
|
|
|
if ( is_array( $_comments ) ) {
|
|
|
|
update_comment_cache( $_comments );
|
2010-10-24 22:57:43 -04:00
|
|
|
|
2017-11-30 18:11:00 -05:00
|
|
|
$this->items = array_slice( $_comments, 0, $comments_per_page );
|
2015-05-25 13:59:25 -04:00
|
|
|
$this->extra_items = array_slice( $_comments, $comments_per_page );
|
2010-10-24 22:57:43 -04:00
|
|
|
|
2015-05-25 13:59:25 -04:00
|
|
|
$_comment_post_ids = array_unique( wp_list_pluck( $_comments, 'comment_post_ID' ) );
|
2010-10-24 22:57:43 -04:00
|
|
|
|
2015-05-25 13:59:25 -04:00
|
|
|
$this->pending_count = get_pending_comments_num( $_comment_post_ids );
|
2010-10-24 22:57:43 -04:00
|
|
|
}
|
|
|
|
|
2017-11-30 18:11:00 -05:00
|
|
|
$total_comments = get_comments(
|
|
|
|
array_merge(
|
2018-08-16 21:51:36 -04:00
|
|
|
$args,
|
|
|
|
array(
|
2017-11-30 18:11:00 -05:00
|
|
|
'count' => true,
|
|
|
|
'offset' => 0,
|
|
|
|
'number' => 0,
|
|
|
|
)
|
|
|
|
)
|
|
|
|
);
|
2010-10-24 22:57:43 -04:00
|
|
|
|
2017-11-30 18:11:00 -05:00
|
|
|
$this->set_pagination_args(
|
|
|
|
array(
|
|
|
|
'total_items' => $total_comments,
|
|
|
|
'per_page' => $comments_per_page,
|
|
|
|
)
|
|
|
|
);
|
2010-10-24 22:57:43 -04:00
|
|
|
}
|
2011-01-05 23:11:14 -05:00
|
|
|
|
2015-05-29 17:32:24 -04:00
|
|
|
/**
|
|
|
|
* @param string $comment_status
|
|
|
|
* @return int
|
|
|
|
*/
|
2014-05-18 19:59:15 -04:00
|
|
|
public function get_per_page( $comment_status = 'all' ) {
|
2010-12-29 10:58:46 -05:00
|
|
|
$comments_per_page = $this->get_items_per_page( 'edit_comments_per_page' );
|
2021-05-03 10:10:00 -04:00
|
|
|
|
2013-11-13 14:47:10 -05:00
|
|
|
/**
|
2016-05-22 14:01:30 -04:00
|
|
|
* Filters the number of comments listed per page in the comments list table.
|
2013-11-13 14:47:10 -05:00
|
|
|
*
|
|
|
|
* @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'.
|
|
|
|
*/
|
2015-05-29 16:17:26 -04:00
|
|
|
return apply_filters( 'comments_per_page', $comments_per_page, $comment_status );
|
2010-12-29 10:58:46 -05:00
|
|
|
}
|
2010-10-24 22:57:43 -04:00
|
|
|
|
2015-05-28 17:41:30 -04:00
|
|
|
/**
|
|
|
|
* @global string $comment_status
|
|
|
|
*/
|
2014-05-18 19:59:15 -04:00
|
|
|
public function no_items() {
|
2010-10-30 21:17:00 -04:00
|
|
|
global $comment_status;
|
|
|
|
|
2015-09-22 02:06:25 -04:00
|
|
|
if ( 'moderated' === $comment_status ) {
|
2012-01-09 14:53:51 -05:00
|
|
|
_e( 'No comments awaiting moderation.' );
|
2020-02-09 23:57:06 -05:00
|
|
|
} elseif ( 'trash' === $comment_status ) {
|
|
|
|
_e( 'No comments found in Trash.' );
|
2015-09-22 02:06:25 -04:00
|
|
|
} else {
|
2010-10-30 21:17:00 -04:00
|
|
|
_e( 'No comments found.' );
|
2015-09-22 02:06:25 -04:00
|
|
|
}
|
2010-10-30 21:17:00 -04:00
|
|
|
}
|
|
|
|
|
2015-05-28 17:41:30 -04:00
|
|
|
/**
|
2016-02-05 13:50:25 -05:00
|
|
|
* @global int $post_id
|
2015-05-28 17:41:30 -04:00
|
|
|
* @global string $comment_status
|
|
|
|
* @global string $comment_type
|
|
|
|
*/
|
2014-07-13 18:09:16 -04:00
|
|
|
protected function get_views() {
|
2012-04-04 13:36:23 -04:00
|
|
|
global $post_id, $comment_status, $comment_type;
|
2010-10-24 22:57:43 -04:00
|
|
|
|
|
|
|
$status_links = array();
|
|
|
|
$num_comments = ( $post_id ) ? wp_count_comments( $post_id ) : wp_count_comments();
|
2016-06-02 11:07:28 -04:00
|
|
|
|
2010-10-24 22:57:43 -04:00
|
|
|
$stati = array(
|
2019-09-02 20:41:05 -04:00
|
|
|
/* translators: %s: Number of comments. */
|
2017-11-30 18:11:00 -05:00
|
|
|
'all' => _nx_noop(
|
2015-11-18 13:04:28 -05:00
|
|
|
'All <span class="count">(%s)</span>',
|
|
|
|
'All <span class="count">(%s)</span>',
|
|
|
|
'comments'
|
2020-01-28 19:45:18 -05:00
|
|
|
), // Singular not used.
|
2015-11-18 13:04:28 -05:00
|
|
|
|
2019-09-02 20:41:05 -04:00
|
|
|
/* translators: %s: Number of comments. */
|
2018-08-16 21:51:36 -04:00
|
|
|
'mine' => _nx_noop(
|
2018-02-09 13:46:31 -05:00
|
|
|
'Mine <span class="count">(%s)</span>',
|
|
|
|
'Mine <span class="count">(%s)</span>',
|
|
|
|
'comments'
|
|
|
|
),
|
|
|
|
|
2019-09-02 20:41:05 -04:00
|
|
|
/* translators: %s: Number of comments. */
|
2015-11-18 13:04:28 -05:00
|
|
|
'moderated' => _nx_noop(
|
|
|
|
'Pending <span class="count">(%s)</span>',
|
|
|
|
'Pending <span class="count">(%s)</span>',
|
|
|
|
'comments'
|
2015-09-24 13:57:25 -04:00
|
|
|
),
|
2015-11-18 13:04:28 -05:00
|
|
|
|
2019-09-02 20:41:05 -04:00
|
|
|
/* translators: %s: Number of comments. */
|
2017-11-30 18:11:00 -05:00
|
|
|
'approved' => _nx_noop(
|
2015-11-18 13:04:28 -05:00
|
|
|
'Approved <span class="count">(%s)</span>',
|
|
|
|
'Approved <span class="count">(%s)</span>',
|
|
|
|
'comments'
|
2015-09-24 13:57:25 -04:00
|
|
|
),
|
2015-11-18 13:04:28 -05:00
|
|
|
|
2019-09-02 20:41:05 -04:00
|
|
|
/* translators: %s: Number of comments. */
|
2017-11-30 18:11:00 -05:00
|
|
|
'spam' => _nx_noop(
|
2015-11-18 13:04:28 -05:00
|
|
|
'Spam <span class="count">(%s)</span>',
|
|
|
|
'Spam <span class="count">(%s)</span>',
|
|
|
|
'comments'
|
2015-09-24 13:57:25 -04:00
|
|
|
),
|
2015-11-18 13:04:28 -05:00
|
|
|
|
2019-09-02 20:41:05 -04:00
|
|
|
/* translators: %s: Number of comments. */
|
2017-11-30 18:11:00 -05:00
|
|
|
'trash' => _nx_noop(
|
2015-11-18 13:04:28 -05:00
|
|
|
'Trash <span class="count">(%s)</span>',
|
|
|
|
'Trash <span class="count">(%s)</span>',
|
|
|
|
'comments'
|
2017-11-30 18:11:00 -05:00
|
|
|
),
|
2015-09-24 13:57:25 -04:00
|
|
|
);
|
2010-10-24 22:57:43 -04:00
|
|
|
|
2017-11-30 18:11:00 -05:00
|
|
|
if ( ! EMPTY_TRASH_DAYS ) {
|
|
|
|
unset( $stati['trash'] );
|
|
|
|
}
|
2010-10-24 22:57:43 -04:00
|
|
|
|
2015-10-23 01:14:25 -04:00
|
|
|
$link = admin_url( 'edit-comments.php' );
|
2021-05-03 10:10:00 -04:00
|
|
|
|
2020-05-16 14:42:12 -04:00
|
|
|
if ( ! empty( $comment_type ) && 'all' !== $comment_type ) {
|
2010-10-24 22:57:43 -04:00
|
|
|
$link = add_query_arg( 'comment_type', $comment_type, $link );
|
2017-11-30 18:11:00 -05:00
|
|
|
}
|
2010-10-24 22:57:43 -04:00
|
|
|
|
|
|
|
foreach ( $stati as $status => $label ) {
|
2018-02-09 13:46:31 -05:00
|
|
|
if ( 'mine' === $status ) {
|
|
|
|
$current_user_id = get_current_user_id();
|
2018-08-16 21:51:36 -04:00
|
|
|
$num_comments->mine = get_comments(
|
|
|
|
array(
|
2019-01-16 21:45:49 -05:00
|
|
|
'post_id' => $post_id ? $post_id : 0,
|
2018-08-16 21:51:36 -04:00
|
|
|
'user_id' => $current_user_id,
|
|
|
|
'count' => true,
|
|
|
|
)
|
|
|
|
);
|
|
|
|
$link = add_query_arg( 'user_id', $current_user_id, $link );
|
2018-02-09 13:46:31 -05:00
|
|
|
} else {
|
|
|
|
$link = remove_query_arg( 'user_id', $link );
|
|
|
|
}
|
|
|
|
|
2017-11-30 18:11:00 -05:00
|
|
|
if ( ! isset( $num_comments->$status ) ) {
|
2010-10-24 22:57:43 -04:00
|
|
|
$num_comments->$status = 10;
|
2017-11-30 18:11:00 -05:00
|
|
|
}
|
2021-05-03 10:10:00 -04:00
|
|
|
|
2010-10-24 22:57:43 -04:00
|
|
|
$link = add_query_arg( 'comment_status', $status, $link );
|
2021-05-03 10:10:00 -04:00
|
|
|
|
2017-11-30 18:11:00 -05:00
|
|
|
if ( $post_id ) {
|
2010-10-24 22:57:43 -04:00
|
|
|
$link = add_query_arg( 'p', absint( $post_id ), $link );
|
2017-11-30 18:11:00 -05:00
|
|
|
}
|
2021-05-03 10:10:00 -04:00
|
|
|
|
2010-10-24 22:57:43 -04:00
|
|
|
/*
|
|
|
|
// I toyed with this, but decided against it. Leaving it in here in case anyone thinks it is a good idea. ~ Mark
|
|
|
|
if ( !empty( $_REQUEST['s'] ) )
|
2013-03-01 12:00:25 -05:00
|
|
|
$link = add_query_arg( 's', esc_attr( wp_unslash( $_REQUEST['s'] ) ), $link );
|
2010-10-24 22:57:43 -04:00
|
|
|
*/
|
2021-05-03 10:10:00 -04:00
|
|
|
|
2022-09-19 17:08:10 -04:00
|
|
|
$status_links[ $status ] = array(
|
|
|
|
'url' => esc_url( $link ),
|
|
|
|
'label' => sprintf(
|
|
|
|
translate_nooped_plural( $label, $num_comments->$status ),
|
|
|
|
sprintf(
|
|
|
|
'<span class="%s-count">%s</span>',
|
|
|
|
( 'moderated' === $status ) ? 'pending' : $status,
|
|
|
|
number_format_i18n( $num_comments->$status )
|
|
|
|
)
|
|
|
|
),
|
|
|
|
'current' => $status === $comment_status,
|
|
|
|
);
|
2010-10-24 22:57:43 -04:00
|
|
|
}
|
|
|
|
|
2013-11-13 14:47:10 -05:00
|
|
|
/**
|
2016-05-22 14:01:30 -04:00
|
|
|
* Filters the comment status links.
|
2013-11-13 14:47:10 -05:00
|
|
|
*
|
|
|
|
* @since 2.5.0
|
2019-01-08 20:06:48 -05:00
|
|
|
* @since 5.1.0 The 'Mine' link was added.
|
2013-11-13 14:47:10 -05:00
|
|
|
*
|
2018-02-09 13:46:31 -05:00
|
|
|
* @param string[] $status_links An associative array of fully-formed comment status links. Includes 'All', 'Mine',
|
|
|
|
* 'Pending', 'Approved', 'Spam', and 'Trash'.
|
2013-11-13 14:47:10 -05:00
|
|
|
*/
|
2022-09-19 17:08:10 -04:00
|
|
|
return apply_filters( 'comment_status_links', $this->get_views_links( $status_links ) );
|
2010-10-24 22:57:43 -04:00
|
|
|
}
|
|
|
|
|
2015-05-28 17:41:30 -04:00
|
|
|
/**
|
|
|
|
* @global string $comment_status
|
2015-05-29 16:17:26 -04:00
|
|
|
*
|
|
|
|
* @return array
|
2015-05-28 17:41:30 -04:00
|
|
|
*/
|
2014-07-13 18:09:16 -04:00
|
|
|
protected function get_bulk_actions() {
|
2010-10-24 22:57:43 -04:00
|
|
|
global $comment_status;
|
|
|
|
|
|
|
|
$actions = array();
|
2021-05-03 10:10:00 -04:00
|
|
|
|
2020-04-04 23:02:11 -04:00
|
|
|
if ( in_array( $comment_status, array( 'all', 'approved' ), true ) ) {
|
2010-10-24 22:57:43 -04:00
|
|
|
$actions['unapprove'] = __( 'Unapprove' );
|
2017-11-30 18:11:00 -05:00
|
|
|
}
|
2021-05-03 10:10:00 -04:00
|
|
|
|
2020-04-04 23:02:11 -04:00
|
|
|
if ( in_array( $comment_status, array( 'all', 'moderated' ), true ) ) {
|
2010-10-24 22:57:43 -04:00
|
|
|
$actions['approve'] = __( 'Approve' );
|
2017-11-30 18:11:00 -05:00
|
|
|
}
|
2021-05-03 10:10:00 -04:00
|
|
|
|
2020-04-04 23:02:11 -04:00
|
|
|
if ( in_array( $comment_status, array( 'all', 'moderated', 'approved', 'trash' ), true ) ) {
|
2020-07-06 17:52:21 -04:00
|
|
|
$actions['spam'] = _x( 'Mark as spam', 'comment' );
|
2017-11-30 18:11:00 -05:00
|
|
|
}
|
2010-10-24 22:57:43 -04:00
|
|
|
|
2015-09-22 02:06:25 -04:00
|
|
|
if ( 'trash' === $comment_status ) {
|
2010-10-24 22:57:43 -04:00
|
|
|
$actions['untrash'] = __( 'Restore' );
|
2015-09-22 02:06:25 -04:00
|
|
|
} elseif ( 'spam' === $comment_status ) {
|
2020-07-06 17:52:21 -04:00
|
|
|
$actions['unspam'] = _x( 'Not spam', 'comment' );
|
2015-09-22 02:06:25 -04:00
|
|
|
}
|
2010-10-24 22:57:43 -04:00
|
|
|
|
2020-04-04 23:02:11 -04:00
|
|
|
if ( in_array( $comment_status, array( 'trash', 'spam' ), true ) || ! EMPTY_TRASH_DAYS ) {
|
2020-07-06 17:52:21 -04:00
|
|
|
$actions['delete'] = __( 'Delete permanently' );
|
2017-11-30 18:11:00 -05:00
|
|
|
} else {
|
2020-07-23 20:21:03 -04:00
|
|
|
$actions['trash'] = __( 'Move to Trash' );
|
2017-11-30 18:11:00 -05:00
|
|
|
}
|
2010-10-24 22:57:43 -04:00
|
|
|
|
|
|
|
return $actions;
|
|
|
|
}
|
|
|
|
|
2015-05-28 17:41:30 -04:00
|
|
|
/**
|
|
|
|
* @global string $comment_status
|
|
|
|
* @global string $comment_type
|
2015-05-29 16:17:26 -04:00
|
|
|
*
|
2015-05-28 17:41:30 -04:00
|
|
|
* @param string $which
|
|
|
|
*/
|
2014-07-13 18:09:16 -04:00
|
|
|
protected function extra_tablenav( $which ) {
|
2010-10-24 22:57:43 -04:00
|
|
|
global $comment_status, $comment_type;
|
2017-07-10 19:05:40 -04:00
|
|
|
static $has_items;
|
|
|
|
|
|
|
|
if ( ! isset( $has_items ) ) {
|
|
|
|
$has_items = $this->has_items();
|
|
|
|
}
|
2020-07-30 09:27:04 -04:00
|
|
|
|
2020-07-20 20:29:02 -04:00
|
|
|
echo '<div class="alignleft actions">';
|
2020-07-30 09:27:04 -04:00
|
|
|
|
2018-08-16 21:51:36 -04:00
|
|
|
if ( 'top' === $which ) {
|
2020-07-20 20:29:02 -04:00
|
|
|
ob_start();
|
2017-11-30 18:11:00 -05:00
|
|
|
|
2020-09-04 20:33:05 -04:00
|
|
|
$this->comment_type_dropdown( $comment_type );
|
2020-08-04 11:58:06 -04:00
|
|
|
|
2018-08-16 21:51:36 -04:00
|
|
|
/**
|
|
|
|
* Fires just before the Filter submit button for comment types.
|
|
|
|
*
|
|
|
|
* @since 3.5.0
|
|
|
|
*/
|
|
|
|
do_action( 'restrict_manage_comments' );
|
2020-07-20 20:29:02 -04:00
|
|
|
|
|
|
|
$output = ob_get_clean();
|
|
|
|
|
2020-08-04 12:26:03 -04:00
|
|
|
if ( ! empty( $output ) && $this->has_items() ) {
|
2020-07-20 20:29:02 -04:00
|
|
|
echo $output;
|
2020-08-04 11:58:06 -04:00
|
|
|
submit_button( __( 'Filter' ), '', 'filter_action', false, array( 'id' => 'post-query-submit' ) );
|
2020-07-20 20:29:02 -04:00
|
|
|
}
|
2018-08-16 21:51:36 -04:00
|
|
|
}
|
|
|
|
|
2021-05-03 09:57:04 -04:00
|
|
|
if ( ( 'spam' === $comment_status || 'trash' === $comment_status ) && $has_items
|
2021-05-03 10:10:00 -04:00
|
|
|
&& current_user_can( 'moderate_comments' )
|
2021-05-03 09:57:04 -04:00
|
|
|
) {
|
2018-08-16 21:51:36 -04:00
|
|
|
wp_nonce_field( 'bulk-destroy', '_destroy_nonce' );
|
|
|
|
$title = ( 'spam' === $comment_status ) ? esc_attr__( 'Empty Spam' ) : esc_attr__( 'Empty Trash' );
|
|
|
|
submit_button( $title, 'apply', 'delete_all', false );
|
|
|
|
}
|
2020-07-30 09:27:04 -04:00
|
|
|
|
2013-11-13 14:47:10 -05:00
|
|
|
/**
|
|
|
|
* Fires after the Filter submit button for comment types.
|
|
|
|
*
|
|
|
|
* @since 2.5.0
|
2020-07-30 09:27:04 -04:00
|
|
|
* @since 5.6.0 The `$which` parameter was added.
|
2013-11-13 14:47:10 -05:00
|
|
|
*
|
|
|
|
* @param string $comment_status The comment status name. Default 'All'.
|
2020-07-30 09:27:04 -04:00
|
|
|
* @param string $which The location of the extra table nav markup: 'top' or 'bottom'.
|
2013-11-13 14:47:10 -05:00
|
|
|
*/
|
2020-07-30 09:27:04 -04:00
|
|
|
do_action( 'manage_comments_nav', $comment_status, $which );
|
|
|
|
|
2010-10-24 22:57:43 -04:00
|
|
|
echo '</div>';
|
|
|
|
}
|
|
|
|
|
2015-05-29 16:17:26 -04:00
|
|
|
/**
|
|
|
|
* @return string|false
|
|
|
|
*/
|
2014-05-18 19:59:15 -04:00
|
|
|
public function current_action() {
|
2017-11-30 18:11:00 -05:00
|
|
|
if ( isset( $_REQUEST['delete_all'] ) || isset( $_REQUEST['delete_all2'] ) ) {
|
2010-10-24 22:57:43 -04:00
|
|
|
return 'delete_all';
|
2017-11-30 18:11:00 -05:00
|
|
|
}
|
2010-10-24 22:57:43 -04:00
|
|
|
|
|
|
|
return parent::current_action();
|
|
|
|
}
|
|
|
|
|
2015-05-28 17:41:30 -04:00
|
|
|
/**
|
2016-02-05 13:50:25 -05:00
|
|
|
* @global int $post_id
|
2015-05-29 16:17:26 -04:00
|
|
|
*
|
2015-05-28 17:41:30 -04:00
|
|
|
* @return array
|
|
|
|
*/
|
2014-05-18 19:59:15 -04:00
|
|
|
public function get_columns() {
|
2010-11-29 15:15:04 -05:00
|
|
|
global $post_id;
|
2010-10-24 22:57:43 -04:00
|
|
|
|
|
|
|
$columns = array();
|
|
|
|
|
2017-11-30 18:11:00 -05:00
|
|
|
if ( $this->checkbox ) {
|
2010-10-24 22:57:43 -04:00
|
|
|
$columns['cb'] = '<input type="checkbox" />';
|
2017-11-30 18:11:00 -05:00
|
|
|
}
|
2010-10-24 22:57:43 -04:00
|
|
|
|
2017-11-30 18:11:00 -05:00
|
|
|
$columns['author'] = __( 'Author' );
|
2010-10-24 22:57:43 -04:00
|
|
|
$columns['comment'] = _x( 'Comment', 'column name' );
|
|
|
|
|
2015-07-26 19:36:24 -04:00
|
|
|
if ( ! $post_id ) {
|
2019-09-02 20:41:05 -04:00
|
|
|
/* translators: Column name or table row header. */
|
2020-07-06 17:52:21 -04:00
|
|
|
$columns['response'] = __( 'In response to' );
|
2015-07-26 19:36:24 -04:00
|
|
|
}
|
2010-10-24 22:57:43 -04:00
|
|
|
|
2020-07-06 17:52:21 -04:00
|
|
|
$columns['date'] = _x( 'Submitted on', 'column name' );
|
2015-09-24 13:27:26 -04:00
|
|
|
|
2010-10-24 22:57:43 -04:00
|
|
|
return $columns;
|
|
|
|
}
|
|
|
|
|
2020-07-20 20:29:02 -04:00
|
|
|
/**
|
2020-09-04 16:41:07 -04:00
|
|
|
* Displays a comment type drop-down for filtering on the Comments list table.
|
2020-07-20 20:29:02 -04:00
|
|
|
*
|
|
|
|
* @since 5.5.0
|
2020-09-04 20:33:05 -04:00
|
|
|
* @since 5.6.0 Renamed from `comment_status_dropdown()` to `comment_type_dropdown()`.
|
2020-07-20 20:29:02 -04:00
|
|
|
*
|
|
|
|
* @param string $comment_type The current comment type slug.
|
|
|
|
*/
|
2020-09-04 20:33:05 -04:00
|
|
|
protected function comment_type_dropdown( $comment_type ) {
|
2020-07-20 20:29:02 -04:00
|
|
|
/**
|
2020-09-04 16:41:07 -04:00
|
|
|
* Filters the comment types shown in the drop-down menu on the Comments list table.
|
2020-07-20 20:29:02 -04:00
|
|
|
*
|
|
|
|
* @since 2.7.0
|
|
|
|
*
|
2020-09-04 16:41:07 -04:00
|
|
|
* @param string[] $comment_types Array of comment type labels keyed by their name.
|
2020-07-20 20:29:02 -04:00
|
|
|
*/
|
|
|
|
$comment_types = apply_filters(
|
|
|
|
'admin_comment_types_dropdown',
|
|
|
|
array(
|
2020-08-05 09:53:06 -04:00
|
|
|
'comment' => __( 'Comments' ),
|
|
|
|
'pings' => __( 'Pings' ),
|
2020-07-20 20:29:02 -04:00
|
|
|
)
|
|
|
|
);
|
|
|
|
|
|
|
|
if ( $comment_types && is_array( $comment_types ) ) {
|
I18N: Mark screen reader strings as such with translator comments.
This aims to provide better context for translators and make it easier to determine that some strings contain hidden accessibility text and are not displayed in the UI.
Props kebbet, mercime, pavelevap, ocean90, swissspidy, Chouby, jipmoors, afercia, desrosj, costdev, audrasjb, SergeyBiryukov.
Fixes #29748.
Built from https://develop.svn.wordpress.org/trunk@55276
git-svn-id: http://core.svn.wordpress.org/trunk@54809 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2023-02-07 12:10:21 -05:00
|
|
|
printf(
|
|
|
|
'<label class="screen-reader-text" for="filter-by-comment-type">%s</label>',
|
|
|
|
/* translators: Hidden accessibility text. */
|
|
|
|
__( 'Filter by comment type' )
|
|
|
|
);
|
2020-07-20 20:29:02 -04:00
|
|
|
|
|
|
|
echo '<select id="filter-by-comment-type" name="comment_type">';
|
|
|
|
|
2020-08-05 09:53:06 -04:00
|
|
|
printf( "\t<option value=''>%s</option>", __( 'All comment types' ) );
|
2020-07-20 20:29:02 -04:00
|
|
|
|
|
|
|
foreach ( $comment_types as $type => $label ) {
|
|
|
|
if ( get_comments(
|
|
|
|
array(
|
|
|
|
'number' => 1,
|
|
|
|
'type' => $type,
|
|
|
|
)
|
|
|
|
) ) {
|
|
|
|
printf(
|
|
|
|
"\t<option value='%s'%s>%s</option>\n",
|
|
|
|
esc_attr( $type ),
|
|
|
|
selected( $comment_type, $type, false ),
|
|
|
|
esc_html( $label )
|
|
|
|
);
|
|
|
|
}
|
|
|
|
}
|
2021-05-03 10:10:00 -04:00
|
|
|
|
|
|
|
echo '</select>';
|
2020-07-20 20:29:02 -04:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2015-05-29 16:17:26 -04:00
|
|
|
/**
|
|
|
|
* @return array
|
|
|
|
*/
|
2014-07-13 18:09:16 -04:00
|
|
|
protected function get_sortable_columns() {
|
2010-10-24 22:57:43 -04:00
|
|
|
return array(
|
|
|
|
'author' => 'comment_author',
|
2015-09-24 13:27:26 -04:00
|
|
|
'response' => 'comment_post_ID',
|
2017-11-30 18:11:00 -05:00
|
|
|
'date' => 'comment_date',
|
2010-10-24 22:57:43 -04:00
|
|
|
);
|
|
|
|
}
|
|
|
|
|
2015-05-28 22:41:25 -04:00
|
|
|
/**
|
2022-07-04 04:20:15 -04:00
|
|
|
* Gets the name of the default primary column.
|
2015-05-28 22:41:25 -04:00
|
|
|
*
|
|
|
|
* @since 4.3.0
|
|
|
|
*
|
2015-05-30 21:18:26 -04:00
|
|
|
* @return string Name of the default primary column, in this case, 'comment'.
|
2015-05-28 22:41:25 -04:00
|
|
|
*/
|
|
|
|
protected function get_default_primary_column_name() {
|
|
|
|
return 'comment';
|
|
|
|
}
|
|
|
|
|
2015-05-29 17:32:24 -04:00
|
|
|
/**
|
2019-09-29 07:04:58 -04:00
|
|
|
* Displays the comments table.
|
|
|
|
*
|
|
|
|
* Overrides the parent display() method to render extra comments.
|
2019-09-27 19:03:58 -04:00
|
|
|
*
|
|
|
|
* @since 3.1.0
|
2015-05-29 17:32:24 -04:00
|
|
|
*/
|
2014-05-18 19:59:15 -04:00
|
|
|
public function display() {
|
2017-11-30 18:11:00 -05:00
|
|
|
wp_nonce_field( 'fetch-list-' . get_class( $this ), '_ajax_fetch_list_nonce' );
|
2020-07-20 20:29:02 -04:00
|
|
|
static $has_items;
|
2011-01-11 17:42:22 -05:00
|
|
|
|
2020-07-20 20:29:02 -04:00
|
|
|
if ( ! isset( $has_items ) ) {
|
|
|
|
$has_items = $this->has_items();
|
2021-05-03 10:10:00 -04:00
|
|
|
|
2020-07-20 20:29:02 -04:00
|
|
|
if ( $has_items ) {
|
|
|
|
$this->display_tablenav( 'top' );
|
|
|
|
}
|
|
|
|
}
|
2010-10-24 22:57:43 -04:00
|
|
|
|
2015-10-06 21:28:25 -04:00
|
|
|
$this->screen->render_screen_reader_content( 'heading_list' );
|
|
|
|
|
2018-08-16 21:51:36 -04:00
|
|
|
?>
|
List tables: A better responsive view.
Instead of truncating columns, the data that's already in the markup can now be toggled into view. Only seems appropriate to celebrate four years of contributing by finally doing the first thing I ever mocked up.
Known issues / concerns:
* Custom list tables that don't define a primary column will show nothing at all. These are not extremely common, as `WP_List_Table` isn't really recommended for plugin consumption, but it happens. We need to come up with some kind of fallback.
* Some visual elements, particularly whitespace, could use refining.
* Needs a11y review.
* Touch performance on iOS feels sluggish - is there anything we can do about that?
* Would this be better accordion-style (only one expanded at a time)?
* Is `wp_strip_all_tags()` good enough for column titles that have HTML in them? It's essentially a workaround for the fact that core's comments column does that for the icon, which maybe it shouldn't. Perhaps worth another ticket, as a markup change would be fairly independent.
* Visual hierarchy is not great when expanded (also worthy of another ticket).
* Quick edit now becomes noticeably more annoying to cancel out of, as you have to scroll all the way down and you lose your position from before it was opened. Again, worthy of another ticket.
props Michael Arestad, helen.
see #32395.
Built from https://develop.svn.wordpress.org/trunk@33016
git-svn-id: http://core.svn.wordpress.org/trunk@32987 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-06-30 21:31:25 -04:00
|
|
|
<table class="wp-list-table <?php echo implode( ' ', $this->get_table_classes() ); ?>">
|
2010-10-24 22:57:43 -04:00
|
|
|
<thead>
|
|
|
|
<tr>
|
|
|
|
<?php $this->print_column_headers(); ?>
|
|
|
|
</tr>
|
|
|
|
</thead>
|
|
|
|
|
2012-11-05 20:01:52 -05:00
|
|
|
<tbody id="the-comment-list" data-wp-lists="list:comment">
|
2010-12-21 12:34:29 -05:00
|
|
|
<?php $this->display_rows_or_placeholder(); ?>
|
2010-10-24 22:57:43 -04:00
|
|
|
</tbody>
|
|
|
|
|
2012-11-05 20:01:52 -05:00
|
|
|
<tbody id="the-extra-comment-list" data-wp-lists="list:comment" style="display: none;">
|
2015-08-20 01:54:25 -04:00
|
|
|
<?php
|
2018-10-03 15:47:25 -04:00
|
|
|
/*
|
2018-10-03 17:12:24 -04:00
|
|
|
* Back up the items to restore after printing the extra items markup.
|
2018-10-03 15:47:25 -04:00
|
|
|
* The extra items may be empty, which will prevent the table nav from displaying later.
|
|
|
|
*/
|
2018-10-03 17:12:24 -04:00
|
|
|
$items = $this->items;
|
2015-08-20 01:54:25 -04:00
|
|
|
$this->items = $this->extra_items;
|
2015-08-20 12:36:25 -04:00
|
|
|
$this->display_rows_or_placeholder();
|
2018-10-03 15:47:25 -04:00
|
|
|
$this->items = $items;
|
2015-08-20 01:54:25 -04:00
|
|
|
?>
|
2010-10-24 22:57:43 -04:00
|
|
|
</tbody>
|
2015-02-22 16:48:26 -05:00
|
|
|
|
|
|
|
<tfoot>
|
|
|
|
<tr>
|
|
|
|
<?php $this->print_column_headers( false ); ?>
|
|
|
|
</tr>
|
|
|
|
</tfoot>
|
|
|
|
|
2010-10-24 22:57:43 -04:00
|
|
|
</table>
|
2018-08-16 21:51:36 -04:00
|
|
|
<?php
|
2010-10-24 22:57:43 -04:00
|
|
|
|
|
|
|
$this->display_tablenav( 'bottom' );
|
|
|
|
}
|
|
|
|
|
2015-05-28 17:41:30 -04:00
|
|
|
/**
|
2019-08-04 08:28:56 -04:00
|
|
|
* @global WP_Post $post Global post object.
|
2019-10-04 18:19:57 -04:00
|
|
|
* @global WP_Comment $comment Global comment object.
|
2015-05-29 16:17:26 -04:00
|
|
|
*
|
2015-11-18 14:05:30 -05:00
|
|
|
* @param WP_Comment $item
|
2015-05-28 17:41:30 -04:00
|
|
|
*/
|
2015-11-18 14:05:30 -05:00
|
|
|
public function single_row( $item ) {
|
|
|
|
global $post, $comment;
|
|
|
|
|
|
|
|
$comment = $item;
|
2010-10-24 22:57:43 -04:00
|
|
|
|
2015-09-08 23:00:24 -04:00
|
|
|
$the_comment_class = wp_get_comment_status( $comment );
|
2021-05-03 10:10:00 -04:00
|
|
|
|
2015-03-08 22:11:28 -04:00
|
|
|
if ( ! $the_comment_class ) {
|
|
|
|
$the_comment_class = '';
|
|
|
|
}
|
2021-05-03 10:10:00 -04:00
|
|
|
|
2020-10-18 13:27:06 -04:00
|
|
|
$the_comment_class = implode( ' ', get_comment_class( $the_comment_class, $comment, $comment->comment_post_ID ) );
|
2010-10-24 22:57:43 -04:00
|
|
|
|
2015-09-09 23:12:23 -04:00
|
|
|
if ( $comment->comment_post_ID > 0 ) {
|
|
|
|
$post = get_post( $comment->comment_post_ID );
|
|
|
|
}
|
2021-05-03 10:10:00 -04:00
|
|
|
|
2010-10-24 22:57:43 -04:00
|
|
|
$this->user_can = current_user_can( 'edit_comment', $comment->comment_ID );
|
|
|
|
|
2011-08-24 07:12:07 -04:00
|
|
|
echo "<tr id='comment-$comment->comment_ID' class='$the_comment_class'>";
|
2013-04-28 21:10:50 -04:00
|
|
|
$this->single_row_columns( $comment );
|
2011-08-24 07:13:33 -04:00
|
|
|
echo "</tr>\n";
|
2015-09-09 23:12:23 -04:00
|
|
|
|
2016-01-17 21:50:27 -05:00
|
|
|
unset( $GLOBALS['post'], $GLOBALS['comment'] );
|
2010-10-24 22:57:43 -04:00
|
|
|
}
|
|
|
|
|
2017-11-30 18:11:00 -05:00
|
|
|
/**
|
2022-07-04 04:20:15 -04:00
|
|
|
* Generates and displays row actions links.
|
2017-11-30 18:11:00 -05:00
|
|
|
*
|
|
|
|
* @since 4.3.0
|
Code Modernization: Fix parameter name mismatches for parent/child classes in `WP_List_Table::handle_row_actions()`.
Matches the method signatures of the parent class and each child class.
Why? PHP 8 introduces the ability to pass named arguments to function/method calls. This means the child and parent method signatures (i.e. parameter names) need to match.
For readability:
- `@since` clearly specifies the original parameter name and its new name as well as why the change happened
- in methods longer than a single line, the generic parameter is reassigned to the original parameter restoring it for context for use within the method. An inline comment is added to explain why this reassignment is made.
Follow-up to [32644], [32664], [32798], [38489], [49183], [49197].
Props jrf, hellofromTonya, sergeybiryukov, azaozz, desrosj, johnbillion.
See #51553.
Built from https://develop.svn.wordpress.org/trunk@51737
git-svn-id: http://core.svn.wordpress.org/trunk@51345 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2021-09-07 15:24:53 -04:00
|
|
|
* @since 5.9.0 Renamed `$comment` to `$item` to match parent class for PHP 8 named parameter support.
|
2017-11-30 18:11:00 -05:00
|
|
|
*
|
|
|
|
* @global string $comment_status Status for the current listed comments.
|
|
|
|
*
|
Code Modernization: Fix parameter name mismatches for parent/child classes in `WP_List_Table::handle_row_actions()`.
Matches the method signatures of the parent class and each child class.
Why? PHP 8 introduces the ability to pass named arguments to function/method calls. This means the child and parent method signatures (i.e. parameter names) need to match.
For readability:
- `@since` clearly specifies the original parameter name and its new name as well as why the change happened
- in methods longer than a single line, the generic parameter is reassigned to the original parameter restoring it for context for use within the method. An inline comment is added to explain why this reassignment is made.
Follow-up to [32644], [32664], [32798], [38489], [49183], [49197].
Props jrf, hellofromTonya, sergeybiryukov, azaozz, desrosj, johnbillion.
See #51553.
Built from https://develop.svn.wordpress.org/trunk@51737
git-svn-id: http://core.svn.wordpress.org/trunk@51345 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2021-09-07 15:24:53 -04:00
|
|
|
* @param WP_Comment $item The comment object.
|
2017-11-30 18:11:00 -05:00
|
|
|
* @param string $column_name Current column name.
|
|
|
|
* @param string $primary Primary column name.
|
2020-01-11 12:59:04 -05:00
|
|
|
* @return string Row actions output for comments. An empty string
|
|
|
|
* if the current column is not the primary column,
|
|
|
|
* or if the current user cannot edit the comment.
|
2017-11-30 18:11:00 -05:00
|
|
|
*/
|
Code Modernization: Fix parameter name mismatches for parent/child classes in `WP_List_Table::handle_row_actions()`.
Matches the method signatures of the parent class and each child class.
Why? PHP 8 introduces the ability to pass named arguments to function/method calls. This means the child and parent method signatures (i.e. parameter names) need to match.
For readability:
- `@since` clearly specifies the original parameter name and its new name as well as why the change happened
- in methods longer than a single line, the generic parameter is reassigned to the original parameter restoring it for context for use within the method. An inline comment is added to explain why this reassignment is made.
Follow-up to [32644], [32664], [32798], [38489], [49183], [49197].
Props jrf, hellofromTonya, sergeybiryukov, azaozz, desrosj, johnbillion.
See #51553.
Built from https://develop.svn.wordpress.org/trunk@51737
git-svn-id: http://core.svn.wordpress.org/trunk@51345 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2021-09-07 15:24:53 -04:00
|
|
|
protected function handle_row_actions( $item, $column_name, $primary ) {
|
2017-11-30 18:11:00 -05:00
|
|
|
global $comment_status;
|
2015-05-29 16:17:26 -04:00
|
|
|
|
List tables: A better responsive view.
Instead of truncating columns, the data that's already in the markup can now be toggled into view. Only seems appropriate to celebrate four years of contributing by finally doing the first thing I ever mocked up.
Known issues / concerns:
* Custom list tables that don't define a primary column will show nothing at all. These are not extremely common, as `WP_List_Table` isn't really recommended for plugin consumption, but it happens. We need to come up with some kind of fallback.
* Some visual elements, particularly whitespace, could use refining.
* Needs a11y review.
* Touch performance on iOS feels sluggish - is there anything we can do about that?
* Would this be better accordion-style (only one expanded at a time)?
* Is `wp_strip_all_tags()` good enough for column titles that have HTML in them? It's essentially a workaround for the fact that core's comments column does that for the icon, which maybe it shouldn't. Perhaps worth another ticket, as a markup change would be fairly independent.
* Visual hierarchy is not great when expanded (also worthy of another ticket).
* Quick edit now becomes noticeably more annoying to cancel out of, as you have to scroll all the way down and you lose your position from before it was opened. Again, worthy of another ticket.
props Michael Arestad, helen.
see #32395.
Built from https://develop.svn.wordpress.org/trunk@33016
git-svn-id: http://core.svn.wordpress.org/trunk@32987 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-06-30 21:31:25 -04:00
|
|
|
if ( $primary !== $column_name ) {
|
|
|
|
return '';
|
|
|
|
}
|
|
|
|
|
2017-11-30 18:11:00 -05:00
|
|
|
if ( ! $this->user_can ) {
|
2020-01-11 12:59:04 -05:00
|
|
|
return '';
|
2015-07-14 13:47:24 -04:00
|
|
|
}
|
|
|
|
|
Code Modernization: Fix parameter name mismatches for parent/child classes in `WP_List_Table::handle_row_actions()`.
Matches the method signatures of the parent class and each child class.
Why? PHP 8 introduces the ability to pass named arguments to function/method calls. This means the child and parent method signatures (i.e. parameter names) need to match.
For readability:
- `@since` clearly specifies the original parameter name and its new name as well as why the change happened
- in methods longer than a single line, the generic parameter is reassigned to the original parameter restoring it for context for use within the method. An inline comment is added to explain why this reassignment is made.
Follow-up to [32644], [32664], [32798], [38489], [49183], [49197].
Props jrf, hellofromTonya, sergeybiryukov, azaozz, desrosj, johnbillion.
See #51553.
Built from https://develop.svn.wordpress.org/trunk@51737
git-svn-id: http://core.svn.wordpress.org/trunk@51345 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2021-09-07 15:24:53 -04:00
|
|
|
// Restores the more descriptive, specific name for use within this method.
|
|
|
|
$comment = $item;
|
2015-09-08 23:00:24 -04:00
|
|
|
$the_comment_status = wp_get_comment_status( $comment );
|
2010-10-24 22:57:43 -04:00
|
|
|
|
Coding Standards: Use more meaningful variable names for output in the admin.
This renames some variables for clarity, per the [https://developer.wordpress.org/coding-standards/wordpress-coding-standards/php/#naming-conventions Naming Conventions]:
> Don’t abbreviate variable names unnecessarily; let the code be unambiguous and self-documenting.
* `$out` is renamed to `$output` in various list table methods and admin functions.
* `$sep` is renamed to `$separator` in various list table methods and admin functions.
This affects:
* `WP_Comments_List_Table::handle_row_actions()`
* `WP_List_Table::row_actions()`
* `WP_Media_List_Table::column_default()`
* `WP_MS_Sites_List_Table::site_states()`
* `WP_MS_Users_List_Table::column_blogs()`
* `WP_Terms_List_Table::column_name()`
* `_wp_dashboard_recent_comments_row()`
* `image_align_input_fields()`
* `image_size_input_fields()`
* `wp_doc_link_parse()`
* `_post_states()`
* `_media_states()`
Follow-up to [8653], [8692], [8864], [8910], [8911], [8916], [9103], [9153], [10607], [15491], [17793], [32644], [54070].
Props mukesh27, costdev.
See #56448, #55647.
Built from https://develop.svn.wordpress.org/trunk@54071
git-svn-id: http://core.svn.wordpress.org/trunk@53630 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-09-05 13:19:09 -04:00
|
|
|
$output = '';
|
2014-01-16 15:34:10 -05:00
|
|
|
|
2017-11-30 18:11:00 -05:00
|
|
|
$del_nonce = esc_html( '_wpnonce=' . wp_create_nonce( "delete-comment_$comment->comment_ID" ) );
|
List tables: A better responsive view.
Instead of truncating columns, the data that's already in the markup can now be toggled into view. Only seems appropriate to celebrate four years of contributing by finally doing the first thing I ever mocked up.
Known issues / concerns:
* Custom list tables that don't define a primary column will show nothing at all. These are not extremely common, as `WP_List_Table` isn't really recommended for plugin consumption, but it happens. We need to come up with some kind of fallback.
* Some visual elements, particularly whitespace, could use refining.
* Needs a11y review.
* Touch performance on iOS feels sluggish - is there anything we can do about that?
* Would this be better accordion-style (only one expanded at a time)?
* Is `wp_strip_all_tags()` good enough for column titles that have HTML in them? It's essentially a workaround for the fact that core's comments column does that for the icon, which maybe it shouldn't. Perhaps worth another ticket, as a markup change would be fairly independent.
* Visual hierarchy is not great when expanded (also worthy of another ticket).
* Quick edit now becomes noticeably more annoying to cancel out of, as you have to scroll all the way down and you lose your position from before it was opened. Again, worthy of another ticket.
props Michael Arestad, helen.
see #32395.
Built from https://develop.svn.wordpress.org/trunk@33016
git-svn-id: http://core.svn.wordpress.org/trunk@32987 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-06-30 21:31:25 -04:00
|
|
|
$approve_nonce = esc_html( '_wpnonce=' . wp_create_nonce( "approve-comment_$comment->comment_ID" ) );
|
|
|
|
|
|
|
|
$url = "comment.php?c=$comment->comment_ID";
|
|
|
|
|
2017-11-30 18:11:00 -05:00
|
|
|
$approve_url = esc_url( $url . "&action=approvecomment&$approve_nonce" );
|
List tables: A better responsive view.
Instead of truncating columns, the data that's already in the markup can now be toggled into view. Only seems appropriate to celebrate four years of contributing by finally doing the first thing I ever mocked up.
Known issues / concerns:
* Custom list tables that don't define a primary column will show nothing at all. These are not extremely common, as `WP_List_Table` isn't really recommended for plugin consumption, but it happens. We need to come up with some kind of fallback.
* Some visual elements, particularly whitespace, could use refining.
* Needs a11y review.
* Touch performance on iOS feels sluggish - is there anything we can do about that?
* Would this be better accordion-style (only one expanded at a time)?
* Is `wp_strip_all_tags()` good enough for column titles that have HTML in them? It's essentially a workaround for the fact that core's comments column does that for the icon, which maybe it shouldn't. Perhaps worth another ticket, as a markup change would be fairly independent.
* Visual hierarchy is not great when expanded (also worthy of another ticket).
* Quick edit now becomes noticeably more annoying to cancel out of, as you have to scroll all the way down and you lose your position from before it was opened. Again, worthy of another ticket.
props Michael Arestad, helen.
see #32395.
Built from https://develop.svn.wordpress.org/trunk@33016
git-svn-id: http://core.svn.wordpress.org/trunk@32987 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-06-30 21:31:25 -04:00
|
|
|
$unapprove_url = esc_url( $url . "&action=unapprovecomment&$approve_nonce" );
|
2017-11-30 18:11:00 -05:00
|
|
|
$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" );
|
List tables: A better responsive view.
Instead of truncating columns, the data that's already in the markup can now be toggled into view. Only seems appropriate to celebrate four years of contributing by finally doing the first thing I ever mocked up.
Known issues / concerns:
* Custom list tables that don't define a primary column will show nothing at all. These are not extremely common, as `WP_List_Table` isn't really recommended for plugin consumption, but it happens. We need to come up with some kind of fallback.
* Some visual elements, particularly whitespace, could use refining.
* Needs a11y review.
* Touch performance on iOS feels sluggish - is there anything we can do about that?
* Would this be better accordion-style (only one expanded at a time)?
* Is `wp_strip_all_tags()` good enough for column titles that have HTML in them? It's essentially a workaround for the fact that core's comments column does that for the icon, which maybe it shouldn't. Perhaps worth another ticket, as a markup change would be fairly independent.
* Visual hierarchy is not great when expanded (also worthy of another ticket).
* Quick edit now becomes noticeably more annoying to cancel out of, as you have to scroll all the way down and you lose your position from before it was opened. Again, worthy of another ticket.
props Michael Arestad, helen.
see #32395.
Built from https://develop.svn.wordpress.org/trunk@33016
git-svn-id: http://core.svn.wordpress.org/trunk@32987 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-06-30 21:31:25 -04:00
|
|
|
|
|
|
|
// Preorder it: Approve | Reply | Quick Edit | Edit | Spam | Trash.
|
|
|
|
$actions = array(
|
2017-11-30 18:11:00 -05:00
|
|
|
'approve' => '',
|
|
|
|
'unapprove' => '',
|
|
|
|
'reply' => '',
|
List tables: A better responsive view.
Instead of truncating columns, the data that's already in the markup can now be toggled into view. Only seems appropriate to celebrate four years of contributing by finally doing the first thing I ever mocked up.
Known issues / concerns:
* Custom list tables that don't define a primary column will show nothing at all. These are not extremely common, as `WP_List_Table` isn't really recommended for plugin consumption, but it happens. We need to come up with some kind of fallback.
* Some visual elements, particularly whitespace, could use refining.
* Needs a11y review.
* Touch performance on iOS feels sluggish - is there anything we can do about that?
* Would this be better accordion-style (only one expanded at a time)?
* Is `wp_strip_all_tags()` good enough for column titles that have HTML in them? It's essentially a workaround for the fact that core's comments column does that for the icon, which maybe it shouldn't. Perhaps worth another ticket, as a markup change would be fairly independent.
* Visual hierarchy is not great when expanded (also worthy of another ticket).
* Quick edit now becomes noticeably more annoying to cancel out of, as you have to scroll all the way down and you lose your position from before it was opened. Again, worthy of another ticket.
props Michael Arestad, helen.
see #32395.
Built from https://develop.svn.wordpress.org/trunk@33016
git-svn-id: http://core.svn.wordpress.org/trunk@32987 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-06-30 21:31:25 -04:00
|
|
|
'quickedit' => '',
|
2017-11-30 18:11:00 -05:00
|
|
|
'edit' => '',
|
|
|
|
'spam' => '',
|
|
|
|
'unspam' => '',
|
|
|
|
'trash' => '',
|
|
|
|
'untrash' => '',
|
|
|
|
'delete' => '',
|
List tables: A better responsive view.
Instead of truncating columns, the data that's already in the markup can now be toggled into view. Only seems appropriate to celebrate four years of contributing by finally doing the first thing I ever mocked up.
Known issues / concerns:
* Custom list tables that don't define a primary column will show nothing at all. These are not extremely common, as `WP_List_Table` isn't really recommended for plugin consumption, but it happens. We need to come up with some kind of fallback.
* Some visual elements, particularly whitespace, could use refining.
* Needs a11y review.
* Touch performance on iOS feels sluggish - is there anything we can do about that?
* Would this be better accordion-style (only one expanded at a time)?
* Is `wp_strip_all_tags()` good enough for column titles that have HTML in them? It's essentially a workaround for the fact that core's comments column does that for the icon, which maybe it shouldn't. Perhaps worth another ticket, as a markup change would be fairly independent.
* Visual hierarchy is not great when expanded (also worthy of another ticket).
* Quick edit now becomes noticeably more annoying to cancel out of, as you have to scroll all the way down and you lose your position from before it was opened. Again, worthy of another ticket.
props Michael Arestad, helen.
see #32395.
Built from https://develop.svn.wordpress.org/trunk@33016
git-svn-id: http://core.svn.wordpress.org/trunk@32987 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-06-30 21:31:25 -04:00
|
|
|
);
|
2010-10-24 22:57:43 -04:00
|
|
|
|
List tables: A better responsive view.
Instead of truncating columns, the data that's already in the markup can now be toggled into view. Only seems appropriate to celebrate four years of contributing by finally doing the first thing I ever mocked up.
Known issues / concerns:
* Custom list tables that don't define a primary column will show nothing at all. These are not extremely common, as `WP_List_Table` isn't really recommended for plugin consumption, but it happens. We need to come up with some kind of fallback.
* Some visual elements, particularly whitespace, could use refining.
* Needs a11y review.
* Touch performance on iOS feels sluggish - is there anything we can do about that?
* Would this be better accordion-style (only one expanded at a time)?
* Is `wp_strip_all_tags()` good enough for column titles that have HTML in them? It's essentially a workaround for the fact that core's comments column does that for the icon, which maybe it shouldn't. Perhaps worth another ticket, as a markup change would be fairly independent.
* Visual hierarchy is not great when expanded (also worthy of another ticket).
* Quick edit now becomes noticeably more annoying to cancel out of, as you have to scroll all the way down and you lose your position from before it was opened. Again, worthy of another ticket.
props Michael Arestad, helen.
see #32395.
Built from https://develop.svn.wordpress.org/trunk@33016
git-svn-id: http://core.svn.wordpress.org/trunk@32987 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-06-30 21:31:25 -04:00
|
|
|
// Not looking at all comments.
|
2020-05-16 14:42:12 -04:00
|
|
|
if ( $comment_status && 'all' !== $comment_status ) {
|
2015-09-22 02:06:25 -04:00
|
|
|
if ( 'approved' === $the_comment_status ) {
|
2019-09-02 20:41:05 -04:00
|
|
|
$actions['unapprove'] = sprintf(
|
|
|
|
'<a href="%s" data-wp-lists="%s" class="vim-u vim-destructive aria-button-if-js" aria-label="%s">%s</a>',
|
|
|
|
$unapprove_url,
|
|
|
|
"delete:the-comment-list:comment-{$comment->comment_ID}:e7e7d3:action=dim-comment&new=unapproved",
|
|
|
|
esc_attr__( 'Unapprove this comment' ),
|
|
|
|
__( 'Unapprove' )
|
|
|
|
);
|
2015-09-22 02:06:25 -04:00
|
|
|
} elseif ( 'unapproved' === $the_comment_status ) {
|
2019-09-02 20:41:05 -04:00
|
|
|
$actions['approve'] = sprintf(
|
|
|
|
'<a href="%s" data-wp-lists="%s" class="vim-a vim-destructive aria-button-if-js" aria-label="%s">%s</a>',
|
|
|
|
$approve_url,
|
|
|
|
"delete:the-comment-list:comment-{$comment->comment_ID}:e7e7d3:action=dim-comment&new=approved",
|
|
|
|
esc_attr__( 'Approve this comment' ),
|
|
|
|
__( 'Approve' )
|
|
|
|
);
|
2010-10-24 22:57:43 -04:00
|
|
|
}
|
List tables: A better responsive view.
Instead of truncating columns, the data that's already in the markup can now be toggled into view. Only seems appropriate to celebrate four years of contributing by finally doing the first thing I ever mocked up.
Known issues / concerns:
* Custom list tables that don't define a primary column will show nothing at all. These are not extremely common, as `WP_List_Table` isn't really recommended for plugin consumption, but it happens. We need to come up with some kind of fallback.
* Some visual elements, particularly whitespace, could use refining.
* Needs a11y review.
* Touch performance on iOS feels sluggish - is there anything we can do about that?
* Would this be better accordion-style (only one expanded at a time)?
* Is `wp_strip_all_tags()` good enough for column titles that have HTML in them? It's essentially a workaround for the fact that core's comments column does that for the icon, which maybe it shouldn't. Perhaps worth another ticket, as a markup change would be fairly independent.
* Visual hierarchy is not great when expanded (also worthy of another ticket).
* Quick edit now becomes noticeably more annoying to cancel out of, as you have to scroll all the way down and you lose your position from before it was opened. Again, worthy of another ticket.
props Michael Arestad, helen.
see #32395.
Built from https://develop.svn.wordpress.org/trunk@33016
git-svn-id: http://core.svn.wordpress.org/trunk@32987 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-06-30 21:31:25 -04:00
|
|
|
} else {
|
2019-09-02 20:41:05 -04:00
|
|
|
$actions['approve'] = sprintf(
|
|
|
|
'<a href="%s" data-wp-lists="%s" class="vim-a aria-button-if-js" aria-label="%s">%s</a>',
|
|
|
|
$approve_url,
|
|
|
|
"dim:the-comment-list:comment-{$comment->comment_ID}:unapproved:e7e7d3:e7e7d3:new=approved",
|
|
|
|
esc_attr__( 'Approve this comment' ),
|
|
|
|
__( 'Approve' )
|
|
|
|
);
|
|
|
|
|
|
|
|
$actions['unapprove'] = sprintf(
|
|
|
|
'<a href="%s" data-wp-lists="%s" class="vim-u aria-button-if-js" aria-label="%s">%s</a>',
|
|
|
|
$unapprove_url,
|
|
|
|
"dim:the-comment-list:comment-{$comment->comment_ID}:unapproved:e7e7d3:e7e7d3:new=unapproved",
|
|
|
|
esc_attr__( 'Unapprove this comment' ),
|
|
|
|
__( 'Unapprove' )
|
|
|
|
);
|
List tables: A better responsive view.
Instead of truncating columns, the data that's already in the markup can now be toggled into view. Only seems appropriate to celebrate four years of contributing by finally doing the first thing I ever mocked up.
Known issues / concerns:
* Custom list tables that don't define a primary column will show nothing at all. These are not extremely common, as `WP_List_Table` isn't really recommended for plugin consumption, but it happens. We need to come up with some kind of fallback.
* Some visual elements, particularly whitespace, could use refining.
* Needs a11y review.
* Touch performance on iOS feels sluggish - is there anything we can do about that?
* Would this be better accordion-style (only one expanded at a time)?
* Is `wp_strip_all_tags()` good enough for column titles that have HTML in them? It's essentially a workaround for the fact that core's comments column does that for the icon, which maybe it shouldn't. Perhaps worth another ticket, as a markup change would be fairly independent.
* Visual hierarchy is not great when expanded (also worthy of another ticket).
* Quick edit now becomes noticeably more annoying to cancel out of, as you have to scroll all the way down and you lose your position from before it was opened. Again, worthy of another ticket.
props Michael Arestad, helen.
see #32395.
Built from https://develop.svn.wordpress.org/trunk@33016
git-svn-id: http://core.svn.wordpress.org/trunk@32987 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-06-30 21:31:25 -04:00
|
|
|
}
|
2010-10-24 22:57:43 -04:00
|
|
|
|
2015-09-22 02:06:25 -04:00
|
|
|
if ( 'spam' !== $the_comment_status ) {
|
2019-09-02 20:57:54 -04:00
|
|
|
$actions['spam'] = sprintf(
|
2019-09-02 20:41:05 -04:00
|
|
|
'<a href="%s" data-wp-lists="%s" class="vim-s vim-destructive aria-button-if-js" aria-label="%s">%s</a>',
|
|
|
|
$spam_url,
|
|
|
|
"delete:the-comment-list:comment-{$comment->comment_ID}::spam=1",
|
|
|
|
esc_attr__( 'Mark this comment as spam' ),
|
|
|
|
/* translators: "Mark as spam" link. */
|
|
|
|
_x( 'Spam', 'verb' )
|
|
|
|
);
|
2015-09-22 02:06:25 -04:00
|
|
|
} elseif ( 'spam' === $the_comment_status ) {
|
2019-09-02 20:41:05 -04:00
|
|
|
$actions['unspam'] = sprintf(
|
|
|
|
'<a href="%s" data-wp-lists="%s" class="vim-z vim-destructive aria-button-if-js" aria-label="%s">%s</a>',
|
|
|
|
$unspam_url,
|
|
|
|
"delete:the-comment-list:comment-{$comment->comment_ID}:66cc66:unspam=1",
|
|
|
|
esc_attr__( 'Restore this comment from the spam' ),
|
|
|
|
_x( 'Not Spam', 'comment' )
|
|
|
|
);
|
List tables: A better responsive view.
Instead of truncating columns, the data that's already in the markup can now be toggled into view. Only seems appropriate to celebrate four years of contributing by finally doing the first thing I ever mocked up.
Known issues / concerns:
* Custom list tables that don't define a primary column will show nothing at all. These are not extremely common, as `WP_List_Table` isn't really recommended for plugin consumption, but it happens. We need to come up with some kind of fallback.
* Some visual elements, particularly whitespace, could use refining.
* Needs a11y review.
* Touch performance on iOS feels sluggish - is there anything we can do about that?
* Would this be better accordion-style (only one expanded at a time)?
* Is `wp_strip_all_tags()` good enough for column titles that have HTML in them? It's essentially a workaround for the fact that core's comments column does that for the icon, which maybe it shouldn't. Perhaps worth another ticket, as a markup change would be fairly independent.
* Visual hierarchy is not great when expanded (also worthy of another ticket).
* Quick edit now becomes noticeably more annoying to cancel out of, as you have to scroll all the way down and you lose your position from before it was opened. Again, worthy of another ticket.
props Michael Arestad, helen.
see #32395.
Built from https://develop.svn.wordpress.org/trunk@33016
git-svn-id: http://core.svn.wordpress.org/trunk@32987 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-06-30 21:31:25 -04:00
|
|
|
}
|
2014-06-29 19:19:16 -04:00
|
|
|
|
2015-09-22 02:06:25 -04:00
|
|
|
if ( 'trash' === $the_comment_status ) {
|
2019-09-02 20:41:05 -04:00
|
|
|
$actions['untrash'] = sprintf(
|
|
|
|
'<a href="%s" data-wp-lists="%s" class="vim-z vim-destructive aria-button-if-js" aria-label="%s">%s</a>',
|
|
|
|
$untrash_url,
|
|
|
|
"delete:the-comment-list:comment-{$comment->comment_ID}:66cc66:untrash=1",
|
|
|
|
esc_attr__( 'Restore this comment from the Trash' ),
|
|
|
|
__( 'Restore' )
|
|
|
|
);
|
List tables: A better responsive view.
Instead of truncating columns, the data that's already in the markup can now be toggled into view. Only seems appropriate to celebrate four years of contributing by finally doing the first thing I ever mocked up.
Known issues / concerns:
* Custom list tables that don't define a primary column will show nothing at all. These are not extremely common, as `WP_List_Table` isn't really recommended for plugin consumption, but it happens. We need to come up with some kind of fallback.
* Some visual elements, particularly whitespace, could use refining.
* Needs a11y review.
* Touch performance on iOS feels sluggish - is there anything we can do about that?
* Would this be better accordion-style (only one expanded at a time)?
* Is `wp_strip_all_tags()` good enough for column titles that have HTML in them? It's essentially a workaround for the fact that core's comments column does that for the icon, which maybe it shouldn't. Perhaps worth another ticket, as a markup change would be fairly independent.
* Visual hierarchy is not great when expanded (also worthy of another ticket).
* Quick edit now becomes noticeably more annoying to cancel out of, as you have to scroll all the way down and you lose your position from before it was opened. Again, worthy of another ticket.
props Michael Arestad, helen.
see #32395.
Built from https://develop.svn.wordpress.org/trunk@33016
git-svn-id: http://core.svn.wordpress.org/trunk@32987 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-06-30 21:31:25 -04:00
|
|
|
}
|
2010-10-24 22:57:43 -04:00
|
|
|
|
2017-11-30 18:11:00 -05:00
|
|
|
if ( 'spam' === $the_comment_status || 'trash' === $the_comment_status || ! EMPTY_TRASH_DAYS ) {
|
2019-09-02 20:41:05 -04:00
|
|
|
$actions['delete'] = sprintf(
|
|
|
|
'<a href="%s" data-wp-lists="%s" class="delete vim-d vim-destructive aria-button-if-js" aria-label="%s">%s</a>',
|
|
|
|
$delete_url,
|
|
|
|
"delete:the-comment-list:comment-{$comment->comment_ID}::delete=1",
|
|
|
|
esc_attr__( 'Delete this comment permanently' ),
|
|
|
|
__( 'Delete Permanently' )
|
|
|
|
);
|
List tables: A better responsive view.
Instead of truncating columns, the data that's already in the markup can now be toggled into view. Only seems appropriate to celebrate four years of contributing by finally doing the first thing I ever mocked up.
Known issues / concerns:
* Custom list tables that don't define a primary column will show nothing at all. These are not extremely common, as `WP_List_Table` isn't really recommended for plugin consumption, but it happens. We need to come up with some kind of fallback.
* Some visual elements, particularly whitespace, could use refining.
* Needs a11y review.
* Touch performance on iOS feels sluggish - is there anything we can do about that?
* Would this be better accordion-style (only one expanded at a time)?
* Is `wp_strip_all_tags()` good enough for column titles that have HTML in them? It's essentially a workaround for the fact that core's comments column does that for the icon, which maybe it shouldn't. Perhaps worth another ticket, as a markup change would be fairly independent.
* Visual hierarchy is not great when expanded (also worthy of another ticket).
* Quick edit now becomes noticeably more annoying to cancel out of, as you have to scroll all the way down and you lose your position from before it was opened. Again, worthy of another ticket.
props Michael Arestad, helen.
see #32395.
Built from https://develop.svn.wordpress.org/trunk@33016
git-svn-id: http://core.svn.wordpress.org/trunk@32987 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-06-30 21:31:25 -04:00
|
|
|
} else {
|
2019-09-02 20:41:05 -04:00
|
|
|
$actions['trash'] = sprintf(
|
|
|
|
'<a href="%s" data-wp-lists="%s" class="delete vim-d vim-destructive aria-button-if-js" aria-label="%s">%s</a>',
|
|
|
|
$trash_url,
|
|
|
|
"delete:the-comment-list:comment-{$comment->comment_ID}::trash=1",
|
|
|
|
esc_attr__( 'Move this comment to the Trash' ),
|
|
|
|
_x( 'Trash', 'verb' )
|
|
|
|
);
|
List tables: A better responsive view.
Instead of truncating columns, the data that's already in the markup can now be toggled into view. Only seems appropriate to celebrate four years of contributing by finally doing the first thing I ever mocked up.
Known issues / concerns:
* Custom list tables that don't define a primary column will show nothing at all. These are not extremely common, as `WP_List_Table` isn't really recommended for plugin consumption, but it happens. We need to come up with some kind of fallback.
* Some visual elements, particularly whitespace, could use refining.
* Needs a11y review.
* Touch performance on iOS feels sluggish - is there anything we can do about that?
* Would this be better accordion-style (only one expanded at a time)?
* Is `wp_strip_all_tags()` good enough for column titles that have HTML in them? It's essentially a workaround for the fact that core's comments column does that for the icon, which maybe it shouldn't. Perhaps worth another ticket, as a markup change would be fairly independent.
* Visual hierarchy is not great when expanded (also worthy of another ticket).
* Quick edit now becomes noticeably more annoying to cancel out of, as you have to scroll all the way down and you lose your position from before it was opened. Again, worthy of another ticket.
props Michael Arestad, helen.
see #32395.
Built from https://develop.svn.wordpress.org/trunk@33016
git-svn-id: http://core.svn.wordpress.org/trunk@32987 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-06-30 21:31:25 -04:00
|
|
|
}
|
2010-10-24 22:57:43 -04:00
|
|
|
|
2015-09-22 02:06:25 -04:00
|
|
|
if ( 'spam' !== $the_comment_status && 'trash' !== $the_comment_status ) {
|
2019-09-02 20:41:05 -04:00
|
|
|
$actions['edit'] = sprintf(
|
|
|
|
'<a href="%s" aria-label="%s">%s</a>',
|
|
|
|
"comment.php?action=editcomment&c={$comment->comment_ID}",
|
|
|
|
esc_attr__( 'Edit this comment' ),
|
|
|
|
__( 'Edit' )
|
|
|
|
);
|
2014-06-23 19:55:16 -04:00
|
|
|
|
2018-02-28 17:36:34 -05:00
|
|
|
$format = '<button type="button" data-comment-id="%d" data-post-id="%d" data-action="%s" class="%s button-link" aria-expanded="false" aria-label="%s">%s</button>';
|
2014-06-23 19:55:16 -04:00
|
|
|
|
2019-09-02 20:41:05 -04:00
|
|
|
$actions['quickedit'] = sprintf(
|
|
|
|
$format,
|
|
|
|
$comment->comment_ID,
|
|
|
|
$comment->comment_post_ID,
|
|
|
|
'edit',
|
|
|
|
'vim-q comment-inline',
|
|
|
|
esc_attr__( 'Quick edit this comment 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' )
|
|
|
|
);
|
List tables: A better responsive view.
Instead of truncating columns, the data that's already in the markup can now be toggled into view. Only seems appropriate to celebrate four years of contributing by finally doing the first thing I ever mocked up.
Known issues / concerns:
* Custom list tables that don't define a primary column will show nothing at all. These are not extremely common, as `WP_List_Table` isn't really recommended for plugin consumption, but it happens. We need to come up with some kind of fallback.
* Some visual elements, particularly whitespace, could use refining.
* Needs a11y review.
* Touch performance on iOS feels sluggish - is there anything we can do about that?
* Would this be better accordion-style (only one expanded at a time)?
* Is `wp_strip_all_tags()` good enough for column titles that have HTML in them? It's essentially a workaround for the fact that core's comments column does that for the icon, which maybe it shouldn't. Perhaps worth another ticket, as a markup change would be fairly independent.
* Visual hierarchy is not great when expanded (also worthy of another ticket).
* Quick edit now becomes noticeably more annoying to cancel out of, as you have to scroll all the way down and you lose your position from before it was opened. Again, worthy of another ticket.
props Michael Arestad, helen.
see #32395.
Built from https://develop.svn.wordpress.org/trunk@33016
git-svn-id: http://core.svn.wordpress.org/trunk@32987 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-06-30 21:31:25 -04:00
|
|
|
}
|
2010-10-24 22:57:43 -04:00
|
|
|
|
List tables: A better responsive view.
Instead of truncating columns, the data that's already in the markup can now be toggled into view. Only seems appropriate to celebrate four years of contributing by finally doing the first thing I ever mocked up.
Known issues / concerns:
* Custom list tables that don't define a primary column will show nothing at all. These are not extremely common, as `WP_List_Table` isn't really recommended for plugin consumption, but it happens. We need to come up with some kind of fallback.
* Some visual elements, particularly whitespace, could use refining.
* Needs a11y review.
* Touch performance on iOS feels sluggish - is there anything we can do about that?
* Would this be better accordion-style (only one expanded at a time)?
* Is `wp_strip_all_tags()` good enough for column titles that have HTML in them? It's essentially a workaround for the fact that core's comments column does that for the icon, which maybe it shouldn't. Perhaps worth another ticket, as a markup change would be fairly independent.
* Visual hierarchy is not great when expanded (also worthy of another ticket).
* Quick edit now becomes noticeably more annoying to cancel out of, as you have to scroll all the way down and you lose your position from before it was opened. Again, worthy of another ticket.
props Michael Arestad, helen.
see #32395.
Built from https://develop.svn.wordpress.org/trunk@33016
git-svn-id: http://core.svn.wordpress.org/trunk@32987 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-06-30 21:31:25 -04:00
|
|
|
/** This filter is documented in wp-admin/includes/dashboard.php */
|
|
|
|
$actions = apply_filters( 'comment_row_actions', array_filter( $actions ), $comment );
|
|
|
|
|
2020-07-07 15:12:03 -04:00
|
|
|
$always_visible = false;
|
2020-07-10 12:04:05 -04:00
|
|
|
|
|
|
|
$mode = get_user_setting( 'posts_list_mode', 'list' );
|
|
|
|
|
2020-07-12 07:36:04 -04:00
|
|
|
if ( 'excerpt' === $mode ) {
|
2020-07-07 15:12:03 -04:00
|
|
|
$always_visible = true;
|
|
|
|
}
|
|
|
|
|
Coding Standards: Use more meaningful variable names for output in the admin.
This renames some variables for clarity, per the [https://developer.wordpress.org/coding-standards/wordpress-coding-standards/php/#naming-conventions Naming Conventions]:
> Don’t abbreviate variable names unnecessarily; let the code be unambiguous and self-documenting.
* `$out` is renamed to `$output` in various list table methods and admin functions.
* `$sep` is renamed to `$separator` in various list table methods and admin functions.
This affects:
* `WP_Comments_List_Table::handle_row_actions()`
* `WP_List_Table::row_actions()`
* `WP_Media_List_Table::column_default()`
* `WP_MS_Sites_List_Table::site_states()`
* `WP_MS_Users_List_Table::column_blogs()`
* `WP_Terms_List_Table::column_name()`
* `_wp_dashboard_recent_comments_row()`
* `image_align_input_fields()`
* `image_size_input_fields()`
* `wp_doc_link_parse()`
* `_post_states()`
* `_media_states()`
Follow-up to [8653], [8692], [8864], [8910], [8911], [8916], [9103], [9153], [10607], [15491], [17793], [32644], [54070].
Props mukesh27, costdev.
See #56448, #55647.
Built from https://develop.svn.wordpress.org/trunk@54071
git-svn-id: http://core.svn.wordpress.org/trunk@53630 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-09-05 13:19:09 -04:00
|
|
|
$output .= '<div class="' . ( $always_visible ? 'row-actions visible' : 'row-actions' ) . '">';
|
2020-07-10 12:04:05 -04:00
|
|
|
|
|
|
|
$i = 0;
|
|
|
|
|
List tables: A better responsive view.
Instead of truncating columns, the data that's already in the markup can now be toggled into view. Only seems appropriate to celebrate four years of contributing by finally doing the first thing I ever mocked up.
Known issues / concerns:
* Custom list tables that don't define a primary column will show nothing at all. These are not extremely common, as `WP_List_Table` isn't really recommended for plugin consumption, but it happens. We need to come up with some kind of fallback.
* Some visual elements, particularly whitespace, could use refining.
* Needs a11y review.
* Touch performance on iOS feels sluggish - is there anything we can do about that?
* Would this be better accordion-style (only one expanded at a time)?
* Is `wp_strip_all_tags()` good enough for column titles that have HTML in them? It's essentially a workaround for the fact that core's comments column does that for the icon, which maybe it shouldn't. Perhaps worth another ticket, as a markup change would be fairly independent.
* Visual hierarchy is not great when expanded (also worthy of another ticket).
* Quick edit now becomes noticeably more annoying to cancel out of, as you have to scroll all the way down and you lose your position from before it was opened. Again, worthy of another ticket.
props Michael Arestad, helen.
see #32395.
Built from https://develop.svn.wordpress.org/trunk@33016
git-svn-id: http://core.svn.wordpress.org/trunk@32987 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-06-30 21:31:25 -04:00
|
|
|
foreach ( $actions as $action => $link ) {
|
|
|
|
++$i;
|
|
|
|
|
2020-07-10 12:04:05 -04:00
|
|
|
if ( ( ( 'approve' === $action || 'unapprove' === $action ) && 2 === $i )
|
|
|
|
|| 1 === $i
|
|
|
|
) {
|
Coding Standards: Use more meaningful variable names for output in the admin.
This renames some variables for clarity, per the [https://developer.wordpress.org/coding-standards/wordpress-coding-standards/php/#naming-conventions Naming Conventions]:
> Don’t abbreviate variable names unnecessarily; let the code be unambiguous and self-documenting.
* `$out` is renamed to `$output` in various list table methods and admin functions.
* `$sep` is renamed to `$separator` in various list table methods and admin functions.
This affects:
* `WP_Comments_List_Table::handle_row_actions()`
* `WP_List_Table::row_actions()`
* `WP_Media_List_Table::column_default()`
* `WP_MS_Sites_List_Table::site_states()`
* `WP_MS_Users_List_Table::column_blogs()`
* `WP_Terms_List_Table::column_name()`
* `_wp_dashboard_recent_comments_row()`
* `image_align_input_fields()`
* `image_size_input_fields()`
* `wp_doc_link_parse()`
* `_post_states()`
* `_media_states()`
Follow-up to [8653], [8692], [8864], [8910], [8911], [8916], [9103], [9153], [10607], [15491], [17793], [32644], [54070].
Props mukesh27, costdev.
See #56448, #55647.
Built from https://develop.svn.wordpress.org/trunk@54071
git-svn-id: http://core.svn.wordpress.org/trunk@53630 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-09-05 13:19:09 -04:00
|
|
|
$separator = '';
|
2020-07-10 12:04:05 -04:00
|
|
|
} else {
|
Coding Standards: Use more meaningful variable names for output in the admin.
This renames some variables for clarity, per the [https://developer.wordpress.org/coding-standards/wordpress-coding-standards/php/#naming-conventions Naming Conventions]:
> Don’t abbreviate variable names unnecessarily; let the code be unambiguous and self-documenting.
* `$out` is renamed to `$output` in various list table methods and admin functions.
* `$sep` is renamed to `$separator` in various list table methods and admin functions.
This affects:
* `WP_Comments_List_Table::handle_row_actions()`
* `WP_List_Table::row_actions()`
* `WP_Media_List_Table::column_default()`
* `WP_MS_Sites_List_Table::site_states()`
* `WP_MS_Users_List_Table::column_blogs()`
* `WP_Terms_List_Table::column_name()`
* `_wp_dashboard_recent_comments_row()`
* `image_align_input_fields()`
* `image_size_input_fields()`
* `wp_doc_link_parse()`
* `_post_states()`
* `_media_states()`
Follow-up to [8653], [8692], [8864], [8910], [8911], [8916], [9103], [9153], [10607], [15491], [17793], [32644], [54070].
Props mukesh27, costdev.
See #56448, #55647.
Built from https://develop.svn.wordpress.org/trunk@54071
git-svn-id: http://core.svn.wordpress.org/trunk@53630 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-09-05 13:19:09 -04:00
|
|
|
$separator = ' | ';
|
2020-07-10 12:04:05 -04:00
|
|
|
}
|
|
|
|
|
|
|
|
// Reply and quickedit need a hide-if-no-js span when not added with Ajax.
|
2017-11-30 18:11:00 -05:00
|
|
|
if ( ( 'reply' === $action || 'quickedit' === $action ) && ! wp_doing_ajax() ) {
|
List tables: A better responsive view.
Instead of truncating columns, the data that's already in the markup can now be toggled into view. Only seems appropriate to celebrate four years of contributing by finally doing the first thing I ever mocked up.
Known issues / concerns:
* Custom list tables that don't define a primary column will show nothing at all. These are not extremely common, as `WP_List_Table` isn't really recommended for plugin consumption, but it happens. We need to come up with some kind of fallback.
* Some visual elements, particularly whitespace, could use refining.
* Needs a11y review.
* Touch performance on iOS feels sluggish - is there anything we can do about that?
* Would this be better accordion-style (only one expanded at a time)?
* Is `wp_strip_all_tags()` good enough for column titles that have HTML in them? It's essentially a workaround for the fact that core's comments column does that for the icon, which maybe it shouldn't. Perhaps worth another ticket, as a markup change would be fairly independent.
* Visual hierarchy is not great when expanded (also worthy of another ticket).
* Quick edit now becomes noticeably more annoying to cancel out of, as you have to scroll all the way down and you lose your position from before it was opened. Again, worthy of another ticket.
props Michael Arestad, helen.
see #32395.
Built from https://develop.svn.wordpress.org/trunk@33016
git-svn-id: http://core.svn.wordpress.org/trunk@32987 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-06-30 21:31:25 -04:00
|
|
|
$action .= ' hide-if-no-js';
|
2020-07-10 12:04:05 -04:00
|
|
|
} elseif ( ( 'untrash' === $action && 'trash' === $the_comment_status )
|
|
|
|
|| ( 'unspam' === $action && 'spam' === $the_comment_status )
|
|
|
|
) {
|
2021-04-18 09:55:07 -04:00
|
|
|
if ( '1' === get_comment_meta( $comment->comment_ID, '_wp_trash_meta_status', true ) ) {
|
List tables: A better responsive view.
Instead of truncating columns, the data that's already in the markup can now be toggled into view. Only seems appropriate to celebrate four years of contributing by finally doing the first thing I ever mocked up.
Known issues / concerns:
* Custom list tables that don't define a primary column will show nothing at all. These are not extremely common, as `WP_List_Table` isn't really recommended for plugin consumption, but it happens. We need to come up with some kind of fallback.
* Some visual elements, particularly whitespace, could use refining.
* Needs a11y review.
* Touch performance on iOS feels sluggish - is there anything we can do about that?
* Would this be better accordion-style (only one expanded at a time)?
* Is `wp_strip_all_tags()` good enough for column titles that have HTML in them? It's essentially a workaround for the fact that core's comments column does that for the icon, which maybe it shouldn't. Perhaps worth another ticket, as a markup change would be fairly independent.
* Visual hierarchy is not great when expanded (also worthy of another ticket).
* Quick edit now becomes noticeably more annoying to cancel out of, as you have to scroll all the way down and you lose your position from before it was opened. Again, worthy of another ticket.
props Michael Arestad, helen.
see #32395.
Built from https://develop.svn.wordpress.org/trunk@33016
git-svn-id: http://core.svn.wordpress.org/trunk@32987 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-06-30 21:31:25 -04:00
|
|
|
$action .= ' approve';
|
2017-11-30 18:11:00 -05:00
|
|
|
} else {
|
List tables: A better responsive view.
Instead of truncating columns, the data that's already in the markup can now be toggled into view. Only seems appropriate to celebrate four years of contributing by finally doing the first thing I ever mocked up.
Known issues / concerns:
* Custom list tables that don't define a primary column will show nothing at all. These are not extremely common, as `WP_List_Table` isn't really recommended for plugin consumption, but it happens. We need to come up with some kind of fallback.
* Some visual elements, particularly whitespace, could use refining.
* Needs a11y review.
* Touch performance on iOS feels sluggish - is there anything we can do about that?
* Would this be better accordion-style (only one expanded at a time)?
* Is `wp_strip_all_tags()` good enough for column titles that have HTML in them? It's essentially a workaround for the fact that core's comments column does that for the icon, which maybe it shouldn't. Perhaps worth another ticket, as a markup change would be fairly independent.
* Visual hierarchy is not great when expanded (also worthy of another ticket).
* Quick edit now becomes noticeably more annoying to cancel out of, as you have to scroll all the way down and you lose your position from before it was opened. Again, worthy of another ticket.
props Michael Arestad, helen.
see #32395.
Built from https://develop.svn.wordpress.org/trunk@33016
git-svn-id: http://core.svn.wordpress.org/trunk@32987 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-06-30 21:31:25 -04:00
|
|
|
$action .= ' unapprove';
|
2017-11-30 18:11:00 -05:00
|
|
|
}
|
2010-10-24 22:57:43 -04:00
|
|
|
}
|
List tables: A better responsive view.
Instead of truncating columns, the data that's already in the markup can now be toggled into view. Only seems appropriate to celebrate four years of contributing by finally doing the first thing I ever mocked up.
Known issues / concerns:
* Custom list tables that don't define a primary column will show nothing at all. These are not extremely common, as `WP_List_Table` isn't really recommended for plugin consumption, but it happens. We need to come up with some kind of fallback.
* Some visual elements, particularly whitespace, could use refining.
* Needs a11y review.
* Touch performance on iOS feels sluggish - is there anything we can do about that?
* Would this be better accordion-style (only one expanded at a time)?
* Is `wp_strip_all_tags()` good enough for column titles that have HTML in them? It's essentially a workaround for the fact that core's comments column does that for the icon, which maybe it shouldn't. Perhaps worth another ticket, as a markup change would be fairly independent.
* Visual hierarchy is not great when expanded (also worthy of another ticket).
* Quick edit now becomes noticeably more annoying to cancel out of, as you have to scroll all the way down and you lose your position from before it was opened. Again, worthy of another ticket.
props Michael Arestad, helen.
see #32395.
Built from https://develop.svn.wordpress.org/trunk@33016
git-svn-id: http://core.svn.wordpress.org/trunk@32987 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-06-30 21:31:25 -04:00
|
|
|
|
Coding Standards: Use more meaningful variable names for output in the admin.
This renames some variables for clarity, per the [https://developer.wordpress.org/coding-standards/wordpress-coding-standards/php/#naming-conventions Naming Conventions]:
> Don’t abbreviate variable names unnecessarily; let the code be unambiguous and self-documenting.
* `$out` is renamed to `$output` in various list table methods and admin functions.
* `$sep` is renamed to `$separator` in various list table methods and admin functions.
This affects:
* `WP_Comments_List_Table::handle_row_actions()`
* `WP_List_Table::row_actions()`
* `WP_Media_List_Table::column_default()`
* `WP_MS_Sites_List_Table::site_states()`
* `WP_MS_Users_List_Table::column_blogs()`
* `WP_Terms_List_Table::column_name()`
* `_wp_dashboard_recent_comments_row()`
* `image_align_input_fields()`
* `image_size_input_fields()`
* `wp_doc_link_parse()`
* `_post_states()`
* `_media_states()`
Follow-up to [8653], [8692], [8864], [8910], [8911], [8916], [9103], [9153], [10607], [15491], [17793], [32644], [54070].
Props mukesh27, costdev.
See #56448, #55647.
Built from https://develop.svn.wordpress.org/trunk@54071
git-svn-id: http://core.svn.wordpress.org/trunk@53630 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-09-05 13:19:09 -04:00
|
|
|
$output .= "<span class='$action'>{$separator}{$link}</span>";
|
2015-05-28 22:41:25 -04:00
|
|
|
}
|
2020-07-10 12:04:05 -04:00
|
|
|
|
Coding Standards: Use more meaningful variable names for output in the admin.
This renames some variables for clarity, per the [https://developer.wordpress.org/coding-standards/wordpress-coding-standards/php/#naming-conventions Naming Conventions]:
> Don’t abbreviate variable names unnecessarily; let the code be unambiguous and self-documenting.
* `$out` is renamed to `$output` in various list table methods and admin functions.
* `$sep` is renamed to `$separator` in various list table methods and admin functions.
This affects:
* `WP_Comments_List_Table::handle_row_actions()`
* `WP_List_Table::row_actions()`
* `WP_Media_List_Table::column_default()`
* `WP_MS_Sites_List_Table::site_states()`
* `WP_MS_Users_List_Table::column_blogs()`
* `WP_Terms_List_Table::column_name()`
* `_wp_dashboard_recent_comments_row()`
* `image_align_input_fields()`
* `image_size_input_fields()`
* `wp_doc_link_parse()`
* `_post_states()`
* `_media_states()`
Follow-up to [8653], [8692], [8864], [8910], [8911], [8916], [9103], [9153], [10607], [15491], [17793], [32644], [54070].
Props mukesh27, costdev.
See #56448, #55647.
Built from https://develop.svn.wordpress.org/trunk@54071
git-svn-id: http://core.svn.wordpress.org/trunk@53630 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-09-05 13:19:09 -04:00
|
|
|
$output .= '</div>';
|
List tables: A better responsive view.
Instead of truncating columns, the data that's already in the markup can now be toggled into view. Only seems appropriate to celebrate four years of contributing by finally doing the first thing I ever mocked up.
Known issues / concerns:
* Custom list tables that don't define a primary column will show nothing at all. These are not extremely common, as `WP_List_Table` isn't really recommended for plugin consumption, but it happens. We need to come up with some kind of fallback.
* Some visual elements, particularly whitespace, could use refining.
* Needs a11y review.
* Touch performance on iOS feels sluggish - is there anything we can do about that?
* Would this be better accordion-style (only one expanded at a time)?
* Is `wp_strip_all_tags()` good enough for column titles that have HTML in them? It's essentially a workaround for the fact that core's comments column does that for the icon, which maybe it shouldn't. Perhaps worth another ticket, as a markup change would be fairly independent.
* Visual hierarchy is not great when expanded (also worthy of another ticket).
* Quick edit now becomes noticeably more annoying to cancel out of, as you have to scroll all the way down and you lose your position from before it was opened. Again, worthy of another ticket.
props Michael Arestad, helen.
see #32395.
Built from https://develop.svn.wordpress.org/trunk@33016
git-svn-id: http://core.svn.wordpress.org/trunk@32987 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-06-30 21:31:25 -04:00
|
|
|
|
I18N: Mark screen reader strings as such with translator comments.
This aims to provide better context for translators and make it easier to determine that some strings contain hidden accessibility text and are not displayed in the UI.
Props kebbet, mercime, pavelevap, ocean90, swissspidy, Chouby, jipmoors, afercia, desrosj, costdev, audrasjb, SergeyBiryukov.
Fixes #29748.
Built from https://develop.svn.wordpress.org/trunk@55276
git-svn-id: http://core.svn.wordpress.org/trunk@54809 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2023-02-07 12:10:21 -05:00
|
|
|
$output .= '<button type="button" class="toggle-row"><span class="screen-reader-text">' .
|
|
|
|
/* translators: Hidden accessibility text. */
|
|
|
|
__( 'Show more details' ) .
|
|
|
|
'</span></button>';
|
2015-05-28 22:41:25 -04:00
|
|
|
|
Coding Standards: Use more meaningful variable names for output in the admin.
This renames some variables for clarity, per the [https://developer.wordpress.org/coding-standards/wordpress-coding-standards/php/#naming-conventions Naming Conventions]:
> Don’t abbreviate variable names unnecessarily; let the code be unambiguous and self-documenting.
* `$out` is renamed to `$output` in various list table methods and admin functions.
* `$sep` is renamed to `$separator` in various list table methods and admin functions.
This affects:
* `WP_Comments_List_Table::handle_row_actions()`
* `WP_List_Table::row_actions()`
* `WP_Media_List_Table::column_default()`
* `WP_MS_Sites_List_Table::site_states()`
* `WP_MS_Users_List_Table::column_blogs()`
* `WP_Terms_List_Table::column_name()`
* `_wp_dashboard_recent_comments_row()`
* `image_align_input_fields()`
* `image_size_input_fields()`
* `wp_doc_link_parse()`
* `_post_states()`
* `_media_states()`
Follow-up to [8653], [8692], [8864], [8910], [8911], [8916], [9103], [9153], [10607], [15491], [17793], [32644], [54070].
Props mukesh27, costdev.
See #56448, #55647.
Built from https://develop.svn.wordpress.org/trunk@54071
git-svn-id: http://core.svn.wordpress.org/trunk@53630 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-09-05 13:19:09 -04:00
|
|
|
return $output;
|
2015-05-28 22:41:25 -04:00
|
|
|
}
|
|
|
|
|
2015-05-29 16:17:26 -04:00
|
|
|
/**
|
Code Modernization: Fix parameter name mismatches for parent/child classes in `WP_List_Table::column_cb()`.
Matches the method signatures of the parent class and each child class.
Why? PHP 8 introduces the ability to pass named arguments to function/method calls. This means the child and parent method signatures (i.e. parameter names) need to match.
For readability:
- `@since` clearly specifies the original parameter name and its new name as well as why the change happened
- in methods longer than a single line, the generic parameter is reassigned to the original parameter restoring it for context for use within the method. An inline comment is added to explain why this reassignment is made.
Follow-up to [15632], [30679], [31210], [32740], [32753], [32754], [32755], [32756], [32757].
Props jrf, hellofromTonya, sergeybiryukov, azaozz, desrosj, johnbillion.
See #51553.
Built from https://develop.svn.wordpress.org/trunk@51735
git-svn-id: http://core.svn.wordpress.org/trunk@51343 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2021-09-07 14:19:56 -04:00
|
|
|
* @since 5.9.0 Renamed `$comment` to `$item` to match parent class for PHP 8 named parameter support.
|
|
|
|
*
|
|
|
|
* @param WP_Comment $item The comment object.
|
2015-05-29 16:17:26 -04:00
|
|
|
*/
|
Code Modernization: Fix parameter name mismatches for parent/child classes in `WP_List_Table::column_cb()`.
Matches the method signatures of the parent class and each child class.
Why? PHP 8 introduces the ability to pass named arguments to function/method calls. This means the child and parent method signatures (i.e. parameter names) need to match.
For readability:
- `@since` clearly specifies the original parameter name and its new name as well as why the change happened
- in methods longer than a single line, the generic parameter is reassigned to the original parameter restoring it for context for use within the method. An inline comment is added to explain why this reassignment is made.
Follow-up to [15632], [30679], [31210], [32740], [32753], [32754], [32755], [32756], [32757].
Props jrf, hellofromTonya, sergeybiryukov, azaozz, desrosj, johnbillion.
See #51553.
Built from https://develop.svn.wordpress.org/trunk@51735
git-svn-id: http://core.svn.wordpress.org/trunk@51343 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2021-09-07 14:19:56 -04:00
|
|
|
public function column_cb( $item ) {
|
|
|
|
// Restores the more descriptive, specific name for use within this method.
|
|
|
|
$comment = $item;
|
|
|
|
|
2017-11-30 18:11:00 -05:00
|
|
|
if ( $this->user_can ) {
|
2018-08-16 21:51:36 -04:00
|
|
|
?>
|
I18N: Mark screen reader strings as such with translator comments.
This aims to provide better context for translators and make it easier to determine that some strings contain hidden accessibility text and are not displayed in the UI.
Props kebbet, mercime, pavelevap, ocean90, swissspidy, Chouby, jipmoors, afercia, desrosj, costdev, audrasjb, SergeyBiryukov.
Fixes #29748.
Built from https://develop.svn.wordpress.org/trunk@55276
git-svn-id: http://core.svn.wordpress.org/trunk@54809 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2023-02-07 12:10:21 -05:00
|
|
|
<label class="screen-reader-text" for="cb-select-<?php echo $comment->comment_ID; ?>">
|
|
|
|
<?php
|
|
|
|
/* translators: Hidden accessibility text. */
|
|
|
|
_e( 'Select comment' );
|
|
|
|
?>
|
|
|
|
</label>
|
2015-05-28 22:41:25 -04:00
|
|
|
<input id="cb-select-<?php echo $comment->comment_ID; ?>" type="checkbox" name="delete_comments[]" value="<?php echo $comment->comment_ID; ?>" />
|
2018-08-16 21:51:36 -04:00
|
|
|
<?php
|
2015-05-28 22:41:25 -04:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2016-01-09 19:52:25 -05:00
|
|
|
* @param WP_Comment $comment The comment object.
|
2015-05-28 22:41:25 -04:00
|
|
|
*/
|
|
|
|
public function column_comment( $comment ) {
|
|
|
|
echo '<div class="comment-author">';
|
|
|
|
$this->column_author( $comment );
|
|
|
|
echo '</div>';
|
|
|
|
|
|
|
|
if ( $comment->comment_parent ) {
|
|
|
|
$parent = get_comment( $comment->comment_parent );
|
2021-05-03 10:10:00 -04:00
|
|
|
|
2015-09-10 16:51:23 -04:00
|
|
|
if ( $parent ) {
|
|
|
|
$parent_link = esc_url( get_comment_link( $parent ) );
|
2017-11-30 18:11:00 -05:00
|
|
|
$name = get_comment_author( $parent );
|
2015-09-18 14:36:24 -04:00
|
|
|
printf(
|
2019-09-02 20:41:05 -04:00
|
|
|
/* translators: %s: Comment link. */
|
2015-09-24 13:27:26 -04:00
|
|
|
__( 'In reply to %s.' ),
|
2015-09-18 14:36:24 -04:00
|
|
|
'<a href="' . $parent_link . '">' . $name . '</a>'
|
|
|
|
);
|
2015-09-10 16:51:23 -04:00
|
|
|
}
|
2015-05-28 22:41:25 -04:00
|
|
|
}
|
|
|
|
|
2015-09-08 23:00:24 -04:00
|
|
|
comment_text( $comment );
|
2018-02-08 05:57:32 -05:00
|
|
|
|
2017-11-30 18:11:00 -05:00
|
|
|
if ( $this->user_can ) {
|
2015-05-28 22:41:25 -04:00
|
|
|
/** This filter is documented in wp-admin/includes/comment.php */
|
2018-02-08 05:57:32 -05:00
|
|
|
$comment_content = apply_filters( 'comment_edit_pre', $comment->comment_content );
|
2018-08-16 21:51:36 -04:00
|
|
|
?>
|
2018-02-08 05:57:32 -05:00
|
|
|
<div id="inline-<?php echo $comment->comment_ID; ?>" class="hidden">
|
|
|
|
<textarea class="comment" rows="1" cols="1"><?php echo esc_textarea( $comment_content ); ?></textarea>
|
2022-07-04 04:16:16 -04:00
|
|
|
<div class="author-email"><?php echo esc_html( $comment->comment_author_email ); ?></div>
|
|
|
|
<div class="author"><?php echo esc_html( $comment->comment_author ); ?></div>
|
2022-03-19 16:31:12 -04:00
|
|
|
<div class="author-url"><?php echo esc_url( $comment->comment_author_url ); ?></div>
|
2018-02-08 05:57:32 -05:00
|
|
|
<div class="comment_status"><?php echo $comment->comment_approved; ?></div>
|
2015-05-28 22:41:25 -04:00
|
|
|
</div>
|
2018-08-16 21:51:36 -04:00
|
|
|
<?php
|
2010-10-24 22:57:43 -04:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2015-05-28 17:41:30 -04:00
|
|
|
/**
|
|
|
|
* @global string $comment_status
|
2015-05-29 16:17:26 -04:00
|
|
|
*
|
2016-01-09 19:52:25 -05:00
|
|
|
* @param WP_Comment $comment The comment object.
|
2015-05-28 17:41:30 -04:00
|
|
|
*/
|
2014-05-18 19:59:15 -04:00
|
|
|
public function column_author( $comment ) {
|
2010-10-24 22:57:43 -04:00
|
|
|
global $comment_status;
|
|
|
|
|
2015-09-08 23:00:24 -04:00
|
|
|
$author_url = get_comment_author_url( $comment );
|
2015-08-31 16:41:21 -04:00
|
|
|
|
2015-09-03 19:23:24 -04:00
|
|
|
$author_url_display = untrailingslashit( preg_replace( '|^http(s)?://(www\.)?|i', '', $author_url ) );
|
2021-05-03 10:10:00 -04:00
|
|
|
|
2015-08-31 16:41:21 -04:00
|
|
|
if ( strlen( $author_url_display ) > 50 ) {
|
|
|
|
$author_url_display = wp_html_excerpt( $author_url_display, 49, '…' );
|
|
|
|
}
|
|
|
|
|
2017-11-30 18:11:00 -05:00
|
|
|
echo '<strong>';
|
|
|
|
comment_author( $comment );
|
|
|
|
echo '</strong><br />';
|
2021-05-03 10:10:00 -04:00
|
|
|
|
2015-09-03 19:23:24 -04:00
|
|
|
if ( ! empty( $author_url_display ) ) {
|
2021-11-03 16:02:02 -04:00
|
|
|
// Print link to author URL, and disallow referrer information (without using target="_blank").
|
|
|
|
printf(
|
|
|
|
'<a href="%s" rel="noopener noreferrer">%s</a><br />',
|
|
|
|
esc_url( $author_url ),
|
|
|
|
esc_html( $author_url_display )
|
|
|
|
);
|
2015-08-31 16:41:21 -04:00
|
|
|
}
|
2010-10-24 22:57:43 -04:00
|
|
|
|
|
|
|
if ( $this->user_can ) {
|
2015-08-31 17:09:21 -04:00
|
|
|
if ( ! empty( $comment->comment_author_email ) ) {
|
2017-01-04 08:21:41 -05:00
|
|
|
/** This filter is documented in wp-includes/comment-template.php */
|
2015-08-31 17:09:21 -04:00
|
|
|
$email = apply_filters( 'comment_email', $comment->comment_author_email, $comment );
|
2015-08-31 17:22:21 -04:00
|
|
|
|
2015-08-31 17:09:21 -04:00
|
|
|
if ( ! empty( $email ) && '@' !== $email ) {
|
2015-11-28 21:43:24 -05:00
|
|
|
printf( '<a href="%1$s">%2$s</a><br />', esc_url( 'mailto:' . $email ), esc_html( $email ) );
|
2015-08-31 17:09:21 -04:00
|
|
|
}
|
2010-10-24 22:57:43 -04:00
|
|
|
}
|
2014-09-28 02:38:18 -04:00
|
|
|
|
2015-09-08 23:00:24 -04:00
|
|
|
$author_ip = get_comment_author_IP( $comment );
|
2021-05-03 10:10:00 -04:00
|
|
|
|
2014-09-28 02:38:18 -04:00
|
|
|
if ( $author_ip ) {
|
2017-11-30 18:11:00 -05:00
|
|
|
$author_ip_url = add_query_arg(
|
|
|
|
array(
|
|
|
|
's' => $author_ip,
|
|
|
|
'mode' => 'detail',
|
2018-08-16 21:51:36 -04:00
|
|
|
),
|
|
|
|
admin_url( 'edit-comments.php' )
|
2017-11-30 18:11:00 -05:00
|
|
|
);
|
2021-05-03 10:10:00 -04:00
|
|
|
|
2015-09-22 02:06:25 -04:00
|
|
|
if ( 'spam' === $comment_status ) {
|
2014-09-28 02:38:18 -04:00
|
|
|
$author_ip_url = add_query_arg( 'comment_status', 'spam', $author_ip_url );
|
|
|
|
}
|
2021-05-03 10:10:00 -04:00
|
|
|
|
2015-11-28 21:43:24 -05:00
|
|
|
printf( '<a href="%1$s">%2$s</a>', esc_url( $author_ip_url ), esc_html( $author_ip ) );
|
2014-09-28 02:38:18 -04:00
|
|
|
}
|
2010-10-24 22:57:43 -04:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2015-05-29 16:17:26 -04:00
|
|
|
/**
|
2016-01-09 19:52:25 -05:00
|
|
|
* @param WP_Comment $comment The comment object.
|
2015-05-29 16:17:26 -04:00
|
|
|
*/
|
2015-08-31 16:59:21 -04:00
|
|
|
public function column_date( $comment ) {
|
2017-11-30 18:11:00 -05:00
|
|
|
$submitted = sprintf(
|
2019-09-02 20:41:05 -04:00
|
|
|
/* translators: 1: Comment date, 2: Comment time. */
|
2017-11-30 18:11:00 -05:00
|
|
|
__( '%1$s at %2$s' ),
|
2020-09-18 06:37:08 -04:00
|
|
|
/* translators: Comment date format. See https://www.php.net/manual/datetime.format.php */
|
2015-09-24 13:27:26 -04:00
|
|
|
get_comment_date( __( 'Y/m/d' ), $comment ),
|
2020-09-18 06:37:08 -04:00
|
|
|
/* translators: Comment time format. See https://www.php.net/manual/datetime.format.php */
|
2015-12-06 23:26:27 -05:00
|
|
|
get_comment_date( __( 'g:i a' ), $comment )
|
2015-09-24 13:27:26 -04:00
|
|
|
);
|
2016-02-12 16:43:26 -05:00
|
|
|
|
|
|
|
echo '<div class="submitted-on">';
|
2021-05-03 10:10:00 -04:00
|
|
|
|
2017-11-30 18:11:00 -05:00
|
|
|
if ( 'approved' === wp_get_comment_status( $comment ) && ! empty( $comment->comment_post_ID ) ) {
|
2016-02-12 16:43:26 -05:00
|
|
|
printf(
|
|
|
|
'<a href="%s">%s</a>',
|
|
|
|
esc_url( get_comment_link( $comment ) ),
|
|
|
|
$submitted
|
|
|
|
);
|
|
|
|
} else {
|
|
|
|
echo $submitted;
|
|
|
|
}
|
2021-05-03 10:10:00 -04:00
|
|
|
|
2015-09-24 13:27:26 -04:00
|
|
|
echo '</div>';
|
2010-10-24 22:57:43 -04:00
|
|
|
}
|
|
|
|
|
2015-05-29 17:32:24 -04:00
|
|
|
/**
|
2016-01-09 19:52:25 -05:00
|
|
|
* @param WP_Comment $comment The comment object.
|
2015-05-29 17:32:24 -04:00
|
|
|
*/
|
2016-01-09 19:52:25 -05:00
|
|
|
public function column_response( $comment ) {
|
2012-09-04 12:29:28 -04:00
|
|
|
$post = get_post();
|
2010-10-24 22:57:43 -04:00
|
|
|
|
2015-08-13 18:31:24 -04:00
|
|
|
if ( ! $post ) {
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
2017-11-30 18:11:00 -05:00
|
|
|
if ( isset( $this->pending_count[ $post->ID ] ) ) {
|
|
|
|
$pending_comments = $this->pending_count[ $post->ID ];
|
2010-10-24 22:57:43 -04:00
|
|
|
} else {
|
2019-07-01 08:52:01 -04:00
|
|
|
$_pending_count_temp = get_pending_comments_num( array( $post->ID ) );
|
|
|
|
$pending_comments = $_pending_count_temp[ $post->ID ];
|
|
|
|
$this->pending_count[ $post->ID ] = $pending_comments;
|
2010-10-24 22:57:43 -04:00
|
|
|
}
|
|
|
|
|
|
|
|
if ( current_user_can( 'edit_post', $post->ID ) ) {
|
2017-11-30 18:11:00 -05:00
|
|
|
$post_link = "<a href='" . get_edit_post_link( $post->ID ) . "' class='comments-edit-item-link'>";
|
2015-04-20 03:39:25 -04:00
|
|
|
$post_link .= esc_html( get_the_title( $post->ID ) ) . '</a>';
|
2010-10-24 22:57:43 -04:00
|
|
|
} else {
|
2015-04-20 03:39:25 -04:00
|
|
|
$post_link = esc_html( get_the_title( $post->ID ) );
|
2010-10-24 22:57:43 -04:00
|
|
|
}
|
|
|
|
|
2015-07-10 17:44:25 -04:00
|
|
|
echo '<div class="response-links">';
|
2021-05-03 10:10:00 -04:00
|
|
|
|
2019-07-01 08:52:01 -04:00
|
|
|
if ( 'attachment' === $post->post_type ) {
|
|
|
|
$thumb = wp_get_attachment_image( $post->ID, array( 80, 60 ), true );
|
|
|
|
if ( $thumb ) {
|
|
|
|
echo $thumb;
|
|
|
|
}
|
2015-07-10 17:44:25 -04:00
|
|
|
}
|
2021-05-03 10:10:00 -04:00
|
|
|
|
2015-07-29 14:08:25 -04:00
|
|
|
echo $post_link;
|
2021-05-03 10:10:00 -04:00
|
|
|
|
2015-07-29 14:08:25 -04:00
|
|
|
$post_type_object = get_post_type_object( $post->post_type );
|
|
|
|
echo "<a href='" . get_permalink( $post->ID ) . "' class='comments-view-item-link'>" . $post_type_object->labels->view_item . '</a>';
|
2021-05-03 10:10:00 -04:00
|
|
|
|
2015-08-20 12:36:25 -04:00
|
|
|
echo '<span class="post-com-count-wrapper post-com-count-', $post->ID, '">';
|
2015-07-10 17:44:25 -04:00
|
|
|
$this->comments_bubble( $post->ID, $pending_comments );
|
|
|
|
echo '</span> ';
|
2021-05-03 10:10:00 -04:00
|
|
|
|
2015-07-29 14:08:25 -04:00
|
|
|
echo '</div>';
|
2010-10-24 22:57:43 -04:00
|
|
|
}
|
|
|
|
|
2015-05-29 16:17:26 -04:00
|
|
|
/**
|
2021-09-07 12:57:58 -04:00
|
|
|
* @since 5.9.0 Renamed `$comment` to `$item` to match parent class for PHP 8 named parameter support.
|
Code Modernization: Fix parameter name mismatches for parent/child classes in `WP_List_Table::column_default()`.
Matches the method signatures of the parent class and each child class.
Why? PHP 8 introduces the ability to pass named arguments to function/method calls. This means the child and parent method signatures (i.e. parameter names) need to match.
For readability:
- `@since` clearly specifies the original parameter name and its new name as well as why the change happened
- in methods longer than a single line, the generic parameter is reassigned to the original parameter restoring it for context for use within the method. An inline comment is added to explain why this reassignment is made.
Follow-up to [15632], [30679], [31210], [32740], [32753], [32754], [32755], [32756], [32757].
Props jrf, hellofromTonya, @sergeybiryukov, @azaozz, @desrosj, @johnbillion
See #51553.
Built from https://develop.svn.wordpress.org/trunk@51728
git-svn-id: http://core.svn.wordpress.org/trunk@51334 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2021-09-02 18:26:56 -04:00
|
|
|
*
|
|
|
|
* @param WP_Comment $item The comment object.
|
2016-01-09 19:52:25 -05:00
|
|
|
* @param string $column_name The custom column's name.
|
2015-05-29 16:17:26 -04:00
|
|
|
*/
|
Code Modernization: Fix parameter name mismatches for parent/child classes in `WP_List_Table::column_default()`.
Matches the method signatures of the parent class and each child class.
Why? PHP 8 introduces the ability to pass named arguments to function/method calls. This means the child and parent method signatures (i.e. parameter names) need to match.
For readability:
- `@since` clearly specifies the original parameter name and its new name as well as why the change happened
- in methods longer than a single line, the generic parameter is reassigned to the original parameter restoring it for context for use within the method. An inline comment is added to explain why this reassignment is made.
Follow-up to [15632], [30679], [31210], [32740], [32753], [32754], [32755], [32756], [32757].
Props jrf, hellofromTonya, @sergeybiryukov, @azaozz, @desrosj, @johnbillion
See #51553.
Built from https://develop.svn.wordpress.org/trunk@51728
git-svn-id: http://core.svn.wordpress.org/trunk@51334 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2021-09-02 18:26:56 -04:00
|
|
|
public function column_default( $item, $column_name ) {
|
2013-11-13 14:47:10 -05:00
|
|
|
/**
|
|
|
|
* Fires when the default column output is displayed for a single row.
|
|
|
|
*
|
|
|
|
* @since 2.8.0
|
|
|
|
*
|
2020-07-23 15:06:03 -04:00
|
|
|
* @param string $column_name The custom column's name.
|
2021-11-18 08:57:01 -05:00
|
|
|
* @param string $comment_id The comment ID as a numeric string.
|
2013-11-13 14:47:10 -05:00
|
|
|
*/
|
Code Modernization: Fix parameter name mismatches for parent/child classes in `WP_List_Table::column_default()`.
Matches the method signatures of the parent class and each child class.
Why? PHP 8 introduces the ability to pass named arguments to function/method calls. This means the child and parent method signatures (i.e. parameter names) need to match.
For readability:
- `@since` clearly specifies the original parameter name and its new name as well as why the change happened
- in methods longer than a single line, the generic parameter is reassigned to the original parameter restoring it for context for use within the method. An inline comment is added to explain why this reassignment is made.
Follow-up to [15632], [30679], [31210], [32740], [32753], [32754], [32755], [32756], [32757].
Props jrf, hellofromTonya, @sergeybiryukov, @azaozz, @desrosj, @johnbillion
See #51553.
Built from https://develop.svn.wordpress.org/trunk@51728
git-svn-id: http://core.svn.wordpress.org/trunk@51334 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2021-09-02 18:26:56 -04:00
|
|
|
do_action( 'manage_comments_custom_column', $column_name, $item->comment_ID );
|
2010-10-24 22:57:43 -04:00
|
|
|
}
|
|
|
|
}
|