函数文档

wp_get_split_terms()

💡 云策文档标注

概述

wp_get_split_terms() 函数用于获取已拆分术语的数据,这些术语原本共享一个 term_id,但后来被拆分。它通过查询选项 '_split_terms' 来返回新术语 ID 的数组。

关键要点

  • 函数参数:$old_term_id(整数,必需),表示拆分前的旧术语 ID。
  • 返回值:数组,按分类法(taxonomy)键名索引的新术语 ID。
  • 内部实现:使用 get_option() 获取 '_split_terms' 选项,并检查是否存在对应旧术语 ID 的条目。
  • 相关函数:wp_get_split_term() 用于获取单个拆分术语的新 ID。
  • 引入版本:WordPress 4.2.0。

代码示例

function wp_get_split_terms( $old_term_id ) {
    $split_terms = get_option( '_split_terms', array() );

    $terms = array();
    if ( isset( $split_terms[ $old_term_id ] ) ) {
        $terms = $split_terms[ $old_term_id ];
    }

    return $terms;
}

📄 原文内容

Gets data about terms that previously shared a single term_id, but have since been split.

Parameters

$old_term_idintrequired
Term ID. This is the old, pre-split term ID.

Return

array Array of new term IDs, keyed by taxonomy.

Source

function wp_get_split_terms( $old_term_id ) {
	$split_terms = get_option( '_split_terms', array() );

	$terms = array();
	if ( isset( $split_terms[ $old_term_id ] ) ) {
		$terms = $split_terms[ $old_term_id ];
	}

	return $terms;
}

Changelog

Version Description
4.2.0 Introduced.