| [ Index ] |
PHP Cross Reference of WordPress |
[Summary view] [Print] [Text view]
1 <?php 2 /** 3 * Edit Comments Administration Screen. 4 * 5 * @package WordPress 6 * @subpackage Administration 7 */ 8 9 /** WordPress Administration Bootstrap */ 10 require_once __DIR__ . '/admin.php'; 11 if ( ! current_user_can( 'edit_posts' ) ) { 12 wp_die( 13 '<h1>' . __( 'You need a higher level of permission.' ) . '</h1>' . 14 '<p>' . __( 'Sorry, you are not allowed to edit comments.' ) . '</p>', 15 403 16 ); 17 } 18 19 $wp_list_table = _get_list_table( 'WP_Comments_List_Table' ); 20 $pagenum = $wp_list_table->get_pagenum(); 21 22 $doaction = $wp_list_table->current_action(); 23 24 if ( $doaction ) { 25 check_admin_referer( 'bulk-comments' ); 26 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 ) ); 31 $doaction = 'delete'; 32 } elseif ( isset( $_REQUEST['delete_comments'] ) ) { 33 $comment_ids = $_REQUEST['delete_comments']; 34 $doaction = $_REQUEST['action']; 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() ); 39 exit; 40 } 41 42 $approved = 0; 43 $unapproved = 0; 44 $spammed = 0; 45 $unspammed = 0; 46 $trashed = 0; 47 $untrashed = 0; 48 $deleted = 0; 49 50 $redirect_to = remove_query_arg( array( 'trashed', 'untrashed', 'deleted', 'spammed', 'unspammed', 'approved', 'unapproved', 'ids' ), wp_get_referer() ); 51 $redirect_to = add_query_arg( 'paged', $pagenum, $redirect_to ); 52 53 wp_defer_comment_counting( true ); 54 55 foreach ( $comment_ids as $comment_id ) { // Check the permissions on each. 56 if ( ! current_user_can( 'edit_comment', $comment_id ) ) { 57 continue; 58 } 59 60 switch ( $doaction ) { 61 case 'approve': 62 wp_set_comment_status( $comment_id, 'approve' ); 63 $approved++; 64 break; 65 case 'unapprove': 66 wp_set_comment_status( $comment_id, 'hold' ); 67 $unapproved++; 68 break; 69 case 'spam': 70 wp_spam_comment( $comment_id ); 71 $spammed++; 72 break; 73 case 'unspam': 74 wp_unspam_comment( $comment_id ); 75 $unspammed++; 76 break; 77 case 'trash': 78 wp_trash_comment( $comment_id ); 79 $trashed++; 80 break; 81 case 'untrash': 82 wp_untrash_comment( $comment_id ); 83 $untrashed++; 84 break; 85 case 'delete': 86 wp_delete_comment( $comment_id ); 87 $deleted++; 88 break; 89 } 90 } 91 92 if ( ! in_array( $doaction, array( 'approve', 'unapprove', 'spam', 'unspam', 'trash', 'delete' ), true ) ) { 93 $screen = get_current_screen()->id; 94 95 /** This action is documented in wp-admin/edit.php */ 96 $redirect_to = apply_filters( "handle_bulk_actions-{$screen}", $redirect_to, $doaction, $comment_ids ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores 97 } 98 99 wp_defer_comment_counting( false ); 100 101 if ( $approved ) { 102 $redirect_to = add_query_arg( 'approved', $approved, $redirect_to ); 103 } 104 if ( $unapproved ) { 105 $redirect_to = add_query_arg( 'unapproved', $unapproved, $redirect_to ); 106 } 107 if ( $spammed ) { 108 $redirect_to = add_query_arg( 'spammed', $spammed, $redirect_to ); 109 } 110 if ( $unspammed ) { 111 $redirect_to = add_query_arg( 'unspammed', $unspammed, $redirect_to ); 112 } 113 if ( $trashed ) { 114 $redirect_to = add_query_arg( 'trashed', $trashed, $redirect_to ); 115 } 116 if ( $untrashed ) { 117 $redirect_to = add_query_arg( 'untrashed', $untrashed, $redirect_to ); 118 } 119 if ( $deleted ) { 120 $redirect_to = add_query_arg( 'deleted', $deleted, $redirect_to ); 121 } 122 if ( $trashed || $spammed ) { 123 $redirect_to = add_query_arg( 'ids', implode( ',', $comment_ids ), $redirect_to ); 124 } 125 126 wp_safe_redirect( $redirect_to ); 127 exit; 128 } elseif ( ! empty( $_GET['_wp_http_referer'] ) ) { 129 wp_redirect( remove_query_arg( array( '_wp_http_referer', '_wpnonce' ), wp_unslash( $_SERVER['REQUEST_URI'] ) ) ); 130 exit; 131 } 132 133 $wp_list_table->prepare_items(); 134 135 wp_enqueue_script( 'admin-comments' ); 136 enqueue_comment_hotkeys_js(); 137 138 if ( $post_id ) { 139 $comments_count = wp_count_comments( $post_id ); 140 $draft_or_post_title = wp_html_excerpt( _draft_or_post_title( $post_id ), 50, '…' ); 141 142 if ( $comments_count->moderated > 0 ) { 143 // Used in the HTML title tag. 144 $title = sprintf( 145 /* translators: 1: Comments count, 2: Post title. */ 146 __( 'Comments (%1$s) on “%2$s”' ), 147 number_format_i18n( $comments_count->moderated ), 148 $draft_or_post_title 149 ); 150 } else { 151 // Used in the HTML title tag. 152 $title = sprintf( 153 /* translators: %s: Post title. */ 154 __( 'Comments on “%s”' ), 155 $draft_or_post_title 156 ); 157 } 158 } else { 159 $comments_count = wp_count_comments(); 160 161 if ( $comments_count->moderated > 0 ) { 162 // Used in the HTML title tag. 163 $title = sprintf( 164 /* translators: %s: Comments count. */ 165 __( 'Comments (%s)' ), 166 number_format_i18n( $comments_count->moderated ) 167 ); 168 } else { 169 // Used in the HTML title tag. 170 $title = __( 'Comments' ); 171 } 172 } 173 174 add_screen_option( 'per_page' ); 175 176 get_current_screen()->add_help_tab( 177 array( 178 'id' => 'overview', 179 'title' => __( 'Overview' ), 180 'content' => 181 '<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>', 182 ) 183 ); 184 get_current_screen()->add_help_tab( 185 array( 186 'id' => 'moderating-comments', 187 'title' => __( 'Moderating Comments' ), 188 'content' => 189 '<p>' . __( 'A red bar on the left means the comment is waiting for you to moderate it.' ) . '</p>' . 190 '<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>' . 191 '<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>' . 192 '<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>' . 193 '<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>' . 194 '<p>' . __( 'Many people take advantage of keyboard shortcuts to moderate their comments more quickly. Use the link to the side to learn more.' ) . '</p>', 195 ) 196 ); 197 198 get_current_screen()->set_help_sidebar( 199 '<p><strong>' . __( 'For more information:' ) . '</strong></p>' . 200 '<p>' . __( '<a href="https://wordpress.org/support/article/comments-screen/">Documentation on Comments</a>' ) . '</p>' . 201 '<p>' . __( '<a href="https://wordpress.org/support/article/comment-spam/">Documentation on Comment Spam</a>' ) . '</p>' . 202 '<p>' . __( '<a href="https://wordpress.org/support/article/keyboard-shortcuts/">Documentation on Keyboard Shortcuts</a>' ) . '</p>' . 203 '<p>' . __( '<a href="https://wordpress.org/support/">Support</a>' ) . '</p>' 204 ); 205 206 get_current_screen()->set_screen_reader_content( 207 array( 208 'heading_views' => __( 'Filter comments list' ), 209 'heading_pagination' => __( 'Comments list navigation' ), 210 'heading_list' => __( 'Comments list' ), 211 ) 212 ); 213 214 require_once ABSPATH . 'wp-admin/admin-header.php'; 215 ?> 216 217 <div class="wrap"> 218 <h1 class="wp-heading-inline"> 219 <?php 220 if ( $post_id ) { 221 printf( 222 /* translators: %s: Link to post. */ 223 __( 'Comments on “%s”' ), 224 sprintf( 225 '<a href="%1$s">%2$s</a>', 226 get_edit_post_link( $post_id ), 227 wp_html_excerpt( _draft_or_post_title( $post_id ), 50, '…' ) 228 ) 229 ); 230 } else { 231 _e( 'Comments' ); 232 } 233 ?> 234 </h1> 235 236 <?php 237 if ( $post_id ) { 238 $post_type_object = get_post_type_object( get_post_type( $post_id ) ); 239 240 if ( $post_type_object ) { 241 printf( 242 '<a href="%1$s" class="comments-view-item-link">%2$s</a>', 243 get_permalink( $post_id ), 244 $post_type_object->labels->view_item 245 ); 246 } 247 } 248 249 if ( isset( $_REQUEST['s'] ) && strlen( $_REQUEST['s'] ) ) { 250 echo '<span class="subtitle">'; 251 printf( 252 /* translators: %s: Search query. */ 253 __( 'Search results for: %s' ), 254 '<strong>' . esc_html( wp_unslash( $_REQUEST['s'] ) ) . '</strong>' 255 ); 256 echo '</span>'; 257 } 258 ?> 259 260 <hr class="wp-header-end"> 261 262 <?php 263 if ( isset( $_REQUEST['error'] ) ) { 264 $error = (int) $_REQUEST['error']; 265 $error_msg = ''; 266 switch ( $error ) { 267 case 1: 268 $error_msg = __( 'Invalid comment ID.' ); 269 break; 270 case 2: 271 $error_msg = __( 'Sorry, you are not allowed to edit comments on this post.' ); 272 break; 273 } 274 if ( $error_msg ) { 275 echo '<div id="moderated" class="error"><p>' . $error_msg . '</p></div>'; 276 } 277 } 278 279 if ( isset( $_REQUEST['approved'] ) || isset( $_REQUEST['deleted'] ) || isset( $_REQUEST['trashed'] ) || isset( $_REQUEST['untrashed'] ) || isset( $_REQUEST['spammed'] ) || isset( $_REQUEST['unspammed'] ) || isset( $_REQUEST['same'] ) ) { 280 $approved = isset( $_REQUEST['approved'] ) ? (int) $_REQUEST['approved'] : 0; 281 $deleted = isset( $_REQUEST['deleted'] ) ? (int) $_REQUEST['deleted'] : 0; 282 $trashed = isset( $_REQUEST['trashed'] ) ? (int) $_REQUEST['trashed'] : 0; 283 $untrashed = isset( $_REQUEST['untrashed'] ) ? (int) $_REQUEST['untrashed'] : 0; 284 $spammed = isset( $_REQUEST['spammed'] ) ? (int) $_REQUEST['spammed'] : 0; 285 $unspammed = isset( $_REQUEST['unspammed'] ) ? (int) $_REQUEST['unspammed'] : 0; 286 $same = isset( $_REQUEST['same'] ) ? (int) $_REQUEST['same'] : 0; 287 288 if ( $approved > 0 || $deleted > 0 || $trashed > 0 || $untrashed > 0 || $spammed > 0 || $unspammed > 0 || $same > 0 ) { 289 if ( $approved > 0 ) { 290 /* translators: %s: Number of comments. */ 291 $messages[] = sprintf( _n( '%s comment approved.', '%s comments approved.', $approved ), $approved ); 292 } 293 294 if ( $spammed > 0 ) { 295 $ids = isset( $_REQUEST['ids'] ) ? $_REQUEST['ids'] : 0; 296 /* translators: %s: Number of comments. */ 297 $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 />'; 298 } 299 300 if ( $unspammed > 0 ) { 301 /* translators: %s: Number of comments. */ 302 $messages[] = sprintf( _n( '%s comment restored from the spam.', '%s comments restored from the spam.', $unspammed ), $unspammed ); 303 } 304 305 if ( $trashed > 0 ) { 306 $ids = isset( $_REQUEST['ids'] ) ? $_REQUEST['ids'] : 0; 307 /* translators: %s: Number of comments. */ 308 $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 />'; 309 } 310 311 if ( $untrashed > 0 ) { 312 /* translators: %s: Number of comments. */ 313 $messages[] = sprintf( _n( '%s comment restored from the Trash.', '%s comments restored from the Trash.', $untrashed ), $untrashed ); 314 } 315 316 if ( $deleted > 0 ) { 317 /* translators: %s: Number of comments. */ 318 $messages[] = sprintf( _n( '%s comment permanently deleted.', '%s comments permanently deleted.', $deleted ), $deleted ); 319 } 320 321 if ( $same > 0 ) { 322 $comment = get_comment( $same ); 323 if ( $comment ) { 324 switch ( $comment->comment_approved ) { 325 case '1': 326 $messages[] = __( 'This comment is already approved.' ) . ' <a href="' . esc_url( admin_url( "comment.php?action=editcomment&c=$same" ) ) . '">' . __( 'Edit comment' ) . '</a>'; 327 break; 328 case 'trash': 329 $messages[] = __( 'This comment is already in the Trash.' ) . ' <a href="' . esc_url( admin_url( 'edit-comments.php?comment_status=trash' ) ) . '"> ' . __( 'View Trash' ) . '</a>'; 330 break; 331 case 'spam': 332 $messages[] = __( 'This comment is already marked as spam.' ) . ' <a href="' . esc_url( admin_url( "comment.php?action=editcomment&c=$same" ) ) . '">' . __( 'Edit comment' ) . '</a>'; 333 break; 334 } 335 } 336 } 337 338 echo '<div id="moderated" class="updated notice is-dismissible"><p>' . implode( "<br/>\n", $messages ) . '</p></div>'; 339 } 340 } 341 ?> 342 343 <?php $wp_list_table->views(); ?> 344 345 <form id="comments-form" method="get"> 346 347 <?php $wp_list_table->search_box( __( 'Search Comments' ), 'comment' ); ?> 348 349 <?php if ( $post_id ) : ?> 350 <input type="hidden" name="p" value="<?php echo esc_attr( (int) $post_id ); ?>" /> 351 <?php endif; ?> 352 <input type="hidden" name="comment_status" value="<?php echo esc_attr( $comment_status ); ?>" /> 353 <input type="hidden" name="pagegen_timestamp" value="<?php echo esc_attr( current_time( 'mysql', 1 ) ); ?>" /> 354 355 <input type="hidden" name="_total" value="<?php echo esc_attr( $wp_list_table->get_pagination_arg( 'total_items' ) ); ?>" /> 356 <input type="hidden" name="_per_page" value="<?php echo esc_attr( $wp_list_table->get_pagination_arg( 'per_page' ) ); ?>" /> 357 <input type="hidden" name="_page" value="<?php echo esc_attr( $wp_list_table->get_pagination_arg( 'page' ) ); ?>" /> 358 359 <?php if ( isset( $_REQUEST['paged'] ) ) { ?> 360 <input type="hidden" name="paged" value="<?php echo esc_attr( absint( $_REQUEST['paged'] ) ); ?>" /> 361 <?php } ?> 362 363 <?php $wp_list_table->display(); ?> 364 </form> 365 </div> 366 367 <div id="ajax-response"></div> 368 369 <?php 370 wp_comment_reply( '-1', true, 'detail' ); 371 wp_comment_trashnotice(); 372 require_once ABSPATH . 'wp-admin/admin-footer.php'; ?>
title
Description
Body
title
Description
Body
title
Description
Body
title
Body
| Generated: Tue Jul 1 01:00:02 2025 | Cross-referenced by PHPXref 0.7.1 |