Source View: comments_array

To save our bandwidth, we show only a snippet of code around each occurence of the hook. View complete file in SVN (without highlighting).

Understanding Source Code

The best way to understand what a hook does is to look at where it occurs in the source code.

  • Action hooks look like this: do_action( "hook_name" )
  • Filter hooks look like this: apply_filters( "hook_name", "what_to_filter" ).

Remember, this hook may occur in more than one file. Moreover, the hook's context may change from version to version.

Source View

Line Code
883      if ( $user_ID) {
884           $comments = $wpdb->get_results($wpdb->prepare("SELECT * FROM $wpdb->comments WHERE comment_post_ID = %d AND (comment_approved = '1' OR ( user_id = %d AND comment_approved = '0' ) )  ORDER BY comment_date_gmt", $post->ID, $user_ID));
885      } else if ( empty($comment_author) ) {
886           $comments = get_comments( array('post_id' => $post->ID, 'status' => 'approve', 'order' => 'ASC') );
887      } else {
888           $comments = $wpdb->get_results($wpdb->prepare("SELECT * FROM $wpdb->comments WHERE comment_post_ID = %d AND ( comment_approved = '1' OR ( comment_author = %s AND comment_author_email = %s AND comment_approved = '0' ) ) ORDER BY comment_date_gmt", $post->ID, wp_specialchars_decode($comment_author,ENT_QUOTES), $comment_author_email));
889      }
890
891      // keep $comments for legacy's sake
892      $wp_query->comments = apply_filters( 'comments_array', $comments, $post->ID );
893      $comments = &$wp_query->comments;
894      $wp_query->comment_count = count($wp_query->comments);
895      update_comment_cache($wp_query->comments);
896
897      if ( $separate_comments ) {
898           $wp_query->comments_by_type = &separate_comments($comments);
899           $comments_by_type = &$wp_query->comments_by_type;
900      }
901