Table of contents
Selection criteria
One of the following criteria must be used to select the results:
- {id_article}
returns the list of sections from the root down to and including the section which contains the article.
- {id_rubrique}
returns the list of sections from the root down to, but not including, the identified section.
Note: Since [SPIP 1.8], it has been possible to also obtain the identified section in the results by specifying the criterion {tout}
(all).
These criteria — {id_article}
and {id_rubrique}
— cannot be used with a comparison. For example <BOUCLE_hi(HIERARCHIE) {id_article=12}>
will give an error.
Warning: This loop must be placed within an outer
ARTICLES
orRUBRIQUES
loop. It cannot “read” the id_article ou id_rubrique directly from the URL. (The same goes forHIERARCHIE
loops in templates included using the<INCLURE{fond=xxx}>
command or<INCLURE(xxx.php3)>
for SPIP versions prior to 1.9).)
Display criteria
Since [SPIP 1.8], all the criteria of The RUBRIQUES Loop (Sections) may be used with this loop, including sort criteria. (So <BOUCLE_x(HIERARCHIE){id_article}{par hasard}>
is possible, for example.)
Note: With versions of SPIP prior to 1.8, not all the "criteria applicable to all loops" applied to this loop. Only the criteria
{"between"}
and{a,b}
could be used.
Tags of this loop
The HIERARCHIE loop returns section records. All the tags available in <TT>RUBRIQUES</TT> loops can therefore also be used here.
Note: There is no available criteria for id_breve (news items) within a HIERARCHIE loop, but when referring to a given news item, using the current id_article will still return the right section in question.