Codex

Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

User:MissLeili/wp list categories

Description

Le Marqueur de Modèle wp_list_categories(anglais), affiche une liste de Categories(anglais) en tant que liens. Quand un lien vers une catégorie est cliqué, tous les posts de cette Catégorie s'afficheront dans une Page Catégorie utilisant le Modèle de Catégorie(anglais) décrit dans les Règles de Hiérarchie des modèles.

wp_list_categories(anglais) fonctionne de la même manière que les deux Marqueurs de Modèle des versions de WordPress antérieures à la version 2.1 que sont : list_cats()(anglais) (obsolète), et wp_list_cats()(anglais) (obsolète).

Utilisation

 <?php wp_list_categories('arguments'); ?> 

Exemples

Utilisation par Défaut

$defaults = array('show_option_all' => '', 'orderby' => 'name', 'order' => 'ASC', 
'show_last_update' => 0, 'style' => 'list','show_count' => 0, 'hide_empty' => 1, 
'use_desc_for_title' => 1, 'child_of' => 0, 'feed' => '', 'feed_image' => '', 
'exclude' => '', 'hierarchical' => true, 'title_li' => __('Categories'));

By default, the usage shows:

  • No link to all categories
  • Sorts the list of Caegories in by the Category name in ascending order
  • Does not show the last update (last updated post in each Category)
  • Displayed in an unordered list style
  • Does not show the post count
  • Displays only Categories with posts
  • Sets the title attribute to the Category Description
  • Is not restricted to the child_of any Category
  • No feed or feed image used
  • Does not exlude any Category and includes all Categories ('include' => is not shown above)
  • Shows the Categories in hierarchical indented fashion
  • Display Category as the heading over the list
  • No SQL LIMIT is imposed ('number' => 0 is not shown above)
wp_list_categories();

Inclure ou Exclure des Catégories

Pour créer une liste classée par ordre alphabétique incluant seulement les Catégories dont les IDs sont 3, 5, 9 et 16, vous utiliserez, par exemple, le code suivant :

<ul>
<?php
wp_list_categories('orderby=name&include=3,5,9,16'); ?>
</ul>

L'exemple suivant affiche les catégories ordonnées par nom, montre le nombre de posts contenu dans chaque Catégorie, et exclue de la liste la Catégorie dont l'ID est 10.

<ul>
<?php
wp_list_categories('orderby=name&show_count=1&exclude=10'); ?>
</ul>

Afficher ou Cacher un Titre de Liste

Le paramètre title_li permet de définir ou de masquer un titre pour la liste de Catégories générée par wp_list_categories. Par défaut, le paramètre est définit par '(__('Categories')', c'est-à-dire que le mot "Catégories" s'affiche comme titre de la liste. Aucun titre ne s'affiche si le paramètre est définit par une valeur vide ou nulle.

L'exemple de code suivant exclue les Catégories dont les IDs sont 4 ou 7 et masque le titre de la liste :

<ul>
<?php
wp_list_categories('exclude=4,7&title_li='); ?>
</ul>

Dans l'exemple suivant, seules les Catégories dont les IDs sont 9, 5 et 23 sont inclues et on a changé le titre de la liste pour le mot "Prose" stylisé avec une balise de titre <h2> :

<ul>
<?php
wp_list_categories('include=5,9,23&title_li=<h2>' . __('Prose') . '</h2>' ); ?>
</ul>

Afficher seulement les Sous-Catégories d'une Catégorie

L'exemple de code suivant affiche les Sous-Catégories (ou 'Catégories Filles') de la 'Catégorie Mère' dont l'ID est 8, ordonnées par ID. Le nombre de posts de chaque Catégorie est visible, et l'attribut title des liens générés n'est pas renseigné par les Descriptions des Catégories.

Note: Si la 'Catégorie Mère' ne contient pas de post, elle ne s'affichera pas dans la liste.

