描述
如果不是在文章单页或页面上,或者文章没有评论,则不会显示评论模板。
使用WordPress数据库对象查询评论。评论通过‘comments_array’过滤器钩子传递,分别带有评论列表和文章ID。
$file
路径通过一个名为‘comments_template’的过滤器钩子传递,其中包括TEMPLATEPATH和$file组合。首先尝试$filtered路径,如果失败,则需要来自默认主题的默认评论模板。如果其中一个不存在,则WordPress进程将暂停。因此,建议不要删除默认主题。
如果文章没有评论,则不会尝试去获取。
参数
- $file
-
(string) (可选) 要加载的文件。
默认值: '/comments.php'
- $separate_comments
-
(bool) (可选) 是否按评论类型分隔评论。
默认值: false
源码
更新日志
版本 | 描述 |
---|---|
1.5.0 | 开始引入 |
使用示例
在某些情况下,您可能希望在主题中以不同的方式显示您的评论。为此,您将构建一个备用文件(例如
short-comments.php
),并按如下方式调用它:<?php comments_template( '/short-comments.php' ); ?>
用于替代评论模板的文件路径应相对于当前主题根目录,并包括任意子文件夹。因此,如果自定义评论模板位于主题内的文件夹中,则调用时可能如下所示:
<?php comments_template( '/custom-templates/alternative-comments.php' ); ?>
在page.php和single.php中使用
// If comments are open or we have at least one comment, load up the comment template. if ( comments_open() || get_comments_number() ) : comments_template(); endif;
默认用法
<?php comments_template(); ?>