La boucle RUBRIQUES

La boucle RUBRIQUES retourne une liste de... rubriques (étonnant, non ?)

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

Remarque Une boucle RUBRIQUES n’affiche que des rubriques « actives », c’est-à-dire contenant des articles publiés, des documents joints, des sites publiés — ou des sous-rubriques elles-mêmes actives. De cette façon, on évite de se trouver dans des rubriques « culs de sac » n’offrant aucun élément de navigation. Il est possible de forcer l’affichage des rubriques vides (voir ci-dessous, le critère {tout}).

Les critères de sélection

On utilisera l’un ou autre des critères suivants pour indiquer comment on sélectionne les éléments.

-   {id_rubrique} sélectionne la rubrique dont l’identifiant est id_rubrique. Comme l’identifiant de chaque rubrique est unique, ce critère retourne une ou zéro réponse.

-   {id_secteur} sélectionne les rubriques de ce secteur. (On peut également, par extension, utiliser le critère {branche} décrit dans La boucle ARTICLES).

-   {id_parent} sélectionne la liste des rubriques contenues dans une rubrique.

-   {racine} sélectionne la liste des secteurs (rigoureusement identique à {id_parent=0}).

-   {id_enfant} sélectionne la rubrique qui contient la rubrique (une seule réponse ; ou zéro réponse si la présente rubrique est située à la racine du site).

-   {meme_parent} sélectionne la liste des rubriques dépendant de la même rubrique que la rubrique en cours. Permet d’afficher les rubriques « sœurs » qui se trouvent au même niveau dans la hiérarchie.

-  Les rubriques peuvent être liées à des mots-clés :

  • {id_mot}, {titre_mot=xxx} récupèrent les rubriques liées au mot dont le numéro est id_mot ou dont le titre est titre_mot ;
  • {id_groupe}, {type_mot=yyyy} récupèrent les rubriques liées à des mots du groupe id_groupe, ou du groupe dont le titre est type_mot.

-   {recherche} sélectionne les rubriques correspondant aux mots indiqués dans l’interface de recherche (moteur de recherche incorporé à SPIP). Voir la page consacrée au moteur de recherche.

-   {lang} sélectionne les rubriques de la langue demandée dans l’adresse de la page.

-   {tout} sélectionne toutes les rubriques, c’est-à-dire : les rubriques vides en plus des rubriques contenant des éléments publiés.
On réservera ce choix à des besoins très spécifiques ; en effet, par défaut, SPIP n’affiche pas sur le site public les rubriques qui ne contiennent aucun élément actif, afin de garantir que le site ne propose pas de « culs de sac » (navigation vers des pages ne proposant aucun contenu).

Les critères d’affichage

Une fois fixé l’un des critères ci-dessus, on pourra ajouter les critères suivants pour restreindre le nombre d’éléments affichés.

-  Les critères communs à toutes les boucles s’appliquent évidemment.

-   {exclus} permet d’exclure du résultat la rubrique dans laquelle on se trouve déjà (utile avec meme_parent).

Les balises de cette boucle

Les balises tirées de la base de données

Les balises suivantes correspondent aux éléments directement tirés de la base de données. Vous pouvez les utiliser également en tant que critère de classement (généralement : {par titre}).

-  #ID_RUBRIQUE affiche l’identifiant unique de la rubrique.

-  #TITRE affiche le titre de la rubrique.

-  #DESCRIPTIF affiche le descriptif.

-  #TEXTE affiche le texte principal de la rubrique.

-  #ID_SECTEUR affiche l’identifiant du secteur dont dépend la rubrique (le secteur étant la rubrique située à la racine du site).

-  #ID_PARENT affiche l’identifiant de la rubrique qui contient la rubrique actuelle. Si la rubrique est située à la racine du site, retourne 0.

-  #LANG affiche la langue de cette rubrique.

Les balises calculées par SPIP

Les éléments suivants sont calculés par SPIP. (Ils ne peuvent pas être utilisés comme critère de classement.)

-  #NOTES affiche les notes de bas de page (calculées à partir de l’analyse du texte).

-  #INTRODUCTION affiche les 600 premiers caractères du texte, les enrichissements typographiques (gras, italique) sont supprimés.

-  #URL_RUBRIQUE affiche l’URL de la page de la rubrique.

-  #DATE affiche la date de la dernière publication effectuée dans la rubrique et/ou ses sous-rubriques (articles, brèves...).

-  #FORMULAIRE_FORUM fabrique et affiche le formulaire permettant de poster un message répondant à cette rubrique. Pour en savoir plus, voir aussi « Les formulaires ».

-  #PARAMETRES_FORUM fabrique la liste des variables exploitées par l’interface du formulaire permettant de répondre à cette rubrique. Par exemple :

[<a href="spip.php?page=forum&(#PARAMETRES_FORUM)">Répondre à cette rubrique</a>]

On peut lui passer un paramètre spécifiant l’adresse de retour après avoir posté le message. Par exemple : <a href="spip.php?page=forum&(#PARAMETRES_FORUM{#SELF})">Répondre à cette rubrique</a> renverra le visiteur sur la page actuelle une fois que le message a été validé.

-   #FORMULAIRE_SITE fabrique et affiche un formulaire permettant aux visiteurs du site de proposer des référencements de sites. Ces sites apparaitront comme « proposés » dans l’espace privé, en attendant une validation par les administrateurs.

Ce formulaire ne s’affiche que si vous avez activé l’option « Gérer un annuaire de sites » dans la Configuration sur site dans l’espace privé, et si vous avez réglé « Qui peut proposer des sites référencés » sur « les visiteurs du site public ».

Le logo

-  #LOGO_RUBRIQUE le logo de la rubrique, éventuellement avec la gestion du survol.

S’il n’y a pas de logo pour cette rubrique, SPIP va automatiquement chercher s’il existe un logo pour la rubrique dont elle dépend, et ainsi de suite de manière récursive.
Il est possible de désactiver cet héritage avec _LOGO_RUBRIQUE_DESACTIVER_HERITAGE.

#LOGO_RUBRIQUE_NORMAL affiche le logo « sans survol » ; #LOGO_RUBRIQUE_SURVOL affiche le logo de survol : ces deux balises permettent par exemple, quand on est dans une rubrique, de gérer un logo « avec survol » pour les liens vers les autres rubriques, et de laisser le logo de survol seul dans la rubrique active.

Voir aussi : syntaxe complète les balises #LOGO_XXX

Auteur L’équipe de SPIP Publié le : Mis à jour : 05/04/23

Traductions : عربي, català, Deutsch, English, Español, français, italiano, Nederlands, русский, українська