掌握WordPress类别API

深入WordPress分类目录API：高效获取和管理分类数据

本文将深入探讨WordPress分类目录API，讲解如何高效地获取和管理分类数据。我们将介绍核心函数，并展示如何获取单个分类、多个分类以及特定信息，例如分类ID、名称、描述、slug和关联文章数量。 我们还将简要介绍WordPress REST API中与分类相关的操作。

核心概念

WordPress分类目录API提供一系列函数，用于检索分类的原始数据，包括返回包含所有分类相关数据的对象。

获取单个分类对象

get_category() 函数允许通过ID获取单个分类对象。

$cat = get_category(14);

该对象包含多个属性，例如：

• cat_ID: 分类ID
• cat_name: 分类名称
• category_description: 分类描述
• category_nicename 或 slug: 分类slug
• category_parent: 父级分类ID (无父级则为0)
• category_count: 分类下文章数量

您可以根据需要访问这些属性：

<h1><?php echo $cat->cat_name; ?></h1>
<p><?php echo $cat->category_description; ?></p>

get_category() 函数还支持返回关联数组或数字索引数组：

// 对象 (默认)
$cat = get_category(15, OBJECT);

// 关联数组
$cat = get_category(15, ARRAY_A);

// 数字索引数组
$cat = get_category(15, ARRAY_N);

通过slug获取分类

get_category_by_slug() 函数允许通过slug获取分类对象。

$cat = get_category_by_slug('my-goldfish');

此函数仅返回对象，不支持数组形式。

获取多个分类

get_categories() 函数返回一个包含所有分类的数组，每个元素都是一个分类对象。 您可以通过参数自定义返回结果，例如：

• orderby: 排序方式
• order: 排序顺序
• number: 返回数量限制
• hide_empty: 是否包含空分类
• include: 指定包含的分类ID
• exclude: 指定排除的分类ID
• hierarchical: 是否按层级结构返回
• pad_counts: 是否填充计数
• child_of: 指定父级分类ID
• parent: 指定父级分类ID，仅返回直接子分类

例如，获取所有非空分类并按名称排序：

$cats = get_categories( array( 'hide_empty' => false, 'orderby' => 'name' ) );

获取与文章关联的分类

get_the_category() 函数返回一个数组，包含与指定文章关联的所有分类对象。 默认情况下，它返回当前文章的分类；您可以通过传入文章ID来指定文章。

获取特定信息

一些函数用于获取特定信息，例如：

• get_cat_ID($categoryName): 通过名称获取分类ID
• get_ancestors($categoryId, 'category'): 获取分类的所有祖先ID
• get_cat_name($categoryId): 通过ID获取分类名称
• category_description($categoryId): 通过ID获取分类描述
• get_category_link($categoryId): 获取分类链接

使用the_category() 和 get_the_category_list() 显示分类列表

the_category() 函数直接输出当前文章的分类列表，get_the_category_list() 函数则返回分类列表字符串，方便自定义输出。

WordPress REST API中的分类操作

WordPress REST API也提供对分类的管理功能：

• /wp/v2/categories: 获取所有分类列表
• /wp/v2/categories/<id></id>: 获取指定分类信息，更新分类信息或删除分类
• /wp/v2/posts: 获取指定分类下的文章列表 (使用 categories 参数)

通过灵活运用这些函数，您可以高效地获取和管理WordPress分类数据，并将其整合到您的主题或插件中。 记住查阅WordPress Codex 获取更详细的信息和参数说明。

以上是掌握WordPress类别API的详细内容。更多信息请关注PHP中文网其他相关文章！