WordPress.org

Codex

Attention Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

zh-cn:paginate comments links

说明

创建页面评论分页链接。

这是评论功能的基本函数 paginate_links() 。 但你可以使用带有所有参数函数paginate_comments_links()的方式来输出函数paginate_links()

使用

<?php paginate_comments_links$args ?>

参数

$args
(字符串|数组) (optional) 可选参数。 见 paginate_links().
Default: array

默认值

<?php $args = array(
	'base' => add_query_arg( 'cpage', '%#%' ),
	'format' => '',
	'total' => $max_page,
	'current' => $page,
	'echo' => true,
	'add_fragment' => '#comments'
					
);?>

参考: 传递过来的参数将合并到默认设置wp_parse_args.
有些参数几乎是通过函数 paginate_links() 工作的,所以使用的时候务必小心。

Return Values

(string) 
Markup for pagination links.

Examples

Enhanced Comment Display

In version 2.7 WordPress added the Enhanced Comment Display system to make comments.php files much simpler to write and edit. One is the ability to easily break comments into pages so that you don't end up with hundreds of comments all loading on every pageview.

You will need to set up the options in SETTINGS > DISCUSSION for paging to work.

The easiest way to do so is with the following function, which prints out a link to the next and previous comment pages, as well as a numbered list of all the comment pages.

paginate_comments_links($args);

It accepts a query-style list of arguments similar to get_posts() or get_terms().

If you want more control, you can also use the simpler next and previous functions:

next_comments_link($label="", $max_page = 0)

and

previous_comments_link($label="")

Custom Prev-/Next-links

To modify the Prev- and Next-links, you can use the options 'prev_text' and 'next_text'. These are provided by the function paginate_links().

paginate_comments_links('prev_text=back&next_text=forward')

If you want to use HTML entities in your 'prev_text' or 'next_text', you will have to use the array-based syntax, as it is descriped on the wp_parse_args()-page:

paginate_comments_links( array('prev_text' => '&laquo;', 'next_text' => '&raquo;') )


Notes

Change Log

Since: 2.7.0

Source File

paginate_comments_links() is located in wp-includes/link-template.php.

Related

See also index of Function Reference and index of Template Tags.