is_taxonomy_viewable()
云策文档标注
概述
is_taxonomy_viewable() 函数用于判断一个分类法是否被视为“可查看”。它基于分类法的 publicly_queryable 属性返回布尔值。
关键要点
- 参数 $taxonomy 可以是字符串(分类法名称)或 WP_Taxonomy 对象,必需提供。
- 返回值是布尔类型,表示分类法是否可查看。
- 内部实现:如果参数是标量,则通过 get_taxonomy() 获取分类法对象;如果对象不存在,返回 false;否则返回 $taxonomy->publicly_queryable。
- 相关函数包括 get_taxonomy()、is_term_publicly_viewable() 和 build_query_vars_from_query_block()。
- 该函数自 WordPress 5.1.0 版本引入。
代码示例
function is_taxonomy_viewable( $taxonomy ) {
if ( is_scalar( $taxonomy ) ) {
$taxonomy = get_taxonomy( $taxonomy );
if ( ! $taxonomy ) {
return false;
}
}
return $taxonomy->publicly_queryable;
}
原文内容
Determines whether a taxonomy is considered “viewable”.
Parameters
$taxonomystring|WP_Taxonomyrequired-
Taxonomy name or object.
Source
function is_taxonomy_viewable( $taxonomy ) {
if ( is_scalar( $taxonomy ) ) {
$taxonomy = get_taxonomy( $taxonomy );
if ( ! $taxonomy ) {
return false;
}
}
return $taxonomy->publicly_queryable;
}
Changelog
| Version | Description |
|---|---|
| 5.1.0 | Introduced. |