Maîtriser l'API des catégories WordPress

API de répertoire de classification WordPress approfondi: obtenir et gérer efficacement les données classifiées

Cet article explorera en profondeur l'API du répertoire de classification WordPress et expliquera comment obtenir et gérer efficacement les données classifiées. Nous présenterons les fonctions principales et montrerons comment obtenir une seule catégorie, plusieurs catégories et des informations spécifiques telles que l'ID de catégorie, le nom, la description, la limace et le nombre d'articles associés. Nous présenterons également brièvement les opérations liées à la classification dans l'API WordPress REST.

Concepts de base

L'API du catalogue de classification WordPress fournit une série de fonctions pour récupérer les données d'origine d'une classification, y compris des objets de retour contenant toutes les données liées à la classification.

Obtenez un seul objet de classification

La fonction

get_category() permet d'obtenir un seul objet de classification par id.

$cat = get_category(14);

Cet objet contient plusieurs propriétés, telles que:

• cat_ID: ID de classification
• cat_name: Nom de classification
• category_description: Description de la classification
• category_nicename ou slug: Catégorie Slug
• category_parent: ID de classe parent (aucune classe parent est 0)
• category_count: nombre d'articles dans la catégorie

Vous pouvez accéder à ces propriétés selon les besoins:

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

get_category() Les fonctions prennent également en charge les tableaux associatifs renvoyés ou les tableaux d'index numériques:

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

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

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

Obtenez des catégories via Slug

La fonction

get_category_by_slug() permet l'obtention d'objets de classification via Slug.

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

Cette fonction renvoie uniquement les objets et ne prend pas en charge le formulaire de tableau.

Obtenez plusieurs catégories

La fonction

get_categories() renvoie un tableau contenant toutes les catégories, chaque élément étant un objet de classification. Vous pouvez personnaliser le résultat de retour via les paramètres, par exemple:

• orderby: Trier par
• order: Tri Order
• number: limite de quantité de retour
• hide_empty: inclut-il la classification vide?
• include: Spécifiez l'ID de classification inclus
• exclude: Spécifiez l'ID de classification exclu
• hierarchical: s'il faut revenir à
selon la structure de la hiérarchie
• pad_counts: s'il faut remplir le nombre
• child_of: Spécifiez l'ID de classification des parents
• parent: Spécifiez l'ID de classification des parents et renvoyez uniquement la classification directe de l'enfant

Par exemple, obtenez toutes les catégories non vides et triez par nom:

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

Obtenez les catégories associées à l'article

La fonction

get_the_category() Renvoie un tableau contenant tous les objets de classification associés à l'article spécifié. Par défaut, il renvoie la catégorie de l'article actuel; vous pouvez spécifier l'article en passant dans l'ID de l'article.

obtenir des informations spécifiques

Certaines fonctions sont utilisées pour obtenir des informations spécifiques, telles que:

• get_cat_ID($categoryName): Obtenez l'ID de catégorie par nom
• get_ancestors($categoryId, 'category'): Obtenez tous les ID d'ancêtre dans la catégorie
• get_cat_name($categoryId): Obtenez le nom de catégorie via id
• category_description($categoryId): Obtenez la description de la classification par id
• get_category_link($categoryId): Obtenez le lien de catégorie

Utiliser the_category() et get_the_category_list() pour afficher la liste des catégories

La fonction

the_category() sortit directement la liste de classification de l'article actuel, tandis que la fonction get_the_category_list() renvoie la chaîne de liste de classification pour une sortie personnalisée pratique.

Opérations de classification dans API WordPress REST

L'API WordPress REST fournit également des fonctions de gestion pour la classification:

• /wp/v2/categories: Obtenez toutes les catégories Liste
• /wp/v2/categories/<id></id>: obtenir les informations de classification spécifiées, mettre à jour les informations de classification ou supprimer la classification
• /wp/v2/posts: Obtenez la liste des articles dans la catégorie spécifiée (en utilisant les paramètres categories)

En utilisant de manière flexible ces fonctions, vous pouvez obtenir et gérer efficacement les données de classification WordPress et les intégrer dans votre thème ou votre plug-in. N'oubliez pas de consulter WordPress Codex pour des informations plus détaillées et des descriptions de paramètres.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!