常用函数-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中。

相关资源

分类：中文手册