wp_get_post_categories( int $post_id, array $args = array() )

Retourne la liste des catégories pour un poste.

Description

Les résultats de cette fonction ne sont pas mis en cache. Pour plus de performances utilisez une fonction comme get_the_category() pour recevoir les catégories attachées à un poste.

Paramètres

$post_id

(int) (Optionnel) Id du poste. Ne prend pas par défaut l'id de la global $post.

$args

(array) (Optionnel) Paramètre de la requête des catégories. Voir la fonction get_terms() pour les arguments supportés.

  • 'fields'
    (string) Champs de terme à recevoir. Par défaut : 'ids'.

Valeur par défaut : array()

Retourne

(array | WP_Error) Listes de catégories.

Valeurs du champs 'fields' passées par $args :

  • 'all' ou 'all_with_object_id' : tableau d'objets WP_Term.
  • 'ids' : tableau d'ids de catégories.
  • 'names' : tableau de noms de catégories.

WP_Error si la taxonomie 'category' n'existe pas.

Structure de la fonction wp_get_post_categories()

Définie dans le fichier wp-includes/post.php à la ligne 3538 :

function wp_get_post_categories( $post_id = 0, $args = array() ) {
    $post_id = (int) $post_id;

    $defaults = array( 'fields' => 'ids' );
    $args     = wp_parse_args( $args, $defaults );

    $cats = wp_get_object_terms( $post_id, 'category', $args );
    return $cats;
}

Fonctions utilisées par wp_get_post_categories()

wp_parse_args()

Fusionne des arguments définis par l'utilisateur dans un tableau par défaut.

wp_get_object_terms()

Retourne les termes associés aux ids d'objets donnés, en fournissant les taxonomies correspondantes.

Où trouver la fonction wp_get_post_categories() dans le CMS Wordpress

Exemple

$post_categories = wp_get_post_categories( $post_id, array('fields' => 'all') );

Sources

Codex Wordpress : wp_get_post_categories()

Autres fonctions dans le même fichier : wp-includes/post.php

Retour