get_adjacent_post()获取相邻文章

目录

描述

译文

检索相邻的文章, 以是上 篇或下一篇。

 

原文

Retrieve adjacent post. Can either be next or previous post.

get_adjacent_post() 描述

用法

get_adjacent_post() 用法

参数

$in_same_term

(boolean) (可选)文章是否在同一分类。

 值: false

$excluded_terms

(array or string) (可选) 排除分类的ID。

默认值: ''

$previous

(boolean) (可选)是否检索之前的文章。

  : true

$taxonomy

(string) (可选) 限定的分类  ,如果 $in_same_term 设置为 true。

默认值: 'category'

get_adjacent_post() 参数

返回值

  • 如果成功,返回文章对 
  • 如果 global $post 没有设置,返回空值Null。
  •  果不 在符合条件  ,返回空字符串。
  • get_adjacent_post() 返回值

    示例

    获取同分类下的上一篇文章。

    获取同分类下的下一篇文章。

    get_adjacent_post() 示例

    注意

    • 使用 global: (object) $post
    • 使用 global: (object) $wpdb

    Filters过滤器

    $adjacent 是 'previous'(上一篇) or 'next'(下一篇)。

    • "get_{$adjacent}_post_join":
      $join, $in_same_cat, $excluded_categories
    • "get_{$adjacent}_post_where":
      $wpdb->prepare("WHERE p.post_date $op %s AND p.post_type = %s AND p.post_status = 'publish' $posts_in_ex_cats_sql", $current_post_date, $post->post_type), $in_same_cat, $excluded_categories
    • "get_{$adjacent}_post_sort":
      "ORDER BY p.post_date $order LIMIT 1"

    get_adjacent_post() 注意

    历史

    添加于 版本: 2.5.0

    get_adjacent_post() 历史

    源文件

    get_adjacent_post() 函数的代码位于 wp-includes/link-template.php.

    get_adjacent_post() 源文件

    相关