WordPress 参考函数：get_adjacent_post

Posted on by

描述

获取毗连的文章。
可以是前一篇或后一篇。

使用

<?php get_adjacent_post( $in_same_cat, $excluded_categories, $previous ) ?>

 参数

$in_same_cat （布尔型）（可选的）文章是否在相同的分类。 默认：false。

$excluded_categories （字符串）（可选的）剔除分类的ID。默认：‘’

$previous （布尔型）（可选的）是否返回上一篇文章。默认：true

返回值

  • 如果没有错误，返回文章对象。
  • 如果全局变量 $post 没有设置，返回值是 Null。
  • 如果不存在相匹配的文章，返回空字符串。

注释

  • 使用全局变量：（对象）$post
  • 使用全局变量：（对象）$wpdb

Filters

$adjacent 是 ‘previous’ 或者 ‘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"

变更日志

2.5.0 起

源码文件

get_adjacent_post()在 wp-includes/link-template.php.