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] [uk] [vi] [zh] Espace de traduction

Download

The HIERARCHIE (hierarchy) Loop

October 2003 — updated on : December 2010

All the versions of this article:

The HIERARCHIE loop returns a list of the SECTIONS which lead down from the root of the site to the current section or article.

<BOUCLEn(HIERARCHIE){criteria...}>


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 or RUBRIQUES loop. It cannot “read” the id_article ou id_rubrique directly from the URL. (The same goes for HIERARCHIE 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.


Show the template of this page Site powered by SPIP | Translation area | Private area