WordPress:Template Tags/previous post
Description
Used on single post/permalink pages, this tag lists the previous post in chronological order from the current post. It can work in conjuntion with the next_post() tag. This tag must be used in WordPress:The Loop.
For the index, category, and archives templates, use the posts_nav_link() tag.
Replace With
Usage
%%% <?php previous_post('format', 'previous', 'title', 'in_same_cat',
limitprev, excluded_category); ?> %%%
Examples
Default Usage
By default, displays text "previous post:" as link along with post title.
%%% <?php previous_post(); ?> %%%
Using Text As Link, Without Post Title
Displays specified text as link, without including the post title. If excessively long post titles break your layout, you may want to use this. "« Previous" is the specified text in this example; you can put whatever you want.
%%% <?php previous_post('%','« Previous', 'no'); ?> %%%
Using Specific Text
Displays previous and next post links in the format with the text before the post title not shown as a link.
<p><?php previous_post('%', 'Previous:', 'no'); ?> | <?php next_post('%', 'Next:', 'no'); ?></p>
Using Arrows Not Text
To display text, like arrows («), at the beginning of the previous post link and at the end of the next post link so it looks like:
<?php previous_post('« « %', '', 'yes'); ?> | <?php next_post('% » » ', '', 'yes'); ?>
Parameters
- format
- (string) Format string for the link. '%' in string will be replaced with the link, so 'Go to %' will generate "Go to <a href=..." Defaults to '%'.
- previous
- (string) Link text to display. Defaults to 'previous post: '.
- title
- (string) Indicates whether title should be used as link text. If set to 'yes', immediately follows previous (above). Options are:
- 'yes' (Default)
- 'no'
- in_same_cat
- (string) Indicates whether the previous post link must be in the same category/categories as current. Parameter works with versions of WordPress 1.5.1.3 and above. If post is listed in more than one category, it will show posts within the parent category, not the child category. Options are:
- 'yes'
- 'no' (Default)
- limitprev
- (integer) Sets previous post link on numeric value of parameter (current post ID minus limitprev). Defaults to 1. Default is recommended.
- excluded_category
- (integer -or- string) Numeric category ID(s) from which the previous post should not be listed. Separate multiple categories with an 'and': '1 and 5 and 15'. There is no default. Parameter works with versions of WordPress 1.5.2 and above.
Related
See also next_post().