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

is_singular( string|string[] $post_types = '' )

是否为现有任意文章类型(文章、附件、页面、自定义文章类型)的单页

is 条件判断more...


描述

如果指定了$post_types参数,此函数将另外检查查询是否针对指定的文章类型之一。

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

另见


参数

$post_types

(string|string[]) (可选) 要检查的文章类型或文章类型数组。

默认值: ''


返回

(bool) 查询是否针对现有的单页文章或给定任意文章类型的单页文章。



源码

查看源码 官方文档


更新日志

版本描述
1.5.0开始引入

使用示例

  • 示例1

    默认文章类型

    查看常规文章时为True。

    is_singular( 'post' );
    
  • 示例2

    自定义帖子类型

    当以下任一项返回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' ) );
    
  • 示例3

    单个页面中的不同边栏广告

    if ( is_singular() ) {
      // show adv. #1
    } else {
      // show adv. #2
    }
    
  • 示例4

    在自定义函数中使用钩子

    您可以在自定义函数中使用条件标签,并在函数文件中使用WordPress或主题特定的钩子。

    add_action( 'loop_start', 'your_function' );
    function your_function() {
    if ( is_singular() ) {
    echo 'Hello World';
        }
    }
    
  • 示例5

    在主页中:

    is_singular()

    is_page()

    如果您使用静态页面作为主页(阅读设置),则返回true
    他们将在博客页面中返回false
    在WP v5.7.2中已注意到这一点

  • 示例6

    要测试单个文章:

    if ( is_singular( 'post' ) ) {
        //your code here...
    }