get_previous_post_link() │ WP 3.7.0

Gets a link (tag A) to the previous post relative (by date) to the current post.

The function should be used on separate pages of is_single() type.

No Hooks.

Return

String.

• HTML of link:

  <a rel="next" href="/some-post-name">Post title</a>

• An empty string if there is no suitable post.

Usage

get_previous_post_link( $format, $link, $in_same_term, $excluded_terms, $taxonomy );

$format(string)

Link format. %link will be replaced with <a> HTML. Example, '← %link' display ← <a ...>.
Default: '&laquo; %link'

$link(string)

Link text format. %title will be replaced with post title.
Default: '%title'

$in_same_term(true/false)

Whether link should be in the same taxonomy term. true - get the next post from the current category. If the post in a custom taxonomy, you need to specify the $taxonomy parameter.
Default: false

$excluded_terms(array/string)

Array or comma-separated list of excluded term IDs. You can specify a string or array: '1,5,15' or array(1,5,15).
Default: ''

$taxonomy(string)

The name of the taxonomy for the $in_same_term parameter.
Default: 'category'

Examples

# link to previous post
echo get_previous_post_link();
# display: ← <a href="http://test.ru/zagolovok" rel="prev">Title of post</a>

# link to the previous entry from the current category
echo get_previous_post_link( '%link', '← %title', 1 );
# display: <a href="http://test.ru/markup" rel="prev">← Markup</a>

# link to the previous post from the current taxonomy element (my_tax), for custom taxonomies
echo get_previous_post_link( '%link', '%title →', 1, '', 'my_tax' );

# link to the previous post without taking into account posts from categories 5 and 10
echo get_previous_post_link( '%link', '%title →', 0, '5,10' );

Add Your Own Example