WordPress会根据主题中的comments.php文件中代码和设置来显示评论。
简单评论循环
//仅获取已审核通过的评论
$args = array(
'status' => 'approve'
);
// 评论查询
$comments_query = new WP_Comment_Query;
$comments = $comments_query->query( $args );
// 评论循环
if ( $comments ) {
foreach ( $comments as $comment ) {
echo '<p>' . $comment->comment_content . '</p>';
}
} else {
echo 'No comments found.';
}comments.php模板文件包含了从数据库中获取评论，并将它们在主题中显示出来的所有逻辑代码。
在探索模板文件之前，您需要了解如何在适当的页面（例如 single.php ）上引入部分模板文件。您需要把模板标记 包含在条件语句中，以便只有在合理的情况下才将comment.php引入。
// 如果允许评论，并且评论的数量大于1，才加载评论模板文件
if ( comments_open() || get_comments_number() ) :
comments_template();
endif;
另一个Comments.php示例
以下是Twenty Thirteen主题中包含的comments.php模板的示例：
<?php
/**
* 用于显示评论的模板。
*
* 包含评论和评论表单的页面区域。
*
* @package WordPress
* @subpackage Twenty_Thirteen
* @since Twenty Thirteen 1.0
*/
/*
* If the current post is protected by a password and the visitor has not yet
* entered the password we will return early without loading the comments.
*/
if ( post_password_required() )
return;
?>
<div id="comments" class="comments-area">
<?php if ( have_comments() ) : ?>
<h2 class="comments-title">
<?php
printf( _nx( 'One thought on "%2$s"', '%1$s thoughts on "%2$s"', get_comments_number(), 'comments title', 'twentythirteen' ),
number_format_i18n( get_comments_number() ), '<span>' . get_the_title() . '</span>' );
?>
</h2>
<ol class="comment-list">
<?php
wp_list_comments( array(
'style' => 'ol',
'short_ping' => true,
'avatar_size' => 74,
) );
?>
</ol><!-- .comment-list -->
<?php
// Are there comments to navigate through?
if ( get_comment_pages_count() > 1 && get_option( 'page_comments' ) ) :
?>
<nav class="navigation comment-navigation" role="navigation">
<h1 class="screen-reader-text section-heading"><?php _e( 'Comment navigation', 'twentythirteen' ); ?></h1>
<div class="nav-previous"><?php previous_comments_link( __( '← Older Comments', 'twentythirteen' ) ); ?></div>
<div class="nav-next"><?php next_comments_link( __( 'Newer Comments →', 'twentythirteen' ) ); ?></div>
</nav><!-- .comment-navigation -->
<?php endif; // Check for comment navigation ?>
<?php if ( ! comments_open() && get_comments_number() ) : ?>
<p class="no-comments"><?php _e( 'Comments are closed.' , 'twentythirteen' ); ?></p>
<?php endif; ?>
<?php endif; // have_comments() ?>
<?php comment_form(); ?>
</div><!-- #comments -->详解comments.php
上面的内容comments.php可以细分为以下部分，以便更好地理解。
模板标头
用于定义一个模板。
<?php
/**
* The template for displaying Comments.
*
* The area of the page that contains comments and the comment form.
*
* @package WordPress
* @subpackage Twenty_Thirteen
* @since Twenty Thirteen 1.0
*/
接下来，检查文章是否受密码保护，如果是，它将停止处理模板。
/*
* If the current post is protected by a password and the visitor has not yet
* entered the password we will return early without loading the comments.
*/
if ( post_password_required() )
return;
?>最后，检查是否有与此文章相关的评论。
<div id="comments" class="comments-area">
<?php if ( have_comments() ) : ?>评论标题
显示评论列表上方的标题。
使用_nx()翻译函数，以便其他开发人员可以提供其他语言翻译。
<h2 class="comments-title">
<?php
printf( _nx( 'One thought on "%2$s"', '%1$s thoughts on "%2$s"', get_comments_number(), 'comments title', 'twentythirteen' ),
number_format_i18n( get_comments_number() ), '<span>' . get_the_title() . '</span>' );
?>
</h2>评论列表
以下代码段使用wp_list_comments()函数创建了一个有序的评论列表。
<ol class="comment-list">
<?php
wp_list_comments( array(
'style' => 'ol',
'short_ping' => true,
'avatar_size' => 74,
) );
?>
</ol><!-- .comment-list -->评论分页
检查是否有足够的评论数量，如果达到分页的要求，就创建分页导航。
<?php
// Are there comments to navigate through?
if ( get_comment_pages_count() > 1 && get_option( 'page_comments' ) ) :
?>
<nav class="navigation comment-navigation" role="navigation">
<h3 class="screen-reader-text section-heading"><?php _e( 'Comment navigation', 'twentythirteen' ); ?></h3>
<div class="nav-previous"><?php previous_comments_link( __( '← Older Comments', 'twentythirteen' ) ); ?></div>
<div class="nav-next"><?php next_comments_link( __( 'Newer Comments →', 'twentythirteen' ) ); ?></div>
</nav><!-- .comment-navigation -->
<?php endif; // Check for comment navigation ?>评论已关闭
如果文章或页面不允许评论，就显示一行文字说明评论已关闭。
<?php if ( ! comments_open() && get_comments_number() ) : ?>
<p class="no-comments"><?php _e( 'Comments are closed.' , 'twentythirteen' ); ?></p>
<?php endif; ?>结束
本节结束评论循环，包括评论列表，并关闭评论容器。
<?php endif; // have_comments() ?>
<?php comment_form(); ?>
</div><!-- #comments -->评论分页
如果您有很多评论（这会使您的页面很长），那么对您的评论进行分页就非常有必要了。分页有助于提高页面加载速度，尤其是在移动设备上。可以分两步启用评论分页。
- 访问后台“设置 >讨论”，然后选中“分页显示评论 ” 框，在WordPress中启用分页评论。您可以为“ 每页显示评论数 ”设置任何数字。
- 打开您的
comments.php模板文件，并在要显示评论分页的位置添加下面的代码。
<div class="pagination">
<?php paginate_comments_links(); ?>
</div>替代评论模板
在某些情况下，您可能希望在主题中以不同的方式显示您的评论。为此，您将构建一个备用文件（例如short-comments.php）并按以下方式调用它：
<?php comments_template( '/short-comments.php' ); ?> 用于替代评论模板的文件的路径应相对于当前主题根目录，并包括所有子文件夹。因此，如果自定义评论模板位于主题内的文件夹中，则在调用时可能看起来像这样：
<?php comments_template( '/custom-templates/alternative-comments.php' ); ?>函数参考
- wp_list_comments()：根据各种参数（包括在管理后台中设置的参数）来显示文章或页面的所有评论。
- comment_form()：此标签输出完整的评论表单，已供模板使用。
- comments_template()：加载第一个参数中指定的评论模板。
- paginate_comments_links()：为当前文章上的评论创建分页链接。
- get_comments()：使用可能的参数检索评论。
- get_approved_comments()：检索提供的文章ID的已批准评论。
