get_previous_posts_link( string $label = null )

Retrieves the previous posts page link.

Parameters

$label

(Optional) Previous page link text.

Default value: null

Return

(string|void) HTML-formatted previous page link.

Source

File: wp-includes/link-template.php 

function get_previous_posts_link( $label = null ) {
	global $paged;

	if ( null === $label )
		$label = __( '« Previous Page' );

	if ( !is_single() && $paged > 1 ) {
		/**
		 * Filters the anchor tag attributes for the previous posts page link.
		 *
		 * @since WP-2.7.0
		 *
		 * @param string $attributes Attributes for the anchor tag.
		 */
		$attr = apply_filters( 'previous_posts_link_attributes', '' );
		return '<a href="' . previous_posts( false ) . "\" $attr>". preg_replace( '/&([^#])(?![a-z]{1,8};)/i', '&#038;$1', $label ) .'</a>';
	}
}

Expand Source Code View on GitHub

Related

Uses

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

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

Filters the anchor tag attributes for the previous posts page link.
wp-includes/link-template.php: previous_posts()

Displays or retrieves the previous posts page link.
wp-includes/plugin.php: apply_filters()

Calls the callback functions that have been added to a filter hook.

Used By

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

Displays the previous posts page link.
wp-includes/link-template.php: get_posts_nav_link()

Retrieves the post pages link navigation for previous and next pages.
wp-includes/link-template.php: get_the_posts_navigation()

Returns the navigation to next/previous set of posts, when applicable.

Changelog

Changelog
Version Description
2.7.0 Introduced.