get_previous_post_link

函数


get_previous_post_link ( $format = '« %link', $link = '%title', $in_same_term = false, $excluded_terms = '', $taxonomy = 'category' )
参数
  • (string)
    $format
    Optional. Link anchor format. Default ‘« %link’.
    Required:
    Default: ‘« %link’
  • (string)
    $link
    Optional. Link permalink format. Default ‘%title’.
    Required:
    Default: ‘%title’
  • (bool)
    $in_same_term
    Optional. Whether link should be in a same taxonomy term. Default false.
    Required:
    Default: false
  • (int[]|string)
    $excluded_terms
    Optional. Array or comma-separated list of excluded term IDs. Default empty.
    Required:
    Default: (empty)
  • (string)
    $taxonomy
    Optional. Taxonomy, if $in_same_term is true. Default ‘category’.
    Required:
    Default: ‘category’
返回值
  • (string) The link URL of the previous post in relation to the current post.
定义位置
  • wp-includes/link-template.php
    , line 2206
引入
3.7.0
弃用

Retrieves the previous post link that is adjacent to the current post.

function get_previous_post_link( $format = '« %link', $link = '%title', $in_same_term = false, $excluded_terms = '', $taxonomy = 'category' ) {
	return get_adjacent_post_link( $format, $link, $in_same_term, $excluded_terms, true, $taxonomy );
}