WordPress.org

Codex

fr:Marqueurs de Modele/get the category

Page d'accueil du Codex en français - Télécharger WordPress en français
Les utilisateurs francophones se retrouvent sur le site WordPress-Francophone, notamment sur son forum d'entraide.

Contents

Description

Retourne un tableau d'objets, chaque objet correspondant à chacune des catégories auxquelles est associé l'article. Ce marqueur doit être utilisé à l'intérieur de la Boucle.

Utilisation

Cette fonction n'affiche rien du tout ; vous devez accéder aux objets puis récupercuter ou utiliser les différentes données membres.

L'exemple suivant affiche le nom de chaque catégorie à laquelle est affecté l'article (c'est comme utiliser the_category(), mais sans créer de lien vers la catégorie, et en utilisant des espaces au lieu des virgules) :

 <?php 
foreach((get_the_category()) as $cat) { 
echo 
$cat->cat_name ' '
?> 

Exemples

Afficher les Images des Catégories

Cet exemple affiche les images des catégories nommées d'après la données cat_ID avec leur attribut de texte secondaire alt défini à cat_name. Vous pouvez également utiliser n'importe laquelle des autres données membres à la place.

 <?php foreach((get_the_category()) as $cat)
 { echo 
'<img src=\"<nowiki>http://exemple.com/images/</nowiki>' $cat->cat_ID '.jpg\" 
alt=\"' 
$cat->cat_name '\" />'; } ?> 

Affiche Uniquement le Nom de la Première Catégorie

 <?php
$cat 
get_the_category(); $cat $cat[0]; echo $cat->cat_name;
?> 

Données Membres

Voici la liste des données membres contenues dans chaque des objets du tableau retourné par la fonction :

cat_ID 
l'identifiant numérique ID de la catégorie
cat_name 
le nom de la catégorie
category_nicename 
l'identifiant texte (slug) de la catégorie (habituellement généré automatiquement à la création d'après le nom)
category_description 
la description de la catégorie
category_parent 
l'ID du parent la catégorie en cours. '0' s'il n'y a pas de parent.

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