get_comments_pagenum_link() │ WP 2.7.0

Retrieves the comments page number link.

Uses: get_permalink(), user_trailingslashit()
Used By: get_next_comments_link(), get_previous_comments_link()
1 time — 0.00016 sec (fast) | 50000 times — 5.76 sec (fast)
Hooks from the function

Return

String. The comments page number link URL.

Usage

get_comments_pagenum_link( $pagenum, $max_page );
$pagenum(int)
Page number.
Default: 1
$max_page(int)
The maximum number of comment pages.

Examples

0

#1 Get a link to the comment pagination page of the current page

Suppose we are at http://example.com/page. Then this is how the function will work, with different parameters

echo get_comments_pagenum_link( 5 );
// http://example.com/page/comment-page-5#comments

echo get_comments_pagenum_link( 5, 6 );
// http://example.com/page/comment-page-5#comments

echo get_comments_pagenum_link( 5, 4 );
// http://example.com/page/comment-page-5#comments

echo get_comments_pagenum_link( 5, 5 );
// http://example.com/page#comments

Notes

  • Global. WP_Rewrite. $wp_rewrite WordPress rewrite component.

Changelog

Since 2.7.0 Introduced.

get_comments_pagenum_link() code WP 6.1.1

wp-includes/link-template.php 
function get_comments_pagenum_link( $pagenum = 1, $max_page = 0 ) {
	global $wp_rewrite;

	$pagenum = (int) $pagenum;

	$result = get_permalink();

	if ( 'newest' === get_option( 'default_comments_page' ) ) {
		if ( $pagenum != $max_page ) {
			if ( $wp_rewrite->using_permalinks() ) {
				$result = user_trailingslashit( trailingslashit( $result ) . $wp_rewrite->comments_pagination_base . '-' . $pagenum, 'commentpaged' );
			} else {
				$result = add_query_arg( 'cpage', $pagenum, $result );
			}
		}
	} elseif ( $pagenum > 1 ) {
		if ( $wp_rewrite->using_permalinks() ) {
			$result = user_trailingslashit( trailingslashit( $result ) . $wp_rewrite->comments_pagination_base . '-' . $pagenum, 'commentpaged' );
		} else {
			$result = add_query_arg( 'cpage', $pagenum, $result );
		}
	}

	$result .= '#comments';

	/**
	 * Filters the comments page number link for the current request.
	 *
	 * @since 2.7.0
	 *
	 * @param string $result The comments page number link.
	 */
	return apply_filters( 'get_comments_pagenum_link', $result );
}

Comments pagination (navigation)

Comments

Link (URL)

Comments