WordPress获取相邻文章函数：get_adjacent_post

WordPress函数get_adjacent_post用于获取相邻文章的信息，包括文章ID、文章发表时间、文章标题、文章别名、文章内容和文章摘要等。

get_adjacent_post( boolean $in_same_term = false, array $excluded_terms = '', boolean $previous = true, string $taxonomy = 'category' )

函数参数

$in_same_term

布尔值，默认值：false

是否返回同分类下的相邻文章，默认不区分分类。

$excluded_terms

数组，默认为空

提供要排除的分类ID

$previous

布尔值，默认值：true

如果为false，则返回下一篇文章的信息，默认返回上一篇文章的信息。

$taxonomy

字符串值，默认值：category

提供自定义分类法的名称

函数返回值

WP_Post Object ( [ID] => 215[post_author] => 1[post_date] => 2014-07-24 14:01:55[post_date_gmt] => 2014-07-24 06:01:55[post_content] => 文章内容[post_title] => 文章标题[post_excerpt] => 文章摘要[post_status] => publish[comment_status] => open[ping_status] => closed[post_password] =>[post_name] => 文章别名[to_ping] =>[pinged] =>[post_modified] => 2015-06-22 14:38:47[post_modified_gmt] => 2015-06-22 06:38:47[post_content_filtered] =>[post_parent] => 0[guid] => http://localhost/215.html[menu_order] => 0[post_type] => post[post_mime_type] =>[comment_count] => 0[filter] => raw)

get_adjacent_post()函数使用示例

<?php$prev_post = get_adjacent_post( true );if ( is_a( $prev_post, 'WP_Post' ) ) {echo '<a href="'%20.%20get_permalink(%20$prev_post->ID%20)%20.%20'">' . $prev_post->post_title . '</a>';}?>

扩展阅读

get_adjacent_post()函数位于：wp-includes/link-template.php

相关函数：

get_next_post()get_previous_post()