Mastering the WordPress Categories API

In-depth WordPress classification directory API: Efficiently obtain and manage classified data

This article will explore the WordPress classification directory API in depth and explain how to efficiently obtain and manage classified data. We will introduce the core functions and show how to obtain a single category, multiple categories, and specific information such as category ID, name, description, slug, and number of associated articles. We will also briefly introduce classification-related operations in the WordPress REST API.

Core Concepts

The WordPress Classification Catalog API provides a series of functions to retrieve the original data of a classification, including returning objects containing all classification-related data.

Get a single classification object

The

get_category() function allows to obtain a single classification object by ID.

$cat = get_category(14);

This object contains multiple properties, such as:

• cat_ID: Classification ID
• cat_name: Classification name
• category_description: Classification Description
• category_nicename or slug: Category slug
• category_parent: Parent class ID (no parent class is 0)
• category_count: Number of articles under category

You can access these properties as needed:

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

get_category() Functions also support returning associative arrays or numeric index arrays:

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

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

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

Get categories through slug

The

get_category_by_slug() function allows the obtaining of classification objects through slug.

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

This function only returns objects and does not support array form.

Get multiple categories

The

get_categories() function returns an array containing all categories, each element being a classification object. You can customize the return result through parameters, for example:

• orderby: Sort by
• order: Sort order
• number: Return quantity limit
• hide_empty: Does it include empty classification?
• include: Specify the included classification ID
• exclude: Specify the excluded classification ID
• hierarchical: Whether to return to
according to hierarchy structure
• pad_counts: Whether to fill count
• child_of: Specify parent classification ID
• parent: Specify the parent classification ID, and only return the direct child classification

For example, get all non-empty categories and sort by name:

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

Get the categories associated with the article

The

get_the_category() function returns an array containing all classification objects associated with the specified article. By default, it returns the current article's category; you can specify the article by passing in the article ID.

Get specific information

Some functions are used to obtain specific information, such as:

• get_cat_ID($categoryName): Get the category ID by name
• get_ancestors($categoryId, 'category'): Get all ancestor IDs in the category
• get_cat_name($categoryId): Get the category name through ID
• category_description($categoryId): Get the classification description by ID
• get_category_link($categoryId): Get the category link

Use the_category() and get_the_category_list() to display the category list

The

the_category() function directly outputs the classification list of the current article, while the get_the_category_list() function returns the classification list string for convenient custom output.

Classification operations in WordPress REST API

The WordPress REST API also provides management functions for classification:

• /wp/v2/categories: Get all categories list
• /wp/v2/categories/<id></id>: Get the specified classification information, update the classification information or delete the classification
• /wp/v2/posts: Get the list of articles under the specified category (using the categories parameters)

By flexibly using these functions, you can efficiently obtain and manage WordPress classification data and integrate it into your theme or plug-in. Remember to consult WordPress Codex for more detailed information and parameter descriptions.

The above is the detailed content of Mastering the WordPress Categories API. For more information, please follow other related articles on the PHP Chinese website!