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.

Déclaration et structure de la fonction get_category_parents()

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 );
}
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ù est utilisée 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