描述
另见
参数
- $args
-
(string|array) (可选) 参数，见 paginate_links() 的参数
默认值: array()
返回
(void|string|array) 如果“echo”参数为true并且“type”不是数组，或者如果查询不是针对任何文章类型的现有文章单页，则无返回。否则，根据“type”参数，返回评论页面链接的标记或评论页面链接的数组。
说明
默认值
$args = array(
'base' => add_query_arg( 'cpage', '%#%' ),
'format' => '',
'total' => $max_page,
'current' => $page,
'echo' => true,
'add_fragment' => '#comments'
);
传入的参数通过wp_parse_args()合并为默认值
这些参数主要是为了使paginate_links()的调用起作用，因此更改它们时要小心。
源码
更新日志
| 版本 | 描述 |
|---|---|
| 2.7.0 | 开始引入 |
使用示例
增强的评论显示
WordPress 使 comments.php 文件易于编写和编辑。很容易将评论分为多个页面，这样你就不会在每个页面视图上加载数百条评论。
您需要在 设置 > 讨论 中设置选项使分页起效。
最简单的方法是使用以下函数，它打印出指向下一个和上一个评论页面的链接，以及所有评论页面的页码列表。
paginate_comments_links( $args );
它接受类似于 get_posts() 或 get_terms() 的数组或查询样式的参数列表。
如果您想要更多的控制，还可以使用更简单的next和previous函数：
next_comments_link( $label = "", $max_page = 0 );
和
previous_comments_link( $label = "" );
自定义上一个/下一个链接
要修改上一个和下一个链接，可以使用选项“prev_text”和“next_text”。这些由函数paginate_links()提供。
paginate_comments_links( array( 'prev_text' => 'back', 'next_text' => 'forward' ) );
注意：如果要在“prev_text”或“next_text”中使用HTML实体，则必须使用基于数组的语法。
paginate_comments_links( array( 'prev_text' => '«', 'next_text' => '»' ) )
paginate_comments_links(array( 'screen_reader_text'=> __('Pagination','text_domain'), 'prev_text'=> __('Previous','text_domain'), 'next_text'=> __('Next','text_domain'), ));