深入WordPress分類目錄API：高效獲取和管理分類數(shù)據(jù)

本文將深入探討WordPress分類目錄API，講解如何高效地獲取和管理分類數(shù)據(jù)。我們將介紹核心函數(shù)，並展示如何獲取單個分類、多個分類以及特定信息，例如分類ID、名稱、描述、slug和關(guān)聯(lián)文章數(shù)量。 我們還將簡要介紹WordPress REST API中與分類相關(guān)的操作。

核心概念

WordPress分類目錄API提供一系列函數(shù)，用於檢索分類的原始數(shù)據(jù)，包括返回包含所有分類相關(guān)數(shù)據(jù)的對象。

獲取單個分類對象

get_category() 函數(shù)允許通過ID獲取單個分類對象。

$cat = get_category(14);

該對象包含多個屬性，例如：

• cat_ID: 分類ID
• cat_name: 分類名稱
• category_description: 分類描述
• category_nicename 或 slug: 分類slug
• category_parent: 父級分類ID (無父級則為0)
• category_count: 分類下文章數(shù)量

您可以根據(jù)需要訪問這些屬性：

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

get_category() 函數(shù)還支持返回關(guān)聯(lián)數(shù)組或數(shù)字索引數(shù)組：

// 對象 (默認(rèn))
$cat = get_category(15, OBJECT);

// 關(guān)聯(lián)數(shù)組
$cat = get_category(15, ARRAY_A);

// 數(shù)字索引數(shù)組
$cat = get_category(15, ARRAY_N);

通過slug獲取分類

get_category_by_slug() 函數(shù)允許通過slug獲取分類對象。

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

此函數(shù)僅返回對象，不支持?jǐn)?shù)組形式。

獲取多個分類

get_categories() 函數(shù)返回一個包含所有分類的數(shù)組，每個元素都是一個分類對象。 您可以通過參數(shù)自定義返回結(jié)果，例如：

• orderby: 排序方式
• order: 排序順序
• number: 返回數(shù)量限制
• hide_empty: 是否包含空分類
• include: 指定包含的分類ID
• exclude: 指定排除的分類ID
• hierarchical: 是否按層級結(jié)構(gòu)返回
• pad_counts: 是否填充計數(shù)
• child_of: 指定父級分類ID
• parent: 指定父級分類ID，僅返回直接子分類

例如，獲取所有非空分類並按名稱排序：

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

獲取與文章關(guān)聯(lián)的分類

get_the_category() 函數(shù)返回一個數(shù)組，包含與指定文章關(guān)聯(lián)的所有分類對象。 默認(rèn)情況下，它返回當(dāng)前文章的分類；您可以通過傳入文章ID來指定文章。

獲取特定信息

一些函數(shù)用於獲取特定信息，例如：

• 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() 函數(shù)直接輸出當(dāng)前文章的分類列表，get_the_category_list() 函數(shù)則返回分類列表字符串，方便自定義輸出。

WordPress REST API中的分類操作

WordPress REST API也提供對分類的管理功能：

• /wp/v2/categories: 獲取所有分類列表
• /wp/v2/categories/<id></id>: 獲取指定分類信息，更新分類信息或刪除分類
• /wp/v2/posts: 獲取指定分類下的文章列表 (使用 categories 參數(shù))

通過靈活運用這些函數(shù)，您可以高效地獲取和管理WordPress分類數(shù)據(jù)，並將其整合到您的主題或插件中。 記住查閱WordPress Codex 獲取更詳細(xì)的信息和參數(shù)說明。

以上是掌握WordPress類別API的詳細(xì)內(nèi)容。更多資訊請關(guān)注PHP中文網(wǎng)其他相關(guān)文章！