get_adjacent_post //WordPress获取相邻文章函数

get_adjacent_post //WordPress获取相邻文章函数

1
2
3
https://www.beizigen.com/wordpress-template-tags //wordpress 标签汇总
https://www.beizigen.com/wordpress-functions //wordpress 函数汇总
https://www.beizigen.com/1853.html

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

1
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

提供自定义分类法的名称

函数返回值

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
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
)

函数使用示例

1
2
3
4
5
<!--?php &lt;br ?--> $prev_post = get_adjacent_post( true );
if ( is_a( $prev_post, 'WP_Post' ) ) {
echo '<a href="' . get_permalink( $prev_post-&gt;ID ) . '">' . $prev_post-&gt;post_title . '</a>';
}
?&gt;

扩展阅读

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

相关函数:

1
2
get_next_post()
get_previous_post()

Leave a Reply

Your email address will not be published. Required fields are marked *