next_post_link() - WordPress 函数参考中文文档



发布于 2017-09-11 字数4291 浏览 931 评论 0

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.




Link anchor format. Default ‘« %link’.

Default value: ‘%link »’


Link permalink format. Default ‘%title’

Default value: ‘%title’


Whether link should be in a same taxonomy term.

Default value: false


Array or comma-separated list of excluded term IDs.

Default value: ”


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 描述
1.5.0 Introduced.



  • wp-includes/link-template.php:

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


    <?php next_post_link( $format, $link, $in_same_term = false, $excluded_terms = '', $taxonomy = 'category' ); ?>
  2. 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' ); ?>

    See previous_post_link().




需要 登录 才能够评论, 你可以免费 注册 一个本站的账号。