wordpress评论标签wp_list_comments用法
wp_list_comments描述
根据各种参数(包括在管理区域中设置的参数)显示帖子或页面的所有评论。
wp_list_comments用法
- <?php wp_list_comments($ args,$ comments); ?>
wp_list_comments默认使用
$args
(array)(optional)该函数的选项。
默认如下:
- <?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'=>'',
- 'format'=>'html5',//或'xhtml'如果没有'HTML5'主题支持
- 'short_ping'=> false,// 3.6版本以后支持
- 'echo'=> true //布尔值,默认为true
- ); ?>
通过“讨论设置”管理面板可以更轻松地控制“max_depth”,“per_page”和“reverse_top_level”参数,但主题可以覆盖这些设置。
$comments
(array)(optional)通过get_comments查询获取的数组。
默认值:get_comments的默认返回值。
wp_list_comments具体参数
“walker”
(Walker object)提供一个自定义的Walker类对象,用于渲染注释。这是自定义评论HTML的主要方法。
<?PHP
wp_list_comments(array(
'walker'=> new Walker_Comment()
));
'MAX_DEPTH'
(整数)应该提取评论多深(在评论回复中)。
'样式'
(字符串)可以是'div','ol'或'ul'(默认)。请注意,任何包含标签必须明确写入。例如:
- <div class =“comment list”>
- <?php wp_list_comments(array('style'=>'div')); ?>
- </ DIV>
或者
- <ol class =“comment list”>
- <?php wp_list_comments(array('style'=>'ol')); ?>
- </ol>
'callback'
(callback)用于打开和显示每个注释的自定义函数的名称。使用这将使您的自定义函数被调用来显示每个评论,绕过这方面的所有内部WordPress的功能。使用自定义注释显示对HTML布局的极端更改。请注意,您的回调必须包含打开的<div>,<ol>或<ul>标记(与style参数对应),但不包含结束标记。 WordPress会自动提供结束标签,或者您可以使用结束回调来覆盖此默认值。回调与回调结束分开以便于分层评论。谨慎使用。
“end-callback”
(callback)用于关闭每个注释的自定义函数的名称。使用这个命令可以在每个注释结束时调用自定义函数,绕过基于style参数使用</ div>,</ ol>或</ li>的WordPress默认设置。用于自定义评论的结束标签。回调与回调结束分开以便于分层评论。谨慎使用。
'type'
(string)要显示的评论的类型。可以是“全部”,“评论”,“引用”,“pingback”或“ping”。 “ping”同时是“trackback”和“pingback”。
'REPLY_TEXT'
(string)在每个评论中显示的文本作为回复链接。 (这不是这个函数的参数,但它传递给get_comment_reply_link函数。)
'page'
(integer)在分页中显示的当前页面。
'per_page'
(integer)每个评论页面显示的项目数量。
'avatar_size'
(integer)头像应显示的大小(以像素为单位)。 http://gravatar.com/支持1到512之间的大小。使用0隐藏头像。
'reverse_top_level'
(boolean)将其设置为true将显示最近的评论,然后按顺序返回,将其设置为false将显示最早的评论。如果没有指定,它将使用存储在WordPress仪表板设置中的值。
'reverse_children'
(boolean)将其设置为true将显示最近的那些子级(回复级别注释),然后依次返回。
'format'
(boolean)可以设置为'html5'或'xhtml' - 默认为主题的current_theme_supports('html5')设置。
'short_ping'
(boolean)是否要使用简短的ping。
'echo'
(boolean)是否回显列表或只是返回它。