get_previous_posts_page_link() │ WP 2.0.10

Retrieves the previous posts page link.

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

Backported to 2.0.10 from 2.1.3.

Uses: get_pagenum_link()
Used By: get_previous_posts_link()
1 time — 0.0017691 sec (very slow) | 50000 times — 5.09 sec (fast)

No Hooks.

Return

String|null. The link for the previous posts page.

Usage

get_previous_posts_page_link();

Notes

  • Global. Int. $paged

Changelog

Since 2.0.10 Introduced.

get_previous_posts_page_link() code WP 6.5.2

wp-includes/link-template.php 
function get_previous_posts_page_link() {
	global $paged;

	if ( ! is_single() ) {
		$previous_page = (int) $paged - 1;

		if ( $previous_page < 1 ) {
			$previous_page = 1;
		}

		return get_pagenum_link( $previous_page );
	}
}

Navigation pagination

Link (URL)

Archives