La boucle BREVES, comme son nom l’indique, retourne une liste de brèves.
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.
{tout} les brèves sont sélectionnées dans l’intégralité du site.
{id_breve} retourne la brève dont l’identifiant est id_breve. Comme l’identifiant de chaque brève est unique, ce critère retourne une ou zéro réponse.
{id_rubrique} retourne toutes les brèves contenues dans la rubrique en cours.
[SPIP 1.2] {id_mot} retourne toutes les brèves liées au mot-clé en cours (à l’intérieur d’une boucle de type MOTS).
[SPIP 1.3] {titre_mot=xxxx}, ou {type_mot=yyyy} retourne les brèves
liées au mot-clé dont le nom est « xxxx », ou liées à des mots-clés du groupe de mots-clés « yyyy ». Attention, on ne peut pas utiliser plusieurs critères {titre_mot=xxxx}
ou {type_mot=yyyy}
dans une même boucle.
[SPIP 1.4]{id_groupe=zzzz} permet de sélectionner les brèves liées à un groupe de mots-clés ; principe identique au {type_mot}
précédent, mais puisque l’on travaille avec un identifiant (numéro du groupe), la syntaxe sera plus « propre ».
{recherche} retourne les brèves correspondant aux mots indiqués dans l’interface de recherche (moteur de recherche incorporé à SPIP). Voir la page consacrée au moteur de recherche.
Les critères d’affichage
Les critères communs à toutes les boucles s’appliquent.
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_BREVE affiche l’identifiant unique de la brève.
#TITRE retourne le titre de la brève.
#DATE retourne la date de publication de la brève.
#TEXTE retourne le texte de la brève.
#NOM_SITE le nom du site indiqué en références.
#URL_SITE l’adresse (URL) du site indiqué en références.
#ID_RUBRIQUE l’identifiant de la rubrique dont dépend cette brève.
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 les notes de bas de page (calculées à partir de l’analyse du texte).
#INTRODUCTION les 600 premiers caractères du texte, les enrichissements typographiques (gras, italique) sont supprimés.
#URL_BREVE est l’URL de la page de la brève.
#FORMULAIRE_FORUM fabrique l’interface permettant de poster un message répondant à cette brève.
#PARAMETRES_FORUM fabrique la liste des variables exploitées par l’interface du formulaire permettant de répondre à cette brève. Par exemple :
[<A HREF="forum.php3?(#PARAMETRES_FORUM)">Répondre à cette brève</A>]
Le logo
#LOGO_BREVE le logo de la brève, éventuellement avec la gestion du survol.
Le logo s’installe de la manière suivante :
#LOGO_BREVE_RUBRIQUE
affiche, si il existe, le logo de la brève ; si ce logo n’a pas été attribué, SPIP affiche le logo de la rubrique [SPIP 1.4].