Question

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

---

参数

$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'

---

源代码

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 );
}

---

更新日志

Version	description
1.5.0	Introduced.

---

相关函数

Uses

• wp-includes/link-template.php: get_next_post_link()

---

User Contributed Notes

1. Skip to note 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

   Usage

   <?php next_post_link( $format, $link, $in_same_term = false, $excluded_terms = '', $taxonomy = 'category' ); ?>

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 »”).

<?php next_post_link(); ?>

If there is no next post, the function does not print anything.

Bold Post Title As Link
Displays link with next chronological post’s title wrapped in ‘strong’ tags (“My Next Post Title”).

<?php next_post_link( '<strong>%link</strong>' ); ?>

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.

<?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

<?php next_post_link( '%link', 'Next post in category', TRUE, '13' ); ?>

Within Same Custom Taxonomy
Displays link to next post in the same custom taxonomy term.

<?php next_post_link( '%link', 'Next post in taxonomy', TRUE, '', 'my_custom_taxonomy' ); ?>

Note
See previous_post_link().