[ Index ]

PHP Cross Reference of WordPress Trunk (Updated Daily)

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( 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, '&hellip;' );
 154      if ( $comments_count->moderated > 0 ) {
 155          $title = sprintf(
 156              /* translators: 1: Comments count, 2: Post title. */
 157              __( 'Comments (%1$s) on &#8220;%2$s&#8221;' ),
 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 &#8220;%s&#8221;' ),
 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&#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>' .
 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 &#8220;%s&#8221;' ),
 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, '&hellip;' )
 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 &#8220;%s&#8221;' ),
 249          wp_html_excerpt( esc_html( wp_unslash( $_REQUEST['s'] ) ), 50, '&hellip;' )
 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' ); ?>


Generated: Fri Oct 25 08:20:01 2019 Cross-referenced by PHPXref 0.7