next_posts( int $max_page = 0, bool $display = true ): string|null

Parameters

$max_pageintoptional

Max pages. Default 0.Default: 0

$displaybooloptional

Whether to echo the link. Default true.Default: true

Return

string|null

The link URL for next posts page if $display = false.

Uses · 2

• get_next_posts_page_link()Retrieves the next posts page link.
• esc_url()Checks and cleans a URL.

Used by · 1

• get_next_posts_link()Retrieves the next posts page link.

Source

View on Trac ↗View on GitHub ↗

2544function next_posts( $max_page = 0, $display = true ) {2545	$link   = get_next_posts_page_link( $max_page );2546	$output = $link ? esc_url( $link ) : '';2547 2548	if ( $display ) {2549		echo $output;2550	} else {2551		return $output;2552	}2553}

History

Introduced in 0.71. One change between 6.7.7 and 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 7.0.4 tag, from src/wp-includes/link-template.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.