get_previous_posts_page_link()

Retrieves the previous posts page link.

Description

Will only return string, if not on a single page or post.

Backported to 2.0.10 from 2.1.3.

Return

(string|void) The link for the previous posts page.

Source

File: wp-includes/link-template.php 

function get_previous_posts_page_link() {
	global $paged;

	if ( ! is_single() ) {
		$nextpage = (int) $paged - 1;
		if ( $nextpage < 1 ) {
			$nextpage = 1;
		}
		return get_pagenum_link( $nextpage );
	}
}

Uses

Uses Description
wp-includes/query.php: is_single()

Determines whether the query is for an existing single post.
wp-includes/link-template.php: get_pagenum_link()

Retrieves the link for a page number.

Used By

Used By Description
wp-includes/link-template.php: previous_posts()

Displays or retrieves the previous posts page link.

Changelog

Version Description
2.0.10 Introduced.

© 2003–2021 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/get_previous_posts_page_link