The BREVES loop (news items)

The selection criteria

We will use one of the following criteria to indicate how we will select the elements :

-  {tout}, i.e. « all », will select all the news items available on the site.

-  {id_breve} returns the news item identified by id_breve. Since the identifier of each news item is unique, this criterion will return one or zero records.

-  {id_rubrique} returns all the news items available in the current section (rubrique), where « current » refers to the contextual environment of any surrounding loops.

-  {id_mot} returns all the news items linked to the current keyword (inside a MOTS loop, for instance).

-  {id_mot} returns all the news items linked to the current keyword (inside a MOTS loop, for instance).

-  {titre_mot=xxxx}, or {type_mot=yyyy} returns the news items linked to the keyword named « xxxx » or the keyword group named « yyyy ». Warning, you cannot use the criteria {titre_mot=xxxx} or{type_mot=yyyy} several times in the same loop.

-  {id_groupe=zzzz} returns the news items linked to a given keyword group ; it is the same technique {type_mot}, but since we’re working with an identifier (a group number ), the syntax will be « cleaner ».

-  {lang} selects the news items in the language requested in the page’s address.

-  {recherche} i.e. search, returns the news items matching the words entered in the search interface (search engine incorporated into SPIP).

Tags for this loop

-  Tags retrieved from the database

The following tags represent the items retrieved from the database (as opposed to those that are « calculated » and are explained later). You can also use them as sorting criterion (usually : {par titre}, i.e. by title).

-  #ID_BREVE returns the unique identifier of the news item.

-  #TITRE returns the title of the news item.

-  #DATE returns the publishing date of the news item.

-  #TEXTE returns the text of the news item.

-  #NOM_SITE returns the name of the site given as the reference for the news.

-  #URL_SITE returns the URL of the site given as the reference for the news item.

-  #ID_RUBRIQUE returns the unique identifier of the section (rubrique) in which this news item is located.

-  #LANG returns the language of the news item. By default, this is the language of the sector in which the news item has been published.

-  Tags calculated by SPIP

The following elements are calculated by SPIP. (They cannot be used as sorting criterion.)

-  #NOTES returns the footnotes (calculated from the analysis of the text).

-  #INTRODUCTION the first 600 characters of the text, where the typographical embellishments (bold, italic, ...) are removed.

-  #URL_BREVE is the complete URL of the news item’s page.

-  #FORMULAIRE_FORUM creates and displays the forum interface of the news item.

-  #PARAMETRES_FORUM creates the list of variables used by the form interface to post on the forum of the news item. For instance :

[<a href="spip.php?page=forum&(#PARAMETRES_FORUM)">Reply to this news item</a>]

It is possible to pass this tag a parameter specifying the return address to link to after having posted the new message to the forums. For example : <a href="spip.php?page=forum&(#PARAMETRES_FORUM{#SELF})">Reply to this news item</a> will return the visitor to the same current page once the message has been validated.

-  The logo

-  #LOGO_BREVE displays the logo of the news item and the hovering logo if it is applicable.

The logo is inserted thus :

-  #LOGO_BREVE_RUBRIQUE displays the logo of the news item, if it exists ; if there is no logo, SPIP displays the logo of the section (rubrique).