WordPress会根据WordPress主题中的comments.php文件中的设置和代码在主题中显示注释。
简单的评论循环
<?php
//Get only the approved comments
$args = array(
'status' => 'approve'
);
// The comment Query
$comments_query = new WP_Comment_Query;
$comments = $comments_query->query( $args );
// Comment Loop
if ( $comments ) {
foreach ( $comments as $comment ) {
echo '<p>' . $comment->comment_content . '</p>';
}
} else {
echo 'No comments found.';
}
?>
comments.php模板包含将注释从数据库中拉出并显示在主题中的所有逻辑。
在我们探索模板文件之前，您需要知道如何在相应的页面（如single.php）上拉入部分模板文件。 您将包含注释模板标签在条件语句中，所以comments.php只有在有意义的情况下被拉入。
// 如果发表评论，或者至少有一个评论，请加载评论模板。
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
以上的comment.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">
<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 -->
评论分页
如果您有很多评论（这使您的页面很长），那么分页您的评论有很多潜在的好处。 分页有助于提高页面加载速度，特别是在移动设备上。
启用评论分页是分两步完成的。
在WordPress中启用分页评论，方法是进入“Settings”>“Discussion”，并选中“Break comments into pages”框。 您可以输入“每页评论数量”的任意数字。
打开您的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的批准注释。
检索评论元素的函数参考
get_comment_link()get_comment_author()get_comment_date()get_comment_time()get_comment_text()
下一节：访问者点击类别，标签或自定义分类法的超链接时，WordPress会以相反的时间顺序显示一页帖子，按照该分类法过滤。默认情况下，此页面使用index.php模板文件生成。 您可以创建可选的模板文件来覆盖和优化index.php模板文件。 本节介绍如何使用和创建此类模板。