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

返回介绍

previous_post_link()

发布于 2017-09-11 字数4664 浏览 825 评论 0

previous_post_link( string $format = '« %link',  string $link = '%title',  bool $in_same_term = false,  array|string $excluded_terms = '',  string $taxonomy = 'category' )

Displays the previous 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 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 previous_post_link( $format = '« %link', $link = '%title', $in_same_term = false, $excluded_terms = '', $taxonomy = 'category' ) {
	echo get_previous_post_link( $format, $link, $in_same_term, $excluded_terms, $taxonomy );
}

更新日志

Version 描述
1.5.0 Introduced.

相关函数

Uses

  • wp-includes/link-template.php:
    get_previous_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

    Default Usage

    Displays link with left angular quote («) followed by the post title of the previous post (chronological post date order).

    « Previous Post Title

    
    <?php previous_post_link(); ?> 
    
  2. Bold Post Title As Link

    Displays link with previous chronological post’s title wrapped in ‘strong’ tags (typically sets text to bold).

    Previous Post Title

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

    Text As Link, Without Post Title, Within Same Category

    Displays custom text as link to the previous post within the same category as the current post. Post title is not included here. “Previous in category” is the custom text, which can be changed to fit your requirements.

    Previous in category

    
    <?php previous_post_link( '%link', __( 'Previous in category', 'textdomain' ), true ); ?> 
    

    Within Same Category, Excluding One

    Displays link to previous post in the same category, as long as it is not in category 13 (the category ID

    Previous in category

    
    <?php previous_post_link( '%link', 'Previous in category', true, '13' ); ?> 
    

    Within Same Taxonomy

    Displays link to previous post in the same taxonomy term. Post Formats are a taxonomy so the following would link to the previous post with the same post format.

    Previous post in taxonomy

    
    <?php previous_post_link( '%link', 'Previous post in category', true, ' ', 'post_format' ); ?>
    

    Post Title As Link, Within Same Custom Taxonomy

    Displays link to previous post in the same custom taxonomy term. You have a Custom Post Type called Buildings, and a custom taxonomy called Neighborhood

    Previous Title in Neighborhood

    
    <?php previous_post_link( '%link', '%title', true, ' ', 'neighborhood' ); ?>
    

发布评论

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

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