is_singular() | WordPress判断当前页面是否为指定文章类型页面

函数

is_singular( string|array $post_types = '' )

函数

WordPress 主题或插件开发过程中经常会用到页面判断函数，如判断当前页面是否是文章内容页的函数 is_single()、判断是否是单页面的函数 is_page()，如果是判断当前页面是文章或单页面时就要结合两个函数一起使用。而 is_singular() 则是这两个函数的升级版，通过这一个函数即可以实现前面所述的判断，并且支持附件、自定义文章类型的判断。

参数

$post_types – 字符串或数组（string|array），文章类型的一个数组，可以是 page、post、attachment 或 custom post types，默认值为空。

返回值

如果结果是要判断的页面则返回 true，否则返回 false。

例子

判断当前页面是否是文章内容页

if(is_singular('post')){
	echo '这是文章post页面';
}

判断当前页面是否是文章内容页或单页面

if(is_singular(array('post','page')){
	echo '这是文章内容页或单页面';
}

位置

函数位于：wp-includes/query.php