函数文档

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.

Return

bool Whether the taxonomy should be considered viewable.

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.