描述
如果指定了$post_types参数,此函数将另外检查查询是否针对指定的文章类型之一。
更多类似的主题函数信息,请查看主题开发手册中的条件标签文章。
另见
参数
- $post_types
-
(string|string[]) (可选) 要检查的文章类型或文章类型数组。
默认值: ''
返回
(bool) 查询是否针对现有的单页文章或给定任意文章类型的单页文章。
源码
更新日志
版本 | 描述 |
---|---|
1.5.0 | 开始引入 |
使用示例
默认文章类型
查看常规文章时为True。
is_singular( 'post' );
自定义帖子类型
当以下任一项返回true时:is_single()、is_page() 或 is_attachment().
is_singular();
True when viewing a post of the Custom Post Type book.
查看自定义文章类型 book 的文章时为True。
is_singular( 'book' );
查看自定义文章类型 newspaper 或 book 的文章时为True。
is_singular( array( 'newspaper', 'book' ) );
单个页面中的不同边栏广告
if ( is_singular() ) { // show adv. #1 } else { // show adv. #2 }
在自定义函数中使用钩子
您可以在自定义函数中使用条件标签,并在函数文件中使用WordPress或主题特定的钩子。
add_action( 'loop_start', 'your_function' ); function your_function() { if ( is_singular() ) { echo 'Hello World'; } }
在主页中:
is_singular()
和
is_page()
如果您使用静态页面作为主页(阅读设置),则返回true
他们将在博客页面中返回false
在WP v5.7.2中已注意到这一点要测试单个文章:
if ( is_singular( 'post' ) ) { //your code here... }