云策 WordPress 开发者社区

函数文档

get_category_to_edit()

查看官方原文 ↗
💡 云策文档标注

概述

get_category_to_edit() 函数用于根据给定 ID 获取分类对象，并在 'edit' 过滤器上下文中处理。它内部调用 get_term() 并应用 _make_cat_compat() 来兼容旧版结构。

关键要点

  • 函数接受一个必需的整数参数 $id，表示分类的 ID
  • 返回一个对象，包含分类数据，适用于编辑操作
  • 内部使用 get_term() 从数据库获取分类数据，并指定 'edit' 上下文
  • 调用 _make_cat_compat() 将分类结构从新版分类法转换为旧版（pre-2.3）兼容格式

代码示例

function get_category_to_edit( $id ) {
    $category = get_term( $id, 'category', OBJECT, 'edit' );
    _make_cat_compat( $category );
    return $category;
}

注意事项

  • 此函数自 WordPress 2.0.0 版本引入，主要用于后台编辑界面
  • 相关函数包括 _make_cat_compat() 和 get_term()，用于数据转换和获取
📄 原文内容

Gets category object for given ID and ‘edit’ filter context.

Parameters

$idintrequired

Return

object

Source

function get_category_to_edit( $id ) {
	$category = get_term( $id, 'category', OBJECT, 'edit' );
	_make_cat_compat( $category );
	return $category;
}

View all references View on Trac View on GitHub

Uses Description
_make_cat_compat()wp-includes/category.php

Updates category structure to old pre-2.3 from new taxonomy structure.
get_term()wp-includes/taxonomy.php

Gets all term data from database by term ID.

Changelog

Version Description
2.0.0 Introduced.