SPIP

[ar] [ast] [bg] [br] [ca] [co] [cpf] [cs] [da] [de] [en] [eo] [es] [eu] [fa] [fon] [fr] [gl] [id] [it] [ja] [lb] [nl] [oc] [pl] [pt] [ro] [ru] [sk] [sv] [tr] [vi] [zh] Espace de traduction

Télécharger

La boucle HIERARCHIE

Mai 2001 — mis à jour le : Août 2008

Toutes les versions de cet article :

La boucle HIERARCHIE retourne la liste des RUBRIQUES qui mènent de la racine du site à la rubrique ou à l’article en cours.

<BOUCLEn(HIERARCHIE){critères...}>


Les critères de sélection

On utilisera obligatoirement l’un des deux critères suivants pour indiquer comment on sélectionne les éléments :

-  {id_article} retourne la liste des rubriques depuis la racine jusqu’à la rubrique contenant l’article correspondant à cet identifiant.

-  {id_rubrique} retourne la liste des rubriques depuis la racine jusqu’à la rubrique correspondant à cet identifiant (exclue).

Note : Depuis [SPIP 1.8], {tout} permet d’obtenir aussi la rubrique correspondant à l’identifiant spécifié.

Les critères {id_article} ou {id_rubrique} ne peuvent pas être utilisés avec une comparaison. Par exemple, <BOUCLE_hi(HIERARCHIE) {id_article=12}> retournera une erreur.

Attention : cette boucle sera obligatoirement placée à l’intérieur d’une boucle ARTICLES ou RUBRIQUES — elle ne va pas par elle-même « chercher » l’id_article ou id_rubrique indiquée dans l’URL. (Le même principe vaut pour les boucles HIERARCHIE des squelettes inclus par la commande <INCLURE{fond=xxx}> ou <INCLURE(xxx.php3)> pour les version antérieure à 1.9)

Les critères d’affichage

Depuis [SPIP 1.8], tous les critères de La boucle RUBRIQUES peuvent être utilisés avec cette boucle, y compris les critères de tri (il devient possible par exemple de trier une <BOUCLE_x(HIERARCHIE){id_article}{par hasard}>).

Historique : Jusqu’à la version [SPIP 1.7.2], Les critères communs à toutes les boucles ne s’appliquent pas tous à ce type de boucle. Seuls les critères {"inter"} et {a,b} étaient utilisables.

Les balises de cette boucle

Les éléments obtenus avec une boucle HIERARCHIE sont des rubriques. On peut donc utiliser toutes les balises proposées pour les boucles RUBRIQUES.

Note : Il n’y a pas de critère id_breve dans HIERARCHIE mais, dans le cas d’une brève, l’usage d’id_article retournera quand même la bonne rubrique.


Voir le squelette de cette page Site réalisé avec SPIP | Espace de traduction | Espace privé