描述
博客主页是显示网站基于时间的博客内容的页面。
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()返回true或false取决于某些选项值的值：
get_option( 'show_on_front' ): 返回'posts'或'page'get_option( 'page_on_front' ): 返回静态首页指定的页面(page)IDget_option( 'page_for_posts' ): 返回静态首页指定的文章页(posts page)ID
使用这些查询条件时：
- 如果
'posts' == get_option( 'show_on_front' ):- 在网站首页上：
is_front_page()返回trueis_home()返回true
- WordPress会忽略指定（如果有）用于显示网站首页或博客文章索引的页面
- 在网站首页上：
- 如果
'page' == get_option( 'show_on_front' ):- 在指定用于显示网站首页的页面上：
is_front_page()返回trueis_home()返回false
- 在指定用于显示文章索引的页面上：
is_front_page()返回falseis_home()返回true
- 在指定用于显示网站首页的页面上：
注意
is_home()使用全局WP_Query对象：$wp_query。is_home()在‘parse_query’动作之前不可用。
源码
更新日志
| 版本 | 描述 |
|---|---|
| 1.5.0 | 开始引入 |
使用示例
下面的示例可以在侧边栏中使用，以便在显示博客文章索引时显示不同的内容。
if ( is_home() ) { // This is the blog posts index get_sidebar( 'blog' ); } else { // This is not the blog posts index get_sidebar(); }