常用函数-paginate_comments_link()
说明
为当前文章创建评论页码链接
用法
<?php paginate_comments_links( $args ) ?>
参数
$args
（字符串 | 数组）（可选）可选参数，参见paginate_links
默认值：数组
返回的值
（字符串）
标记页码链接
示例
Enhanced Comments Display
Wordpress 2.7版添加了 Enhanced Comment Display系统，该系统简化了comments.php文件的编辑。 Enhanced Comment Display系统其中一个功能就是可以轻易地将评论分页，从此用户不必再将所有评论存放在一个页面内。
需要在SETTINGS > DISCUSSION中设置选项以运行分页。
运行此操作的最简单方法是执行以下函数，该函数输出上下页评论的链接以及所有评论页面的数字列表。
paginate_comments_links($args);
函数接受类似于get_posts() or get_terms()参数的查询样式列表。默认值包括：
- 'base' => add_query_arg( 'cpage', '%#%' ),
- 'format' => ,
- 'total' => $max_page,
- 'current' => $page,
- 'echo' => true,
- 'add_fragment' => '#comments'
这些参数主要用于使函数运行，因此改变参数时要多加注意。
需要更强控制时可以使用简单的上下页函数：
next_comments_link($label=, $max_page = 0)
以及
previous_comments_link($label=)
注释
- 参见paginate_links()
- 使用全局变量：（对象）$wp_query
- 使用全局变量：（对象）$wp_rewrite
修改记录
自2.7.0版本后
源文件
paginate_comments_links()位于 wp-includes/link-template.php中。
相关资源
分类：中文手册