wp_list_comments()函数

wp_list_comments 函数是一个循环输出当前文章或页面每个评论的函数,在 WordPress 主题中主要被用来输出每一条评论,省去我们手工便利之苦,也把 WordPress 的评论功能很好的进行了模块化。

wp_list_comments函数在主题中配合comments_template()函数联合使用可以很好的将 WordPress 的评论功能独立出来,而且可以更好对评论嵌套层数、每页显示评论数量、评论样式等等进行控制。所以如果你想做好主题的话,那还是看一下吧。

语法

<?php wp_list_comments( $args ); ?>
参数使用
<?php $args = array(
    'walker'            => null,
    'max_depth'         => ,
    'style'             => 'ul',
    'callback'          => null,
    'end-callback'      => null,
    'type'              => 'all',
    'reply_text'        => 'reply',
    'page'              => ,
    'per_page'          => ,
    'avatar_size'       => 32,
    'reverse_top_level' => null,
    'reverse_children'  =>  ); ?>

‘walker’ 自定义样式类名
‘max_depth’ (整数)应该提取评论多深(在评论回复中)
$style 评论容器标签可以是 ‘div’, ‘ol’, or ‘ul’,默认值是’ul’,如果不是,那你需要像如下那样明确写出。

<div class="commentlist">
    <?php wp_list_comments(array('style' => 'div')); ?>
</div>

<ol class="commentlist">
    <?php wp_list_comments(array('style' => 'ol')); ?>
</ol>

‘callback ‘ 评论显示的回调函数,即显示评论主题的函数名称
‘end-callback’ 应该是循环结束后的回调函数,本人未实测,请自行探索。
‘type’ 显示何种评论,参数可以是 ‘all’、’comment’、’trackback’、’pingback’、’pings’. ‘pings’ 包括’trackback’ 和 ‘pingback’.
默认值: ‘all’
‘reply_text’ 回复按钮的文本值,这个较少用不解释 默认值: ‘Reply’
‘page’(integer)在分页中显示的当前页面。
‘per_page’(integer)每个评论页面显示的项目数量。
‘avatar_size’(integer)头像应显示的大小(以像素为单位)。 http://gravatar.com/支持1到512之间的大小。使用0隐藏头像。
‘reverse_children’ 布尔值,如果设置本参数为真,则先显示最新一条有子评论的评论,后面的评论按照后台设置显示。
‘reverse_top_level’  布尔值,如果设置本参数为真,则先显示最新一条评论,后面的评论按照后台设置显示。