<ul>
<?php wp_list_categories('orderby=id&show_count=1
&use_desc_for_title=0&child_of=8'); ?>
</ul>

Afficher les Catégories avec un lien RSS

L'exemple suivant génère une liste ordonnée par nom des Catégories, montre le nombre de posts par Catégorie, et fournit les liens vers les flux RSS de chaque Catégorie.

<ul>
<?php
wp_list_categories('orderby=name&show_count=1&feed=RSS'); ?>
</ul>

Si vous souhaitez remplacer les liens vers les flux RSS par des images RSS, écrivez par exemple :

<ul>
<?php
wp_list_categories('orderby=name&show_count=1
&feed_image=/images/rss.gif'); ?>
</ul>

Marquage et Style des Listes de Catégories

Par défaut, wp_list_categories() génère des éléments de liste <li> d'une liste non-ordonnée <ul>. Tous les éléments de la liste générée par wp_list_categories() sont marquée par la classe "page_item". Quand wp_list_categories() est appelée dans une Page 'Catégorie', l'élément de la liste qui désigne cette page en question sera marqué par une classe supplémentaire "current_page_item":

<ul>
   <li class="page_item current_page_item">
     [the current page]
   </li>
   <li class="page_item">
     [another page]
   </li>
</ul>

Ce qui pourra visuellement donner, par exemple, quand on se situe sur la Page Informatique :

Catégories:

Vous pouvez définir le style de ces classes dans une feuille de style CSS(anglais) :

 .page_item { ... }
 .current_page_item { ... }

Note : Les éléments de la liste générée par wp_list_categories (sauf si le paramètre style est définit par none) nécessite l'ouverture et la fermeture d'une balise <ul>. Voir les exemples ci-dessus.


Paramètres

show_option_all 
(string) A non-blank values causes the display of a link to all categories if the style is set to list. The default value is not to display a link to all.
orderby 
(string) Définit le critère de classement des Catégories (alphabétique par nom de Catégorie ou par ID unique de Catégorie ou par nombre de posts contenus dans les Catégories). Le classement est par défaut alphabétique sur le nom des Catégories. Valeurs possibles :
  • ID
  • name - défaut
  • count
order 
(string) Définit l'ordre de classement des Catégories (ascendant ou descendant). The default is ascending. Valid values:
  • ASC - défaut
  • DESC
show_last_updated 
(boolean) Should the last updated timestamp for posts be displayed (TRUE) or not (FALSE). Defaults to FALSE.
* 1 (true)
* 0 (false) - défaut
style 
(string) Style to display the categories list in. A value of list displays the categories as list items while none generates no special display method (the list items are separated by <br> tags). The default setting is list (creates list items for an unordered list). See the markup section for more. Valid values:
  • list - défaut
  • none
show_count 
(boolean) Toggles the display of the current count of posts in each category. The default is false (do not show post counts). Valid values:
  • 1 (true)
  • 0 (false) - défaut
hide_empty 
(boolean) Toggles the display of categories with no posts. The default is true (hide empty categories). Valid values:
  • 1 (true) - défaut
  • 0 (false)
use_desc_for_title 
(boolean) Sets whether a category's description is inserted into the title attribute of the links created (i.e. <a title="<em>Category Description</em>" href="...). The default is true (category descriptions will be inserted). Valid values:
  • 1 (true) - défaut
  • 0 (false)
child_of 
(integer) Only display categories that are children of the category identified by this parameter. There is no default for this parameter. If the parameter is used, the hide_empty parameter is set to false.
feed (string)
Display a link to each category's rss-2 feed and set the link text to display. The default is no text and no feed displayed.
feed_image 
(string) Set a URI for an image (usually an rss feed icon) to act as a link to each categories' rss-2 feed. This parameter overrides the feed parameter. There is no default for this parameter.
exclude 
(string) Exclude one or more categories from the results. This parameter takes a comma-separated list of categories by unique ID, in ascending order. See the example. The child_of parameter is automatically set to false.
include 
(string) Only include the categories detailed in a comma-separated list by unique ID, in ascending order. See the example.
hierarchical 
(boolean) Display sub-categories as inner list items (below the parent list item) or inline. The default is true (display sub-categories below the parent list item). Valid values:
  • 1 (true) - défaut
  • 0 (false)
title_li 
(string) Set the title and style of the outer list item. Defaults to "_Categories". If present but empty, the outer list item will not be displayed. See below for examples.
number 
(integer) Sets the number of Categories to display. This causes the SQL LIMIT value to be defined. Default to no LIMIT.