上一篇:get_adjacent_post
下一篇:get_previous_post

WordPress常用函数: get_next_post

文章目录
  1. 描述
  2. 语法
  3. 参数
  4. 返回值
  5. 示例
  6. 相关
  7. 源码

描述

获取下一篇文章

语法

get_next_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 设置为true 表示限定的分类

返回值

WP_Post:如果成功,返回文章对 象。

Null:如果 global $post 没有设置,返回空值Null。

String:如果不存在符合条件的文章 ,返回空字符串。

示例

$next_post = get_next_post();
if ( is_a( $next_post , 'WP_Post' ) ) : ?>
    <a href="<?php echo get_permalink( $next_post->ID ); ?>"><?php echo get_the_title( $next_post->ID ); ?></a>
<?php endif; ?>

相关

调用

wp-includes/link-template.php:get_adjacent_post

被用

wp-includes/deprecated.php: next_post()

源码

位置:wp-includes/link-template.php

function get_next_post( $in_same_term = false, $excluded_terms = '', $taxonomy = 'category' ) {
    return get_adjacent_post( $in_same_term, $excluded_terms, false, $taxonomy );
}