3 * Edit Comments Administration Screen.
6 * @subpackage Administration
9 /** WordPress Administration Bootstrap */
10 require_once( dirname( __FILE__ ) . '/admin.php' );
11 if ( ! current_user_can( 'edit_posts' ) ) {
13 '<h1>' . __( 'Cheatin’ uh?' ) . '</h1>' .
14 '<p>' . __( 'Sorry, you are not allowed to edit comments.' ) . '</p>',
19 $wp_list_table = _get_list_table('WP_Comments_List_Table');
20 $pagenum = $wp_list_table->get_pagenum();
22 $doaction = $wp_list_table->current_action();
25 check_admin_referer( 'bulk-comments' );
27 if ( 'delete_all' == $doaction && !empty( $_REQUEST['pagegen_timestamp'] ) ) {
28 $comment_status = wp_unslash( $_REQUEST['comment_status'] );
29 $delete_time = wp_unslash( $_REQUEST['pagegen_timestamp'] );
30 $comment_ids = $wpdb->get_col( $wpdb->prepare( "SELECT comment_ID FROM $wpdb->comments WHERE comment_approved = %s AND %s > comment_date_gmt", $comment_status, $delete_time ) );
32 } elseif ( isset( $_REQUEST['delete_comments'] ) ) {
33 $comment_ids = $_REQUEST['delete_comments'];
34 $doaction = ( $_REQUEST['action'] != -1 ) ? $_REQUEST['action'] : $_REQUEST['action2'];
35 } elseif ( isset( $_REQUEST['ids'] ) ) {
36 $comment_ids = array_map( 'absint', explode( ',', $_REQUEST['ids'] ) );
37 } elseif ( wp_get_referer() ) {
38 wp_safe_redirect( wp_get_referer() );
42 $approved = $unapproved = $spammed = $unspammed = $trashed = $untrashed = $deleted = 0;
44 $redirect_to = remove_query_arg( array( 'trashed', 'untrashed', 'deleted', 'spammed', 'unspammed', 'approved', 'unapproved', 'ids' ), wp_get_referer() );
45 $redirect_to = add_query_arg( 'paged', $pagenum, $redirect_to );
47 wp_defer_comment_counting( true );
49 foreach ( $comment_ids as $comment_id ) { // Check the permissions on each
50 if ( !current_user_can( 'edit_comment', $comment_id ) )
53 switch ( $doaction ) {
55 wp_set_comment_status( $comment_id, 'approve' );
59 wp_set_comment_status( $comment_id, 'hold' );
63 wp_spam_comment( $comment_id );
67 wp_unspam_comment( $comment_id );
71 wp_trash_comment( $comment_id );
75 wp_untrash_comment( $comment_id );
79 wp_delete_comment( $comment_id );
85 if ( ! in_array( $doaction, array( 'approve', 'unapprove', 'spam', 'unspam', 'trash', 'delete' ), true ) ) {
87 * Fires when a custom bulk action should be handled.
89 * The redirect link should be modified with success or failure feedback
90 * from the action to be used to display feedback to the user.
94 * @param string $redirect_url The redirect URL.
95 * @param string $doaction The action being taken.
96 * @param array $items The items to take the action on.
98 $redirect_to = apply_filters( 'handle_bulk_actions-' . get_current_screen()->id, $redirect_to, $doaction, $comment_ids );
101 wp_defer_comment_counting( false );
104 $redirect_to = add_query_arg( 'approved', $approved, $redirect_to );
106 $redirect_to = add_query_arg( 'unapproved', $unapproved, $redirect_to );
108 $redirect_to = add_query_arg( 'spammed', $spammed, $redirect_to );
110 $redirect_to = add_query_arg( 'unspammed', $unspammed, $redirect_to );
112 $redirect_to = add_query_arg( 'trashed', $trashed, $redirect_to );
114 $redirect_to = add_query_arg( 'untrashed', $untrashed, $redirect_to );
116 $redirect_to = add_query_arg( 'deleted', $deleted, $redirect_to );
117 if ( $trashed || $spammed )
118 $redirect_to = add_query_arg( 'ids', join( ',', $comment_ids ), $redirect_to );
120 wp_safe_redirect( $redirect_to );
122 } elseif ( ! empty( $_GET['_wp_http_referer'] ) ) {
123 wp_redirect( remove_query_arg( array( '_wp_http_referer', '_wpnonce' ), wp_unslash( $_SERVER['REQUEST_URI'] ) ) );
127 $wp_list_table->prepare_items();
129 wp_enqueue_script('admin-comments');
130 enqueue_comment_hotkeys_js();
133 $comments_count = wp_count_comments( $post_id );
134 $draft_or_post_title = wp_html_excerpt( _draft_or_post_title( $post_id ), 50, '…' );
135 if ( $comments_count->moderated > 0 ) {
136 /* translators: 1: comments count 2: post title */
137 $title = sprintf( __( 'Comments (%1$s) on “%2$s”' ),
138 number_format_i18n( $comments_count->moderated ),
142 /* translators: %s: post title */
143 $title = sprintf( __( 'Comments on “%s”' ),
148 $comments_count = wp_count_comments();
149 if ( $comments_count->moderated > 0 ) {
150 /* translators: %s: comments count */
151 $title = sprintf( __( 'Comments (%s)' ),
152 number_format_i18n( $comments_count->moderated )
155 $title = __( 'Comments' );
159 add_screen_option( 'per_page' );
161 get_current_screen()->add_help_tab( array(
163 'title' => __('Overview'),
165 '<p>' . __( 'You can manage comments made on your site similar to the way you manage posts and other content. This screen is customizable in the same ways as other management screens, and you can act on comments using the on-hover action links or the Bulk Actions.' ) . '</p>'
167 get_current_screen()->add_help_tab( array(
168 'id' => 'moderating-comments',
169 'title' => __('Moderating Comments'),
171 '<p>' . __( 'A red bar on the left means the comment is waiting for you to moderate it.' ) . '</p>' .
172 '<p>' . __( 'In the <strong>Author</strong> column, in addition to the author’s name, email address, and blog URL, the commenter’s IP address is shown. Clicking on this link will show you all the comments made from this IP address.' ) . '</p>' .
173 '<p>' . __( 'In the <strong>Comment</strong> column, hovering over any comment gives you options to approve, reply (and approve), quick edit, edit, spam mark, or trash that comment.' ) . '</p>' .
174 '<p>' . __( 'In the <strong>In Response To</strong> column, there are three elements. The text is the name of the post that inspired the comment, and links to the post editor for that entry. The View Post link leads to that post on your live site. The small bubble with the number in it shows the number of approved comments that post has received. If there are pending comments, a red notification circle with the number of pending comments is displayed. Clicking the notification circle will filter the comments screen to show only pending comments on that post.' ) . '</p>' .
175 '<p>' . __( 'In the <strong>Submitted On</strong> column, the date and time the comment was left on your site appears. Clicking on the date/time link will take you to that comment on your live site.' ) . '</p>' .
176 '<p>' . __( 'Many people take advantage of keyboard shortcuts to moderate their comments more quickly. Use the link to the side to learn more.' ) . '</p>'
179 get_current_screen()->set_help_sidebar(
180 '<p><strong>' . __( 'For more information:' ) . '</strong></p>' .
181 '<p>' . __( '<a href="https://codex.wordpress.org/Administration_Screens#Comments">Documentation on Comments</a>' ) . '</p>' .
182 '<p>' . __( '<a href="https://codex.wordpress.org/Comment_Spam">Documentation on Comment Spam</a>' ) . '</p>' .
183 '<p>' . __( '<a href="https://codex.wordpress.org/Keyboard_Shortcuts">Documentation on Keyboard Shortcuts</a>' ) . '</p>' .
184 '<p>' . __( '<a href="https://wordpress.org/support/">Support Forums</a>' ) . '</p>'
187 get_current_screen()->set_screen_reader_content( array(
188 'heading_views' => __( 'Filter comments list' ),
189 'heading_pagination' => __( 'Comments list navigation' ),
190 'heading_list' => __( 'Comments list' ),
193 require_once( ABSPATH . 'wp-admin/admin-header.php' );
199 /* translators: %s: link to post */
200 printf( __( 'Comments on “%s”' ),
201 sprintf( '<a href="%1$s">%2$s</a>',
202 get_edit_post_link( $post_id ),
203 wp_html_excerpt( _draft_or_post_title( $post_id ), 50, '…' )
210 if ( isset($_REQUEST['s']) && strlen( $_REQUEST['s'] ) ) {
211 echo '<span class="subtitle">';
212 /* translators: %s: search keywords */
213 printf( __( 'Search results for “%s”' ),
214 wp_html_excerpt( esc_html( wp_unslash( $_REQUEST['s'] ) ), 50, '…' )
221 if ( isset( $_REQUEST['error'] ) ) {
222 $error = (int) $_REQUEST['error'];
226 $error_msg = __( 'Invalid comment ID.' );
229 $error_msg = __( 'Sorry, you are not allowed to edit comments on this post.' );
233 echo '<div id="moderated" class="error"><p>' . $error_msg . '</p></div>';
236 if ( isset($_REQUEST['approved']) || isset($_REQUEST['deleted']) || isset($_REQUEST['trashed']) || isset($_REQUEST['untrashed']) || isset($_REQUEST['spammed']) || isset($_REQUEST['unspammed']) || isset($_REQUEST['same']) ) {
237 $approved = isset( $_REQUEST['approved'] ) ? (int) $_REQUEST['approved'] : 0;
238 $deleted = isset( $_REQUEST['deleted'] ) ? (int) $_REQUEST['deleted'] : 0;
239 $trashed = isset( $_REQUEST['trashed'] ) ? (int) $_REQUEST['trashed'] : 0;
240 $untrashed = isset( $_REQUEST['untrashed'] ) ? (int) $_REQUEST['untrashed'] : 0;
241 $spammed = isset( $_REQUEST['spammed'] ) ? (int) $_REQUEST['spammed'] : 0;
242 $unspammed = isset( $_REQUEST['unspammed'] ) ? (int) $_REQUEST['unspammed'] : 0;
243 $same = isset( $_REQUEST['same'] ) ? (int) $_REQUEST['same'] : 0;
245 if ( $approved > 0 || $deleted > 0 || $trashed > 0 || $untrashed > 0 || $spammed > 0 || $unspammed > 0 || $same > 0 ) {
246 if ( $approved > 0 ) {
247 /* translators: %s: number of comments approved */
248 $messages[] = sprintf( _n( '%s comment approved', '%s comments approved', $approved ), $approved );
251 if ( $spammed > 0 ) {
252 $ids = isset($_REQUEST['ids']) ? $_REQUEST['ids'] : 0;
253 /* translators: %s: number of comments marked as spam */
254 $messages[] = sprintf( _n( '%s comment marked as spam.', '%s comments marked as spam.', $spammed ), $spammed ) . ' <a href="' . esc_url( wp_nonce_url( "edit-comments.php?doaction=undo&action=unspam&ids=$ids", "bulk-comments" ) ) . '">' . __('Undo') . '</a><br />';
257 if ( $unspammed > 0 ) {
258 /* translators: %s: number of comments restored from the spam */
259 $messages[] = sprintf( _n( '%s comment restored from the spam', '%s comments restored from the spam', $unspammed ), $unspammed );
262 if ( $trashed > 0 ) {
263 $ids = isset($_REQUEST['ids']) ? $_REQUEST['ids'] : 0;
264 /* translators: %s: number of comments moved to the Trash */
265 $messages[] = sprintf( _n( '%s comment moved to the Trash.', '%s comments moved to the Trash.', $trashed ), $trashed ) . ' <a href="' . esc_url( wp_nonce_url( "edit-comments.php?doaction=undo&action=untrash&ids=$ids", "bulk-comments" ) ) . '">' . __('Undo') . '</a><br />';
268 if ( $untrashed > 0 ) {
269 /* translators: %s: number of comments restored from the Trash */
270 $messages[] = sprintf( _n( '%s comment restored from the Trash', '%s comments restored from the Trash', $untrashed ), $untrashed );
273 if ( $deleted > 0 ) {
274 /* translators: %s: number of comments permanently deleted */
275 $messages[] = sprintf( _n( '%s comment permanently deleted', '%s comments permanently deleted', $deleted ), $deleted );
278 if ( $same > 0 && $comment = get_comment( $same ) ) {
279 switch ( $comment->comment_approved ) {
281 $messages[] = __('This comment is already approved.') . ' <a href="' . esc_url( admin_url( "comment.php?action=editcomment&c=$same" ) ) . '">' . __( 'Edit comment' ) . '</a>';
284 $messages[] = __( 'This comment is already in the Trash.' ) . ' <a href="' . esc_url( admin_url( 'edit-comments.php?comment_status=trash' ) ) . '"> ' . __( 'View Trash' ) . '</a>';
287 $messages[] = __( 'This comment is already marked as spam.' ) . ' <a href="' . esc_url( admin_url( "comment.php?action=editcomment&c=$same" ) ) . '">' . __( 'Edit comment' ) . '</a>';
292 echo '<div id="moderated" class="updated notice is-dismissible"><p>' . implode( "<br/>\n", $messages ) . '</p></div>';
297 <?php $wp_list_table->views(); ?>
299 <form id="comments-form" method="get">
301 <?php $wp_list_table->search_box( __( 'Search Comments' ), 'comment' ); ?>
303 <?php if ( $post_id ) : ?>
304 <input type="hidden" name="p" value="<?php echo esc_attr( intval( $post_id ) ); ?>" />
306 <input type="hidden" name="comment_status" value="<?php echo esc_attr($comment_status); ?>" />
307 <input type="hidden" name="pagegen_timestamp" value="<?php echo esc_attr(current_time('mysql', 1)); ?>" />
309 <input type="hidden" name="_total" value="<?php echo esc_attr( $wp_list_table->get_pagination_arg('total_items') ); ?>" />
310 <input type="hidden" name="_per_page" value="<?php echo esc_attr( $wp_list_table->get_pagination_arg('per_page') ); ?>" />
311 <input type="hidden" name="_page" value="<?php echo esc_attr( $wp_list_table->get_pagination_arg('page') ); ?>" />
313 <?php if ( isset($_REQUEST['paged']) ) { ?>
314 <input type="hidden" name="paged" value="<?php echo esc_attr( absint( $_REQUEST['paged'] ) ); ?>" />
317 <?php $wp_list_table->display(); ?>
321 <div id="ajax-response"></div>
324 wp_comment_reply('-1', true, 'detail');
325 wp_comment_trashnotice();
326 include( ABSPATH . 'wp-admin/admin-footer.php' ); ?>