This page redirects to an external site: https://developer.wordpress.org/reference/functions/the_category/

Description

Affiche un lien vers la ou les catégories auxquelles appartient l'article. Ce marqueur doit être utilisé à l'intérieur de la Boucle.

Utilisation

 <?php the_category('separator', 'parents' ); ?> 

Exemples

Utilisation par Défaut

L'utilisation par défaut affiche la liste des catégories sans autre séparateur qu'un espace.

<p>Catégories: <?php the_category(); ?></p>

Séparés par une Virgule

Affiche les liens vers les catégories, chaque catégorie étant séparée par une virgule (si plus d'une).

 <p>Cet article est référencé dans : <?php the_category(', '); ?></p> 

Séparés par une Flèche

Présente les liens vers les catégories avec une flèche (>) pour les séparer.

(Note: Faites attention en utilisant cette commande, il arrive que certains utilisateurs interprètent la catégorie suivant la flèche comme une sous-catégorie de la précédente.)

 <p>Catégories: <?php the_category(' &amp;gt; '); ?></p> 

Sépararés par une Bulle

Affiche les liens vers les catégories avec une bulle (•) pour les séparer.

 <p>Catégories de l'Article : <?php the_category(' &amp;bull; '); ?></p> 

Paramètres

separator 

(chaîne) Texte ou caractère à afficher entre chaque lien de catégorie. La valeur par défault est un espace.

parents 

(chaîne) Méthode d'affichage des liens en rapport avec des catégories enfants (sous-catégories). Les options sont :

• 'multiple' - Affiche des liens séparés vers les catégories parentes et enfants, mettant en évidence la relation "parent/enfant".
• 'single' - Affiche un lien vers la catégorie enfant uniquement, avec le texte du lien mettant en évidence la relation "parent/enfant".

Note: Le comportement par défaut (si le paramètre est omis), est d'afficher un lien vers la catégorie enfant, sans mise en évidence de la relation "parent/enfant".

En relation

the_category, the_category_rss, the_category_ID (Obsolète), the_category_head (Obsolète), single_cat_title, category_description, dropdown_cats (Obsolète), list_cats, wp_list_cats, in_category, get_category_parents, get_the_category

Retour à la Liste des Marqueurs