WordPress获取最早或最近文章函数:get_boundary_post

WordPress函数get_boundary_post用于获取最早或最近发表的一篇文章,在实际应用中使用得非常少。

1
get_boundary_post( boolean $in_same_term = false, string $excluded_terms = '', boolean $start = true, string $taxonomy = 'category' )

函数参数

$in_same_cat

布尔值,默认值:false

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

$excluded_categories

字符串值,默认为空

提供排除分类的ID,多个ID用半角逗号分隔。

$start

布尔值,默认值:true

  • 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
27
Array (
    [0] => WP_Post Object (
    [ID] => 36
    [post_author] => 1
    [post_date] => 2014-07-06 16:45:17
    [post_date_gmt] => 2014-07-06 08:45:17
    [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-26 19:59:04
    [post_modified_gmt] => 2015-06-26 11:59:04
    [post_content_filtered] =>
    [post_parent] => 0
    [guid] => http://localhost/36.html
    [menu_order] => 0
    [post_type] => post
    [post_mime_type] =>
    [comment_count] => 0
    [filter] => raw )
)

函数使用示例

1
2
3
4
5
6
7
8
<?php
    $first= get_boundary_post();
    if (!empty($first)) {
        foreach ($first as $post) {
            echo '<a href="' . get_permalink($post->ID) . '">' . $post->post_title . '</a>';
        }
    }
?>

扩展阅读

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

相关函数:

  • get_next_post()
  • get_previous_post()
原文链接:https://xiaohost.com/2341.html,转载请注明出处。
0