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') )
12 wp_die( __( 'Cheatin’ uh?' ), 403 );
14 $wp_list_table = _get_list_table('WP_Comments_List_Table');
15 $pagenum = $wp_list_table->get_pagenum();
17 $doaction = $wp_list_table->current_action();
20 check_admin_referer( 'bulk-comments' );
22 if ( 'delete_all' == $doaction && !empty( $_REQUEST['pagegen_timestamp'] ) ) {
23 $comment_status = wp_unslash( $_REQUEST['comment_status'] );
24 $delete_time = wp_unslash( $_REQUEST['pagegen_timestamp'] );
25 $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 ) );
27 } elseif ( isset( $_REQUEST['delete_comments'] ) ) {
28 $comment_ids = $_REQUEST['delete_comments'];
29 $doaction = ( $_REQUEST['action'] != -1 ) ? $_REQUEST['action'] : $_REQUEST['action2'];
30 } elseif ( isset( $_REQUEST['ids'] ) ) {
31 $comment_ids = array_map( 'absint', explode( ',', $_REQUEST['ids'] ) );
32 } elseif ( wp_get_referer() ) {
33 wp_safe_redirect( wp_get_referer() );
37 $approved = $unapproved = $spammed = $unspammed = $trashed = $untrashed = $deleted = 0;
39 $redirect_to = remove_query_arg( array( 'trashed', 'untrashed', 'deleted', 'spammed', 'unspammed', 'approved', 'unapproved', 'ids' ), wp_get_referer() );
40 $redirect_to = add_query_arg( 'paged', $pagenum, $redirect_to );
42 foreach ( $comment_ids as $comment_id ) { // Check the permissions on each
43 if ( !current_user_can( 'edit_comment', $comment_id ) )
46 switch ( $doaction ) {
48 wp_set_comment_status( $comment_id, 'approve' );
52 wp_set_comment_status( $comment_id, 'hold' );
56 wp_spam_comment( $comment_id );
60 wp_unspam_comment( $comment_id );
64 wp_trash_comment( $comment_id );
68 wp_untrash_comment( $comment_id );
72 wp_delete_comment( $comment_id );
79 $redirect_to = add_query_arg( 'approved', $approved, $redirect_to );
81 $redirect_to = add_query_arg( 'unapproved', $unapproved, $redirect_to );
83 $redirect_to = add_query_arg( 'spammed', $spammed, $redirect_to );
85 $redirect_to = add_query_arg( 'unspammed', $unspammed, $redirect_to );
87 $redirect_to = add_query_arg( 'trashed', $trashed, $redirect_to );
89 $redirect_to = add_query_arg( 'untrashed', $untrashed, $redirect_to );
91 $redirect_to = add_query_arg( 'deleted', $deleted, $redirect_to );
92 if ( $trashed || $spammed )
93 $redirect_to = add_query_arg( 'ids', join( ',', $comment_ids ), $redirect_to );
95 wp_safe_redirect( $redirect_to );
97 } elseif ( ! empty( $_GET['_wp_http_referer'] ) ) {
98 wp_redirect( remove_query_arg( array( '_wp_http_referer', '_wpnonce' ), wp_unslash( $_SERVER['REQUEST_URI'] ) ) );
102 $wp_list_table->prepare_items();
104 wp_enqueue_script('admin-comments');
105 enqueue_comment_hotkeys_js();
108 $title = sprintf( __( 'Comments on “%s”' ), wp_html_excerpt( _draft_or_post_title( $post_id ), 50, '…' ) );
110 $title = __('Comments');
112 add_screen_option( 'per_page', array('label' => _x( 'Comments', 'comments per page (screen options)' )) );
114 get_current_screen()->add_help_tab( array(
116 'title' => __('Overview'),
118 '<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>'
120 get_current_screen()->add_help_tab( array(
121 'id' => 'moderating-comments',
122 'title' => __('Moderating Comments'),
124 '<p>' . __( 'A red bar on the left means the comment is waiting for you to moderate it.' ) . '</p>' .
125 '<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>' .
126 '<p>' . __( 'In the <strong>Comment</strong> column, above each comment it says “Submitted on,” followed by the date and time the comment was left on your site. Clicking on the date/time link will take you to that comment on your live site. Hovering over any comment gives you options to approve, reply (and approve), quick edit, edit, spam mark, or trash that comment.' ) . '</p>' .
127 '<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 the bubble is gray, you have moderated all comments for that post. If it is blue, there are pending comments. Clicking the bubble will filter the comments screen to show only comments on that post.' ) . '</p>' .
128 '<p>' . __( 'Many people take advantage of keyboard shortcuts to moderate their comments more quickly. Use the link to the side to learn more.' ) . '</p>'
131 get_current_screen()->set_help_sidebar(
132 '<p><strong>' . __( 'For more information:' ) . '</strong></p>' .
133 '<p>' . __( '<a href="http://codex.wordpress.org/Administration_Screens#Comments" target="_blank">Documentation on Comments</a>' ) . '</p>' .
134 '<p>' . __( '<a href="http://codex.wordpress.org/Comment_Spam" target="_blank">Documentation on Comment Spam</a>' ) . '</p>' .
135 '<p>' . __( '<a href="http://codex.wordpress.org/Keyboard_Shortcuts" target="_blank">Documentation on Keyboard Shortcuts</a>' ) . '</p>' .
136 '<p>' . __( '<a href="https://wordpress.org/support/" target="_blank">Support Forums</a>' ) . '</p>'
139 require_once( ABSPATH . 'wp-admin/admin-header.php' );
145 echo sprintf( __( 'Comments on “%s”' ),
146 sprintf( '<a href="%s">%s</a>',
147 get_edit_post_link( $post_id ),
148 wp_html_excerpt( _draft_or_post_title( $post_id ), 50, '…' )
154 if ( isset($_REQUEST['s']) && $_REQUEST['s'] )
155 echo '<span class="subtitle">' . sprintf( __( 'Search results for “%s”' ), wp_html_excerpt( esc_html( wp_unslash( $_REQUEST['s'] ) ), 50, '…' ) ) . '</span>'; ?>
159 if ( isset( $_REQUEST['error'] ) ) {
160 $error = (int) $_REQUEST['error'];
164 $error_msg = __( 'Oops, no comment with this ID.' );
167 $error_msg = __( 'You are not allowed to edit comments on this post.' );
171 echo '<div id="moderated" class="error"><p>' . $error_msg . '</p></div>';
174 if ( isset($_REQUEST['approved']) || isset($_REQUEST['deleted']) || isset($_REQUEST['trashed']) || isset($_REQUEST['untrashed']) || isset($_REQUEST['spammed']) || isset($_REQUEST['unspammed']) || isset($_REQUEST['same']) ) {
175 $approved = isset( $_REQUEST['approved'] ) ? (int) $_REQUEST['approved'] : 0;
176 $deleted = isset( $_REQUEST['deleted'] ) ? (int) $_REQUEST['deleted'] : 0;
177 $trashed = isset( $_REQUEST['trashed'] ) ? (int) $_REQUEST['trashed'] : 0;
178 $untrashed = isset( $_REQUEST['untrashed'] ) ? (int) $_REQUEST['untrashed'] : 0;
179 $spammed = isset( $_REQUEST['spammed'] ) ? (int) $_REQUEST['spammed'] : 0;
180 $unspammed = isset( $_REQUEST['unspammed'] ) ? (int) $_REQUEST['unspammed'] : 0;
181 $same = isset( $_REQUEST['same'] ) ? (int) $_REQUEST['same'] : 0;
183 if ( $approved > 0 || $deleted > 0 || $trashed > 0 || $untrashed > 0 || $spammed > 0 || $unspammed > 0 || $same > 0 ) {
185 $messages[] = sprintf( _n( '%s comment approved', '%s comments approved', $approved ), $approved );
187 if ( $spammed > 0 ) {
188 $ids = isset($_REQUEST['ids']) ? $_REQUEST['ids'] : 0;
189 $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 />';
192 if ( $unspammed > 0 )
193 $messages[] = sprintf( _n( '%s comment restored from the spam', '%s comments restored from the spam', $unspammed ), $unspammed );
195 if ( $trashed > 0 ) {
196 $ids = isset($_REQUEST['ids']) ? $_REQUEST['ids'] : 0;
197 $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 />';
200 if ( $untrashed > 0 )
201 $messages[] = sprintf( _n( '%s comment restored from the Trash', '%s comments restored from the Trash', $untrashed ), $untrashed );
204 $messages[] = sprintf( _n( '%s comment permanently deleted', '%s comments permanently deleted', $deleted ), $deleted );
206 if ( $same > 0 && $comment = get_comment( $same ) ) {
207 switch ( $comment->comment_approved ) {
209 $messages[] = __('This comment is already approved.') . ' <a href="' . esc_url( admin_url( "comment.php?action=editcomment&c=$same" ) ) . '">' . __( 'Edit comment' ) . '</a>';
212 $messages[] = __( 'This comment is already in the Trash.' ) . ' <a href="' . esc_url( admin_url( 'edit-comments.php?comment_status=trash' ) ) . '"> ' . __( 'View Trash' ) . '</a>';
215 $messages[] = __( 'This comment is already marked as spam.' ) . ' <a href="' . esc_url( admin_url( "comment.php?action=editcomment&c=$same" ) ) . '">' . __( 'Edit comment' ) . '</a>';
220 echo '<div id="moderated" class="updated"><p>' . implode( "<br/>\n", $messages ) . '</p></div>';
225 <?php $wp_list_table->views(); ?>
227 <form id="comments-form" action="" method="get">
229 <?php $wp_list_table->search_box( __( 'Search Comments' ), 'comment' ); ?>
231 <?php if ( $post_id ) : ?>
232 <input type="hidden" name="p" value="<?php echo esc_attr( intval( $post_id ) ); ?>" />
234 <input type="hidden" name="comment_status" value="<?php echo esc_attr($comment_status); ?>" />
235 <input type="hidden" name="pagegen_timestamp" value="<?php echo esc_attr(current_time('mysql', 1)); ?>" />
237 <input type="hidden" name="_total" value="<?php echo esc_attr( $wp_list_table->get_pagination_arg('total_items') ); ?>" />
238 <input type="hidden" name="_per_page" value="<?php echo esc_attr( $wp_list_table->get_pagination_arg('per_page') ); ?>" />
239 <input type="hidden" name="_page" value="<?php echo esc_attr( $wp_list_table->get_pagination_arg('page') ); ?>" />
241 <?php if ( isset($_REQUEST['paged']) ) { ?>
242 <input type="hidden" name="paged" value="<?php echo esc_attr( absint( $_REQUEST['paged'] ) ); ?>" />
245 <?php $wp_list_table->display(); ?>
249 <div id="ajax-response"></div>
252 wp_comment_reply('-1', true, 'detail');
253 wp_comment_trashnotice();
254 include( ABSPATH . 'wp-admin/admin-footer.php' ); ?>