描述
获取毗连的文章。
可以是前一篇或后一篇。
使用
<?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
.