wp_list_comments( string|array $args = array(), WP_Comment[] $comments = null )

使用示例

• 示例1

  从Codex迁移的示例：

  仅显示自定义评论

  只显示评论（没有pingback或trackback），同时使用自定义回调函数控制评论的外观。如果没有出现回复链接，您可能需要添加一个max_depth=X参数。

  <ul class="commentlist">
  <?php wp_list_comments( 'type=comment&callback=mytheme_comment' ); ?>
  </ul>
  

  您需要在主题的functions.php文件中定义自定义回调函数。下面是一个示例：

  function mytheme_comment($comment, $args, $depth) {
      if ( 'div' === $args['style'] ) {
          $tag       = 'div';
          $add_below = 'comment';
      } else {
          $tag       = 'li';
          $add_below = 'div-comment';
      }?>
      <<?php echo $tag; ?> <?php comment_class( empty( $args['has_children'] ) ? '' : 'parent' ); ?> id="comment-<?php comment_ID() ?>"><?php 
      if ( 'div' != $args['style'] ) { ?>
          <div id="div-comment-<?php comment_ID() ?>" class="comment-body"><?php
      } ?>
          <div class="comment-author vcard"><?php 
              if ( $args['avatar_size'] != 0 ) {
                  echo get_avatar( $comment, $args['avatar_size'] ); 
              } 
              printf( __( '<cite class="fn">%s</cite> <span class="says">says:</span>' ), get_comment_author_link() ); ?>
          </div><?php 
          if ( $comment->comment_approved == '0' ) { ?>
              <em class="comment-awaiting-moderation"><?php _e( 'Your comment is awaiting moderation.' ); ?></em><br/><?php 
          } ?>
          <div class="comment-meta commentmetadata">
              <a href="<?php echo htmlspecialchars( get_comment_link( $comment->comment_ID ) ); ?>"><?php
                  /* translators: 1: date, 2: time */
                  printf( 
                      __('%1$s at %2$s'), 
                      get_comment_date(),  
                      get_comment_time() 
                  ); ?>
              </a><?php 
              edit_comment_link( __( '(Edit)' ), '  ', '' ); ?>
          </div>
  
          <?php comment_text(); ?>
  
          <div class="reply"><?php 
                  comment_reply_link( 
                      array_merge( 
                          $args, 
                          array( 
                              'add_below' => $add_below, 
                              'depth'     => $depth, 
                              'max_depth' => $args['max_depth'] 
                          ) 
                      ) 
                  ); ?>
          </div><?php 
      if ( 'div' != $args['style'] ) : ?>
          </div><?php 
      endif;
  }
  

  注意缺少尾随</li>。为了容纳嵌套的回复，WordPress将在列出子元素后添加适当的结束标记。

• 示例2

  如果您正在使用WordPress 4.9.6或更高版本，并且没有显示“评论正在等待审核”警报。

  您可以按照以下步骤操作。

  –）设置->讨论-> 启用“显示评论cookie复选框”
  –）激活后，复选框将显示在评论表单上，如下所示。“在此浏览器中保存我的姓名、电子邮件和网站，以便下次发表评论。”

  就是这样。

  如果要自定义此复选框字段，可以使用此代码。

  $comment_form = array(
      'fields' => array(
          'cookies' => '<p class="comment-form-cookies-consent"><input id="wp-comment-cookies-consent" name="wp-comment-cookies-consent" type="checkbox" value="yes"' . $consent . ' />' .
          '<label for="wp-comment-cookies-consent">' . __( 'Save my name, email, and website in this browser for the next time I comment.' ) . '</label></p>',
      ),
  );
  
  comment_form( $comment_form );
  

• 示例3

  wp_list_comments()本身不会做任何事情。它必须从评论模板文件内部调用。

  例如：

  要在其中插入评论的页面/文章文件：

  <?php comments_template('/comments.php'); ?>
  <?php /* Calling just comments_template() is also fine */ ?>
  

  然后，在comments.php中：

  <div>
  	<?php /* Add conditional checks, styling and arguments here... */ ?>
  	<?php wp_list_comments(); ?>
  </div>
  

• 示例4

  从Codex迁移的示例：

  输出特定页面或文章的有序评论列表。诸如嵌套或分页的启用或禁用是通过（设置>讨论）控制的。

  <ol class="commentlist">
  	<?php
  		//Gather comments for a specific page/post 
  		$comments = get_comments(array(
  			'post_id' => XXX,
  			'status' => 'approve' //Change this to the type of comments to be displayed
  		));
  
  		//Display the list of comments
  		wp_list_comments(array(
  			'per_page' => 10, //Allow comment pagination
  			'reverse_top_level' => false //Show the oldest comments at the top of the list
  		), $comments);
  	?>
  </ol>
  

• 示例5

  自定义默认的wp_list_comments()

  <ol class="comment-list">
  	<?php
  		wp_list_comments( array(
  			'avatar_size' => 60,
  			'max_depth'   => 5,
  			'style'       => 'ol',
  			'short_ping'  => true,
  			'type'        => 'comment',
  		) );
  	?>
  </ol><!-- .comment-list -->
  

• 示例6

  $cpage = get_query_var( 'cpage' ) ? get_query_var( 'cpage' ) : 1;
  wp_list_comments(
      array(
          'avatar_size'       => 60,
          'short_ping'        => true,
          'type'              => 'comment',
          'callback'          => 'ic_comment_list',
          'per_page'          => get_option( 'comments_per_page' ),
          'page'              => $cpage,
          'reverse_top_level' => get_option( 'default_comments_page' ) === 'oldest' ? false : true,
      )
  );