next_post_link( string $format = '%link »', string $link = '%title', bool $in_same_term = false, array|string $excluded_terms = '', string $taxonomy = 'category' )
Displays the next post link that is adjacent to the current post.
Description
See also
Parameters
- $format
-
(string) (Optional) Link anchor format. Default '« %link'.
Default value: '%link »'
- $link
-
(string) (Optional) Link permalink format. Default '%title'
Default value: '%title'
- $in_same_term
-
(bool) (Optional) Whether link should be in a same taxonomy term.
Default value: false
- $excluded_terms
-
(array|string) (Optional) Array or comma-separated list of excluded term IDs.
Default value: ''
- $taxonomy
-
(string) (Optional) Taxonomy, if $in_same_term is true.
Default value: 'category'
Source
File: wp-includes/link-template.php
function next_post_link( $format = '%link »', $link = '%title', $in_same_term = false, $excluded_terms = '', $taxonomy = 'category' ) {
echo get_next_post_link( $format, $link, $in_same_term, $excluded_terms, $taxonomy );
}
Changelog
| Version | Description |
|---|---|
| 1.5.0 | Introduced. |
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.
Bold Post Title As Link
Displays link with next chronological post’s title wrapped in ‘strong’ tags (“My Next Post Title”).
Usage
Example: Default Usage
Displays link to the next post (chronologically by publish date) with the post title as the link text, followed by a right angle quote (“My Next Post Title »”).
If there is no next post, the function does not print anything.
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 in this example.
Within Same Custom Taxonomy
Displays link to next post in the same custom taxonomy term.
Note
See
previous_post_link().