| [ 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( dirname( __FILE__ ) . '/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'] != -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() ); 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 /** 96 * Fires when a custom bulk action should be handled. 97 * 98 * The redirect link should be modified with success or failure feedback 99 * from the action to be used to display feedback to the user. 100 * 101 * The dynamic portion of the hook name, `$screen`, refers to the current screen ID. 102 * 103 * @since 4.7.0 104 * 105 * @param string $redirect_url The redirect URL. 106 * @param string $doaction The action being taken. 107 * @param array $items The items to take the action on. 108 */ 109 $redirect_to = apply_filters( "handle_bulk_actions-{$screen}", $redirect_to, $doaction, $comment_ids ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores 110 } 111 112 wp_defer_comment_counting( false ); 113 114 if ( $approved ) { 115 $redirect_to = add_query_arg( 'approved', $approved, $redirect_to ); 116 } 117 if ( $unapproved ) { 118 $redirect_to = add_query_arg( 'unapproved', $unapproved, $redirect_to ); 119 } 120 if ( $spammed ) { 121 $redirect_to = add_query_arg( 'spammed', $spammed, $redirect_to ); 122 } 123 if ( $unspammed ) { 124 $redirect_to = add_query_arg( 'unspammed', $unspammed, $redirect_to ); 125 } 126 if ( $trashed ) { 127 $redirect_to = add_query_arg( 'trashed', $trashed, $redirect_to ); 128 } 129 if ( $untrashed ) { 130 $redirect_to = add_query_arg( 'untrashed', $untrashed, $redirect_to ); 131 } 132 if ( $deleted ) { 133 $redirect_to = add_query_arg( 'deleted', $deleted, $redirect_to ); 134 } 135 if ( $trashed || $spammed ) { 136 $redirect_to = add_query_arg( 'ids', join( ',', $comment_ids ), $redirect_to ); 137 } 138 139 wp_safe_redirect( $redirect_to ); 140 exit; 141 } elseif ( ! empty( $_GET['_wp_http_referer'] ) ) { 142 wp_redirect( remove_query_arg( array( '_wp_http_referer', '_wpnonce' ), wp_unslash( $_SERVER['REQUEST_URI'] ) ) ); 143 exit; 144 } 145 146 $wp_list_table->prepare_items(); 147 148 wp_enqueue_script( 'admin-comments' ); 149 enqueue_comment_hotkeys_js(); 150 151 if ( $post_id ) { 152 $comments_count = wp_count_comments( $post_id ); 153 $draft_or_post_title = wp_html_excerpt( _draft_or_post_title( $post_id ), 50, '…' ); 154 if ( $comments_count->moderated > 0 ) { 155 $title = sprintf( 156 /* translators: 1: Comments count, 2: Post title. */ 157 __( 'Comments (%1$s) on “%2$s”' ), 158 number_format_i18n( $comments_count->moderated ), 159 $draft_or_post_title 160 ); 161 } else { 162 $title = sprintf( 163 /* translators: %s: Post title. */ 164 __( 'Comments on “%s”' ), 165 $draft_or_post_title 166 ); 167 } 168 } else { 169 $comments_count = wp_count_comments(); 170 if ( $comments_count->moderated > 0 ) { 171 $title = sprintf( 172 /* translators: %s: Comments count. */ 173 __( 'Comments (%s)' ), 174 number_format_i18n( $comments_count->moderated ) 175 ); 176 } else { 177 $title = __( 'Comments' ); 178 } 179 } 180 181 add_screen_option( 'per_page' ); 182 183 get_current_screen()->add_help_tab( 184 array( 185 'id' => 'overview', 186 'title' => __( 'Overview' ), 187 'content' => 188 '<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>', 189 ) 190 ); 191 get_current_screen()->add_help_tab( 192 array( 193 'id' => 'moderating-comments', 194 'title' => __( 'Moderating Comments' ), 195 'content' => 196 '<p>' . __( 'A red bar on the left means the comment is waiting for you to moderate it.' ) . '</p>' . 197 '<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>' . 198 '<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>' . 199 '<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>' . 200 '<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>' . 201 '<p>' . __( 'Many people take advantage of keyboard shortcuts to moderate their comments more quickly. Use the link to the side to learn more.' ) . '</p>', 202 ) 203 ); 204 205 get_current_screen()->set_help_sidebar( 206 '<p><strong>' . __( 'For more information:' ) . '</strong></p>' . 207 '<p>' . __( '<a href="https://wordpress.org/support/article/comments-screen/">Documentation on Comments</a>' ) . '</p>' . 208 '<p>' . __( '<a href="https://wordpress.org/support/article/comment-spam/">Documentation on Comment Spam</a>' ) . '</p>' . 209 '<p>' . __( '<a href="https://wordpress.org/support/article/keyboard-shortcuts/">Documentation on Keyboard Shortcuts</a>' ) . '</p>' . 210 '<p>' . __( '<a href="https://wordpress.org/support/">Support</a>' ) . '</p>' 211 ); 212 213 get_current_screen()->set_screen_reader_content( 214 array( 215 'heading_views' => __( 'Filter comments list' ), 216 'heading_pagination' => __( 'Comments list navigation' ), 217 'heading_list' => __( 'Comments list' ), 218 ) 219 ); 220 221 require_once( ABSPATH . 'wp-admin/admin-header.php' ); 222 ?> 223 224 <div class="wrap"> 225 <h1 class="wp-heading-inline"> 226 <?php 227 if ( $post_id ) { 228 printf( 229 /* translators: %s: Link to post. */ 230 __( 'Comments on “%s”' ), 231 sprintf( 232 '<a href="%1$s">%2$s</a>', 233 get_edit_post_link( $post_id ), 234 wp_html_excerpt( _draft_or_post_title( $post_id ), 50, '…' ) 235 ) 236 ); 237 } else { 238 _e( 'Comments' ); 239 } 240 ?> 241 </h1> 242 243 <?php 244 if ( isset( $_REQUEST['s'] ) && strlen( $_REQUEST['s'] ) ) { 245 echo '<span class="subtitle">'; 246 printf( 247 /* translators: %s: Search query. */ 248 __( 'Search results for “%s”' ), 249 wp_html_excerpt( esc_html( wp_unslash( $_REQUEST['s'] ) ), 50, '…' ) 250 ); 251 echo '</span>'; 252 } 253 ?> 254 255 <hr class="wp-header-end"> 256 257 <?php 258 if ( isset( $_REQUEST['error'] ) ) { 259 $error = (int) $_REQUEST['error']; 260 $error_msg = ''; 261 switch ( $error ) { 262 case 1: 263 $error_msg = __( 'Invalid comment ID.' ); 264 break; 265 case 2: 266 $error_msg = __( 'Sorry, you are not allowed to edit comments on this post.' ); 267 break; 268 } 269 if ( $error_msg ) { 270 echo '<div id="moderated" class="error"><p>' . $error_msg . '</p></div>'; 271 } 272 } 273 274 if ( isset( $_REQUEST['approved'] ) || isset( $_REQUEST['deleted'] ) || isset( $_REQUEST['trashed'] ) || isset( $_REQUEST['untrashed'] ) || isset( $_REQUEST['spammed'] ) || isset( $_REQUEST['unspammed'] ) || isset( $_REQUEST['same'] ) ) { 275 $approved = isset( $_REQUEST['approved'] ) ? (int) $_REQUEST['approved'] : 0; 276 $deleted = isset( $_REQUEST['deleted'] ) ? (int) $_REQUEST['deleted'] : 0; 277 $trashed = isset( $_REQUEST['trashed'] ) ? (int) $_REQUEST['trashed'] : 0; 278 $untrashed = isset( $_REQUEST['untrashed'] ) ? (int) $_REQUEST['untrashed'] : 0; 279 $spammed = isset( $_REQUEST['spammed'] ) ? (int) $_REQUEST['spammed'] : 0; 280 $unspammed = isset( $_REQUEST['unspammed'] ) ? (int) $_REQUEST['unspammed'] : 0; 281 $same = isset( $_REQUEST['same'] ) ? (int) $_REQUEST['same'] : 0; 282 283 if ( $approved > 0 || $deleted > 0 || $trashed > 0 || $untrashed > 0 || $spammed > 0 || $unspammed > 0 || $same > 0 ) { 284 if ( $approved > 0 ) { 285 /* translators: %s: Number of comments. */ 286 $messages[] = sprintf( _n( '%s comment approved', '%s comments approved', $approved ), $approved ); 287 } 288 289 if ( $spammed > 0 ) { 290 $ids = isset( $_REQUEST['ids'] ) ? $_REQUEST['ids'] : 0; 291 /* translators: %s: Number of comments. */ 292 $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 />'; 293 } 294 295 if ( $unspammed > 0 ) { 296 /* translators: %s: Number of comments. */ 297 $messages[] = sprintf( _n( '%s comment restored from the spam', '%s comments restored from the spam', $unspammed ), $unspammed ); 298 } 299 300 if ( $trashed > 0 ) { 301 $ids = isset( $_REQUEST['ids'] ) ? $_REQUEST['ids'] : 0; 302 /* translators: %s: Number of comments. */ 303 $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 />'; 304 } 305 306 if ( $untrashed > 0 ) { 307 /* translators: %s: Number of comments. */ 308 $messages[] = sprintf( _n( '%s comment restored from the Trash', '%s comments restored from the Trash', $untrashed ), $untrashed ); 309 } 310 311 if ( $deleted > 0 ) { 312 /* translators: %s: Number of comments. */ 313 $messages[] = sprintf( _n( '%s comment permanently deleted', '%s comments permanently deleted', $deleted ), $deleted ); 314 } 315 316 if ( $same > 0 ) { 317 $comment = get_comment( $same ); 318 if ( $comment ) { 319 switch ( $comment->comment_approved ) { 320 case '1': 321 $messages[] = __( 'This comment is already approved.' ) . ' <a href="' . esc_url( admin_url( "comment.php?action=editcomment&c=$same" ) ) . '">' . __( 'Edit comment' ) . '</a>'; 322 break; 323 case 'trash': 324 $messages[] = __( 'This comment is already in the Trash.' ) . ' <a href="' . esc_url( admin_url( 'edit-comments.php?comment_status=trash' ) ) . '"> ' . __( 'View Trash' ) . '</a>'; 325 break; 326 case 'spam': 327 $messages[] = __( 'This comment is already marked as spam.' ) . ' <a href="' . esc_url( admin_url( "comment.php?action=editcomment&c=$same" ) ) . '">' . __( 'Edit comment' ) . '</a>'; 328 break; 329 } 330 } 331 } 332 333 echo '<div id="moderated" class="updated notice is-dismissible"><p>' . implode( "<br/>\n", $messages ) . '</p></div>'; 334 } 335 } 336 ?> 337 338 <?php $wp_list_table->views(); ?> 339 340 <form id="comments-form" method="get"> 341 342 <?php $wp_list_table->search_box( __( 'Search Comments' ), 'comment' ); ?> 343 344 <?php if ( $post_id ) : ?> 345 <input type="hidden" name="p" value="<?php echo esc_attr( intval( $post_id ) ); ?>" /> 346 <?php endif; ?> 347 <input type="hidden" name="comment_status" value="<?php echo esc_attr( $comment_status ); ?>" /> 348 <input type="hidden" name="pagegen_timestamp" value="<?php echo esc_attr( current_time( 'mysql', 1 ) ); ?>" /> 349 350 <input type="hidden" name="_total" value="<?php echo esc_attr( $wp_list_table->get_pagination_arg( 'total_items' ) ); ?>" /> 351 <input type="hidden" name="_per_page" value="<?php echo esc_attr( $wp_list_table->get_pagination_arg( 'per_page' ) ); ?>" /> 352 <input type="hidden" name="_page" value="<?php echo esc_attr( $wp_list_table->get_pagination_arg( 'page' ) ); ?>" /> 353 354 <?php if ( isset( $_REQUEST['paged'] ) ) { ?> 355 <input type="hidden" name="paged" value="<?php echo esc_attr( absint( $_REQUEST['paged'] ) ); ?>" /> 356 <?php } ?> 357 358 <?php $wp_list_table->display(); ?> 359 </form> 360 </div> 361 362 <div id="ajax-response"></div> 363 364 <?php 365 wp_comment_reply( '-1', true, 'detail' ); 366 wp_comment_trashnotice(); 367 include( ABSPATH . 'wp-admin/admin-footer.php' ); ?>
title
Description
Body
title
Description
Body
title
Description
Body
title
Body
| Generated: Sat Sep 21 01:00:03 2019 | Cross-referenced by PHPXref 0.7.1 |