函数wp_list_comments()用于显示评论列表。下面是该函数的详细用法教程解析:

1. 基本语法:

wp_list_comments( array $args = array(), array $comments = null );

- $args: 可选参数,用于定义评论列表的样式和行为。
- $comments: 可选参数,包含评论对象的数组。

2. 常用参数:

- avatar_size:设置评论者头像的大小。例如,'avatar_size' => 50。
- style:设置评论列表的样式。例如,'style' => 'ol'。
- callback:自定义评论输出的回调函数。例如,'callback' => 'my_custom_comment_callback'。
- type:指定要显示的评论类型。例如,'type' => 'comment',将只显示普通评论,不包括回复评论。
- reverse_top_level:设置是否将顶级评论反向排序。例如,'reverse_top_level' => true,将最新的顶级评论显示在最前面。
- max_depth:设置评论嵌套的最大深度。例如,'max_depth' => 2,将只显示最多两层的评论。

3. 自定义输出:

可以通过回调函数自定义评论的输出。回调函数接受一个评论对象作为参数,并输出相应的HTML代码。

function my_custom_comment_callback( $comment, $args, $depth ) {
// 自定义评论输出的HTML代码
}

在调用wp_list_comments()函数时,将自定义的回调函数的名称传递给callback参数即可。

4. 示例代码:

下面是一个示例代码,展示了如何使用wp_list_comments()函数来显示评论列表:

$args = array(
'avatar_size' => 50,
'style' => 'ol',
'reverse_top_level' => true,
'max_depth' => 2
);

wp_list_comments( $args );

以上代码将显示一个按回复倒序排列的评论列表,只包含最多两层的评论,每个评论的头像大小为50像素,并使用有序列表的样式。