当前浏览:首页 / WordPress函数 / is_home()

is_home()

是否为博客主页

home

is 条件判断more...


描述

博客主页是显示网站基于时间的博客内容的页面。

is_home()的判定取决于网站的 "您的主页显示"(设置>阅读)的设置:‘show_on_front’和‘page_for_posts’。

如果网站首页设置为“一个静态页面”,则此函数将仅在“文章页”所选定的页面上返回true。

更多类似的主题函数信息,请查看主题开发手册中的条件标签文章。

另见


返回

(bool) 该查询(query)是否针对博客主页。


说明

历史

自WordPress 2.1引入静态首页功能以来,博客文章索引和网站首页被视为两种不同的查询上下文,is_home()应用于博客文章索引,is_front_page()应用于网站首页。

用法

注意不要混淆这两个查询条件:

  • 在网站首页上,is_front_page() 始终返回 true,无论网站首页显示的是博客文章索引还是静态页面。
  • 在博客文章索引页上,is_home() 始终返回 true,无论文章索引是显示在网站首页上还是在单独页面。

is_home()is_front_page()返回truefalse取决于某些选项值的值:

  • get_option( 'show_on_front' ): 返回 'posts''page'
  • get_option( 'page_on_front' ): 返回静态首页指定的页面(page) ID
  • get_option( 'page_for_posts' ): 返回静态首页指定的文章页(posts page) ID

使用这些查询条件时:

  • 如果 'posts' == get_option( 'show_on_front' ):
    • 在网站首页上:
      • is_front_page() 返回 true
      • is_home() 返回 true
    • WordPress会忽略指定(如果有)用于显示网站首页或博客文章索引的页面
  • 如果 'page' == get_option( 'show_on_front' ):
    • 在指定用于显示网站首页的页面上:
      • is_front_page() 返回 true
      • is_home() 返回 false
    • 在指定用于显示文章索引的页面上:
      • is_front_page() 返回 false
      • is_home() 返回 true

注意

is_home()使用全局WP_Query对象:$wp_queryis_home()‘parse_query’动作之前不可用。



源码

查看源码 官方文档


更新日志

版本描述
1.5.0开始引入

用户贡献的笔记

  • 贡献者:znowebdev

    下面的示例可以在侧边栏中使用,以便在显示博客文章索引时显示不同的内容。

    if ( is_home() ) {
        // This is the blog posts index
        get_sidebar( 'blog' );
    } else {
        // This is not the blog posts index
        get_sidebar();
    }