WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

get_previous_posts_link()

get_previous_posts_link( string $label = null ): string|void

In this article

Back to top

Retrieves the previous posts page link.

Parameters

$labelstringoptional
Previous page link text.

Default:null

Return

string|void HTML-formatted previous page link.

Source

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 2.7.0
		 *
		 * @param string $attributes Attributes for the anchor tag.
		 */
		$attr = apply_filters( 'previous_posts_link_attributes', '' );

		return sprintf(
			'<a href="%1$s" %2$s>%3$s</a>',
			previous_posts( false ),
			$attr,
			preg_replace( '/&([^#])(?![a-z]{1,8};)/i', '&#038;$1', $label )
		);
	}
}

View all references View on Trac View on GitHub

Hooks

apply_filters( ‘previous_posts_link_attributes’, string $attributes )

Filters the anchor tag attributes for the previous posts page link.

UsesDescription
is_single()wp-includes/query.php

Determines whether the query is for an existing single post.

previous_posts()wp-includes/link-template.php

Displays or retrieves the previous posts page link.

apply_filters()wp-includes/plugin.php

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

Show 1 moreShow less
Used byDescription
get_the_posts_navigation()wp-includes/link-template.php

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

previous_posts_link()wp-includes/link-template.php

Displays the previous posts page link.

get_posts_nav_link()wp-includes/link-template.php

Retrieves the post pages link navigation for previous and next pages.

Changelog

VersionDescription
2.7.0Introduced.

User Contributed Notes

  2. Skip to note 4 content
    Akira Tachibana
    You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

    [From Codex] Removing Trailing Slashes from Prev & Next links

    If you are using no-end-trailing slashes for your URLs. You may add following filter in your functions file to remove trailing slashes from generated links from get_previous_posts_links() function.

    <?php 
add_filter( 'get_pagenum_link', 'user_trailingslashit' );
?>

You must log in before being able to contribute a note or feedback.