掌握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中文網其他相關文章！