欢迎光临
我们一直在努力

WordPress函数:get_adjacent_post(获取相邻文章)

建站超值云服务器,限时71元/月

本文目录
[隐藏]

  • 1Description【描述】
  • 2Usage【用法】
  • 3Parameters【参数】
  • 4Return Values【返回值】
  • 5Examples【例子】
    • 5.1Notes【注释】
    • 5.2Filters【过滤器】
  • 6Change Log【更改记录】
  • 7Source File【源文件】

Description【描述】

Retrieve adjacent post.【检索相邻的文章】

Can either be next or previous post.【可以是上一篇或下一篇】

Usage【用法】

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

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

Parameters【参数】

$in_same_cat
(
boolean) (
optional) Whether post should be in same category.【(布尔值)(可选)文章是否在同一分类】

Default: false【默认:false】
$excluded_categories
(
string) (
optional) Excluded categories IDs.【(字符串)(可选)排除分类的ID】

Default: ”【默认:”】
$previous
(
boolean) (
optional) Whether to retrieve previous post.【(布尔值)(可选)是否检索之前的文章】

Default: true【默认:true】

Return Values【返回值】

  • Post object if successful. 【如果成功,返回文章对象】
  • Null if global $post is not set. 【如果全局的 $post 没有设置,返回空值】
  • Empty string if no corresponding post exists. 【如果不存在符合条件的文章,返回空字符串】

Examples【例子】

Notes【注释】

  • Uses global: (object) $post 【使用全局:(对象)$post】
  • Uses global: (object) $wpdb 【使用全局:(对象)$wpdb】

Filters【过滤器】

$adjacent is either ‘previous’ or ‘next’.【$adjacent 是“上一篇”或“下一篇”】

  • “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”

Change Log【更改记录】

Since: 2.5.0 【从 2.5.0 开始】

Source File【源文件】

get_adjacent_post() is located in wp-includes/link-template.php.【get_adjacent_post()函数在wp-includes/link-template.php 文件中】

赞(0)
版权申明:本站文章部分自网络,如有侵权,请联系:west999com@outlook.com 特别注意:本站所有转载文章言论不代表本站观点! 本站所提供的图片等素材,版权归原作者所有,如需使用,请与原作者联系。未经允许不得转载:IDC资讯中心 » WordPress函数:get_adjacent_post(获取相邻文章)
分享到: 更多 (0)