[ Index ]

PHP Cross Reference of WordPress

title

Body

[close]

/wp-admin/ -> edit-comments.php (source)

   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, '&hellip;' );
 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 &#8220;%2$s&#8221;' ),
 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 &#8220;%s&#8221;' ),
 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&#8217;s name, email address, and blog URL, the commenter&#8217;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 &#8220;%s&#8221;' ),
 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, '&hellip;' )
 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'; ?>


Generated: Fri Mar 29 01:00:02 2024 Cross-referenced by PHPXref 0.7.1