posts_nav_link( string $sep = '', string $prelabel = '', string $nxtlabel = '' )

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

Contents

Parameters

$sep string Optional
Separator for posts navigation links.

Default: ''

$prelabel string Optional
Label for previous pages.

Default: ''

$nxtlabel string Optional
Optional Label for next pages.

Default: ''

Top ↑

More Information

For displaying next and previous pages of posts see next_posts_link() and previous_posts_link() .

For displaying next and previous post navigation on individual posts, see next_post_link() and previous_post_link() .

Note: since weblog posts are traditionally listed in reverse chronological order (with most recent posts at the top), there is some ambiguity in the definition of “next page”. WordPress defines “next page” as the “next page toward the past“.

Top ↑

Source

File: wp-includes/link-template.php. View all references 

function posts_nav_link( $sep = '', $prelabel = '', $nxtlabel = '' ) {
	$args = array_filter( compact( 'sep', 'prelabel', 'nxtlabel' ) );
	echo get_posts_nav_link( $args );
}

View on Trac View on GitHub

Top ↑

Top ↑

Uses

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

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

Top ↑

Changelog

Changelog
Version Description
0.71 Introduced.

Top ↑

User Contributed Notes

  4. Skip to note 4 content
    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
    Contributed by Codex —

    Kubrick Theme Format

    The Kubrick theme format for posts navigation, could be formatted this way. However, using posts_nav_link() in this way will result in unintended behavior, such as double stacked next and previous links that link to the incorrect sections.

    The Kubrick Theme actually uses next_posts_link() and previous_posts_link().

    This is poor code and should not be used:

    <div class="navigation">
<div class="alignleft"><?php posts_nav_link( '', '', '&laquo; Previous Entries' ); ?></div>
<div class="alignright"><?php posts_nav_link( '', 'Next Entries &raquo;', '' ); ?></div>
</div>

    This is better code:

    <div class="navigation">
<div class="alignleft"><?php previous_posts_link( '&laquo; Previous Entries' ); ?></div>
<div class="alignright"><?php next_posts_link( 'Next Entries &raquo;', '' ); ?></div>
</div>
  5. Skip to note 5 content
    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
    Contributed by Codex —

    You can change the text in each of the links and in the text in between the links.

    You can go back to the previous page or you can go forward to the next page.

    <p><?php posts_nav_link( ' or ', 'You can go back to the previous page', 'you can go forward to the next page' ); ?>.</p>

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