常用函数-paginate_comments_link()

0条评论

常用函数-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=)

注释

修改记录

自2.7.0版本后

源文件

paginate_comments_links()位于 wp-includes/link-template.php中。

相关资源