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

返回介绍

next_post_link()

发布于 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.


描述


参数

$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 描述
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' ); ?>
  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' ); ?>

    Note
    See previous_post_link().

上一篇:next_posts_link()

下一篇:next_post_rel_link()

发布评论

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

目前还没有任何评论,快来抢沙发吧!