get_category_parents( int $category_id, bool $link = false, string $separator = '/', bool $nicename = false )

Retourne les parents d'une catégorie avec séparateurs.

Paramètres

$category_id

(int) (Requis) Id de la catégorie.

$link

(bool) (Optionnel) Pour retourner les parents d'une catégorie sous forme de liens.

Valeur par défaut : false

$separator

(string) (Optionnel) Format du séparateur entre les catégories.

Valeur par défaut : '/'

$nicename

(bool) (Optionnel) Si true, affiche les slugs des parents d'une catégorie. Par défaut, affiche les noms.

Valeur par défaut : false

Retourne

(string | WP_Error) Une liste des parents d'une catégorie, WP_Error si échec.

Structure de la fonction get_category_parents()

Définie dans le fichier wp-includes/category-template.php à la ligne 47 :

function get_category_parents( $category_id, $link = false, $separator = '/', $nicename = false, $deprecated = array() ) {

    if ( ! empty( $deprecated ) ) {
        _deprecated_argument( __FUNCTION__, '4.8.0' );
    }

    $format = $nicename ? 'slug' : 'name';

    $args = array(
        'separator' => $separator,
        'link'      => $link,
        'format'    => $format,
    );

    return get_term_parents_list( $category_id, 'category', $args );
}

Fonctions utilisées par get_category_parents()

get_term_parents_list()

Retourne les parents d'un terme avec séparateur.

_deprecated_argument()

Marque l'argument d'une fonction comme déprécié et informe quand il a été utilisé.

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

Exemple

Affiche les parents de la catégorie actuelle :
echo get_category_parents( $cat, true, ' » ' );

// Affichera :
Internet » Blogging » WordPress »

Sources

Codex Wordpress : get_category_parents()

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

Retour