La boucle ARTICLES

Une boucle d’articles se code en plaçant ARTICLES
(avec un « s ») entre parenthèses :

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

Les éléments contenus dans une telle boucle sont des articles.

Remarque. Une boucle ARTICLES ne retourne que des articles publiés. (Il n’existe aucun moyen d’afficher les articles « en cours de rédaction », « proposés à la publication » ou « refusés ».)

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 articles sont sélectionnés dans l’intégralité du site (dans toutes les rubriques). Utile notamment pour afficher les articles les plus récents (dans l’intégralité du site) sur la page d’accueil. [En réalité, le critère « tout » n’est pas traité de manière informatique : c’est un aide-mémoire pour le webmestre ; on obtient le même résultat en n’indiquant aucun des critères suivants.]

 {id_article} retourne l’article dont l’identifiant est id_article. Comme l’identifiant de chaque article est unique, ce critère ne retourne qu’une ou zéro réponse.

 {id_rubrique} retourne la liste des articles contenus dans la rubrique id_rubrique.

 {id_secteur} retourne les articles dans ce secteur (un secteur est une rubrique qui ne dépend d’aucune autre rubrique, c’est-à-dire située à la racine du site).

 [SPIP 1.4] {branche} : le critère {branche} retourne l’ensemble des articles de la rubrique ET de ses sous-rubriques. (C’est une sorte d’extension du critère {id_secteur}. Toutefois, à l’inverse de {id_secteur=2}, il n’est pas possible d’appeler directement une branche en faisant par exemple {branche=2} : techniquement parlant, il faut que la rubrique en question figure dans le contexte courant. Ce critère est à utiliser avec parcimonie : si votre site est bien structuré, vous ne devriez pas en avoir besoin, sauf dans des cas très particuliers.)

 {id_auteur} retourne les articles correspondant à cet identifiant d’auteur (utile pour indiquer la liste des articles écrits par un auteur).

 {id_mot} retourne les articles correspondant à cet identifiant de mot-clé (utile pour indiquer la liste des articles traitant d’un sujet donné).

 [SPIP 1.3] {titre_mot=xxxx}, ou {type_mot=yyyy} retourne les articles liés au mot-clé dont le nom est « xxxx », ou liés à 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 articles liés à 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 ». [Nota : Ce critère n’est pas (en l’état actuel du développement de SPIP) cumulable avec le précédent {type_mot=yyyy}]

 {recherche} retourne les articles 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

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 l’article dans lequel on se trouve déjà (par exemple, lorsque l’on affiche les articles contenus dans la même rubrique, on ne veut pas afficher un lien vers l’article dans lequel on se trouver déjà).

 {doublons} ou {unique} (ces deux critères sont rigoureusement identiques) permettent d’interdire l’affichage d’articles déjà affichés dans d’autres boucles elles-mêmes marquées {doublons}.

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 (par exemple : {par date} ou {par titre}).

 #ID_ARTICLE affiche l’identifiant unique de l’article. Utile pour fabriquer des liens hypertextes non prévus (par exemple vers une page « Afficher au format impression ».

 #SURTITRE retourne le surtitre.

 #TITRE retourne le titre de l’article.

 #SOUSTITRE retourne le soustitre.

 #DESCRIPTIF retourne le descriptif.

 #CHAPO retourne le texte d’introduction (chapeau).

 #TEXTE retourne le texte principal de l’article.

 #PS retourne le post-scriptum.

 Les dates : #DATE, #DATE_REDAC, #DATE_MODIF sont explicitées dans la documentation sur « La gestion des dates ».

 #ID_RUBRIQUE est l’identifiant de la rubrique dont dépend l’article.

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

 #VISITES est le nombre de visites sur cet article.

 #POPULARITE donne le pourcentage de popularité de cet article, voir la documentation La « popularité » des articles.

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 : [SPIP 1.4] si l’article contient un descriptif, c’est celui-ci qui est utilisé ici ; sinon, SPIP affiche les 600 premiers caractères du début de l’article (chapeau puis texte). [SPIP 1.3] Dans les versions précédentes de SPIP, ce sont systématiquement les premiers caractères de l’article (chapeau puis texte) qui sont pris en compte (le descriptif n’est pas utilisé).

 #LESAUTEURS les auteurs de cet article. Cela permet d’éviter de créer une boucle AUTEURS pour obtenir le même résultat.

 #URL_ARTICLE est l’URL de la page de l’article.

 #FORMULAIRE_FORUM fabrique l’interface permettant de poster un message répondant à cet article.

 #FORMULAIRE_SIGNATURE fabrique l’interface permettant de signer la pétition associée à cet article.

 #PARAMETRES_FORUM fabrique la liste des variables exploitées par l’interface du formulaire permettant de répondre à cet article. Par exemple :
 [<A HREF="forum.php3?(#PARAMETRES_FORUM)">Répondre à cet article</A>]

Les logos

 #LOGO_ARTICLE le logo de l’article, éventuellement avec la gestion du survol.

 #LOGO_ARTICLE_RUBRIQUE le logo de l’article, éventuellement remplacé par le logo de la rubrique s’il n’existe pas de logo spécifique à l’article.

 #LOGO_RUBRIQUE le logo de la rubrique de l’article.

Les logos s’installent de la manière suivante :

[(#LOGO_ARTICLE|alignement|adresse)]

L’alignement peut être left ou right. L’adresse est l’URL de destination du lien de ce logo (par exemple #URL_ARTICLE). Si l’on n’indique pas d’adresse, le bouton n’est pas cliquable.

Si l’on veut récupérer directement le nom du fichier du logo (alors que les balises précédentes fabriquent le code HTML complet pour insérer l’image dans la page), par exemple pour afficher une image en fond de tableau, on utilisera le filtre |fichier comme suit : [(#LOGO_ARTICLE|fichier)]

Par ailleurs deux balises permettent de récupérer un seul des deux logos :
 #LOGO_ARTICLE_NORMAL est le logo sans survol ;
 #LOGO_ARTICLE_SURVOL est le logo de survol.