函数文档

is_term_publicly_viewable()

💡 云策文档标注

概述

is_term_publicly_viewable() 函数用于判断一个分类法术语是否公开可见。其核心逻辑基于术语所属分类法的可查看性。

关键要点

  • 函数接受一个术语 ID 或 WP_Term 对象作为参数,返回布尔值表示是否公开可见。
  • 内部通过 get_term() 获取术语对象,并调用 is_taxonomy_viewable() 检查其分类法。
  • 如果术语不存在或获取失败,函数返回 false。

代码示例

function is_term_publicly_viewable( $term ) {
    $term = get_term( $term );

    if ( ! $term ) {
        return false;
    }

    return is_taxonomy_viewable( $term->taxonomy );
}

注意事项

  • 该函数自 WordPress 6.1.0 版本引入。
  • 相关函数包括 is_taxonomy_viewable() 和 get_term(),用于内部实现。
  • 在 WP_Terms_List_Table 和 wp_admin_bar_edit_menu() 等场景中被调用。

📄 原文内容

Determines whether a term is publicly viewable.

Description

A term is considered publicly viewable if its taxonomy is viewable.

Parameters

$termint|WP_Termrequired
Term ID or term object.

Return

bool Whether the term is publicly viewable.

Source

function is_term_publicly_viewable( $term ) {
	$term = get_term( $term );

	if ( ! $term ) {
		return false;
	}

	return is_taxonomy_viewable( $term->taxonomy );
}

Changelog

Version Description
6.1.0 Introduced.