previous_posts( bool $display = true ): string|null

Parameters

$displaybooloptional

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

Return

string|null

The previous posts page link if $display = false.

Uses · 2

• get_previous_posts_page_link()Retrieves the previous posts page link.
• esc_url()Checks and cleans a URL.

Used by · 1

• get_previous_posts_link()Retrieves the previous posts page link.

Source

View on Trac ↗View on GitHub ↗

2650function previous_posts( $display = true ) {2651	$link   = get_previous_posts_page_link();2652	$output = $link ? esc_url( $link ) : '';2653 2654	if ( $display ) {2655		echo $output;2656	} else {2657		return $output;2658	}2659}

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.1.0 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.