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
859      if ( $user_ID) {
860           $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));
861      } else if ( empty($comment_author) ) {
862           $comments = get_comments( array('post_id' => $post->ID, 'status' => 'approve', 'order' => 'ASC') );
863      } else {
864           $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));
865      }
866
867      // keep $comments for legacy's sake
868      $wp_query->comments = apply_filters( 'comments_array', $comments, $post->ID );
869      $comments = &$wp_query->comments;
870      $wp_query->comment_count = count($wp_query->comments);
871      update_comment_cache($wp_query->comments);
872
873      if ( $separate_comments ) {
874           $wp_query->comments_by_type = &separate_comments($comments);
875           $comments_by_type = &$wp_query->comments_by_type;
876      }
877