描述
获取上一篇文章的链接
语法
get_previous_post( bool $in_same_term = false, array|string $excluded_terms = '', string $taxonomy = 'category' )
参数
$in_same_term:(bool) (Optional)( Default value: false) 文章是否在同一分类
$excluded_terms:(array|string) (Optional) (Default value: '') 排除分类的ID
$taxonomy:(string) (Optional)(Default value: 'category') 如果 $in_same_term 设置为 表示限定的分类
返回
WP_Post:如果成功,返回文章对 象。
Null:如果 global $post 没有设置,返回空值Null。
String:如果不存在符合条件的文章 ,返回空字符串。
示例
<?php
$prev_post = get_previous_post();
if ( ! empty( $prev_post ) ): ?>
<a href="<?php echo get_permalink( $prev_post->ID ); ?>">
<?php echo apply_filters( 'the_title', $prev_post->post_title ); ?>
</a>
<?php endif; ?>
关系
调用
wp-includes/link-template.php: get_adjacent_post()
被用
wp-includes/deprecated.php: previous_post()
源码
function get_previous_post( $in_same_term = false, $excluded_terms = '', $taxonomy = 'category' ) {
return get_adjacent_post( $in_same_term, $excluded_terms, true, $taxonomy );
}