WordPress:Template Tags/next post link
Description
Used on single post permalink pages, this template tag displays a link to the next post which exists in chronological order from the current post.
This tag must be used in WordPress:The Loop.
Usage
%%% <?php next_post_link('format', 'link', in_same_cat,
'excluded_categories'); ?> %%%
Examples
Default Usage
Displays link with the post title of the next post (chronological post date order), followed by a right angular quote (»). By default, this tag works like WordPress:Next Post
<?php next_post_link(); ?>
Bold Post Title As Link
Displays link with next chronological post's title wrapped in 'strong' tags (typically sets text to bold).
%%% <?php next_post_link('%link'); ?> %%%
Text As Link, Without Post Title, Within Same Category
Displays custom text as link to the next post within the same category as the current post. Post title is not included here. "Next post in category" is the custom text, which can be changed to fit your requirements.
<?php next_post_link('%link', 'Next post in category', TRUE); ?>
Within Same Category, Excluding One
Displays link to next post in the same category, as long as it is not in category 13 (the category ID #). You can change the number to any category you wish to exclude. Exclude multiple categories by using " and " as a delimiter.
<?php next_post_link('%link', 'Next post in category', TRUE, '13'); ?>
Parameters
- format
- (string) Format string for the link. This is where to control what comes before and after the link. '%link' in string will be replaced with whatever is declared as 'link' (see next parameter). 'Go to %link' will generate "Go to <a href=..." Put HTML tags here to style the final results. Defaults to '%link »'.
- link
- (string) Link text to display. Defaults to next post's title ('%title').
- in_same_cat
- (boolean) Indicates whether next post must be within the same category as the current post. If set to TRUE, only posts from the current category will be displayed. Options are:
- TRUE
- FALSE (Default)
- excluded_categories
- (string) Numeric category ID(s) from which the next post should not be listed. Separate multiple categories with and; example: '1 and 5 and 15'. There is no default.
- In Wordpress 2.2, apparently, concatenating multiple categories for exclusion is done with a comma, not and; example: '1, 5, 15'. Still no default.
Related
See also previous_post_link().