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

Télécharger

La boucle ARTICLES

Mai 2001 — mis à jour le : Mars 2010

Toutes les versions de cet article :

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

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

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


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_article} sélectionne 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} sélectionne les articles contenus dans la rubrique dont l’identifiant est id_rubrique.

-  {id_secteur} sélectionne 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).

-  {branche} (depuis SPIP 1.4 ) sélectionne 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} sélectionne les articles correspondant à cet identifiant d’auteur (utile pour indiquer la liste des articles écrits par un auteur).

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

-  {titre_mot=xxxx}, ou {type_mot=yyyy} (depuis SPIP 1.3) sélectionne respectivement 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 ». Si l’on donne plusieurs critères {titre_mot=xxxx} (ou plusieurs {type_mot=yyyy}), on sélectionnera ceux qui auront tous ces mots à la fois (nouveauté de SPIP 1.9).

-  {id_groupe=zzzz} (depuis SPIP 1.4 ) 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}]

-  {lang} (depuis SP<font color="yellow">IP 1.7.1) sélectionne les articles de la langue demandée dans l’adresse de la page.

-  {traduction} (depuis SPIP 1.7.1) sélectionne les traductions de l’article courant en différentes langues.

-  {origine_traduction} (depuis SP<font color="yellow">IP 1.7.1) sélectionne les articles qui servent de base à des versions traduites (les articles "originaux").

Voir sur programmer.spip.org pour des exemples

-  Les critères {date} (ou {date=...} ou {date==...}) permettent de sélectionner un article en fonction de la date passée dans l’URL (depuis SPIP 1.7.2).

-  {recherche} sélectionne les articles correspondant aux mots indiqués dans l’interface de recherche (moteur de recherche incorporé à SPIP).

Le critère {tout} permet de sélectionner les données d’une table comme si aucun autre critère restrictif n’était appliqué.
Ainsi son utilisation relève-t’elle plus de l’aide-mémoire pour le webmestre puisque l’on obtient le même résultat en n’indiquant aucun critère.

Lorsqu’une boucle renvoie plusieurs dizaines d’articles (ou, pour une pétition, plusieurs milliers de signatures), il n’est pas souhaitable, voire impossible, de tout afficher sur une seule page.

Le critère {si ...} permet de conditionner l’exécution d’une boucle à la condition exprimée en argument dans le critère.

Le statut de l’article

Comme toutes les boucles de SPIP, une boucle ARTICLES ne retourne que des articles publiés ; dans le cas où le site est réglé de manière à ne pas publier les articles « post-datés », un autre test est fait sur la date de l’article. Jusqu’à SPIP 1.8.2 il n’existait aucun moyen de débrayer ce système et d’afficher les articles « en cours de rédaction », « proposés à la publication » ou « refusés ». C’est désormais possible grâce au critère {statut} :

  • {statut IN prop,prepa,publie,refuse,poubelle} (depuis SPIP 1.8.2) sélectionne les articles en fonction de leur statut de publication :
  • {statut=prepa} sélectionne les articles en cours de rédaction dans l’espace privé ;
  • {statut=prop} sélectionne les articles proposés à la publication ;
  • {statut=publie} sélectionne les articles publiés sur le site, y compris les articles « post-datés » ;
  • {statut=refuse} sélectionne les articles qui ont été refusés à la publication ;
  • {statut=poubelle} sélectionne les articles qui ont été mis à la poubelle.

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.

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 affiche le surtitre.

-  #TITRE affiche le titre de l’article.

-  #SOUSTITRE affiche le soustitre.

-  #DESCRIPTIF affiche le descriptif.

-  #CHAPO affiche le texte d’introduction (chapeau).

-  #TEXTE affiche le texte principal de l’article.

-  #PS affiche le post-scriptum.

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

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

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

Les balises #NOM_SITE et #URL_SITE affichent le nom et l’url du « lien hypertexte » associé à l’objet concerné.

-  #VISITES affiche le nombre total de visites sur cet article.

-  #POPULARITE affiche le pourcentage de popularité de cet article ; voir la documentation « La « popularité » des articles ».

-  #LANG affiche la langue de cet article.

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).

-  #URL_ARTICLE affiche l’URL de la page de l’article.

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

-  #INTRODUCTION (depuis SPIP 1.4 ) affiche le descriptif de l’article, sinon affiche les 600 premiers caractères du début de l’article (chapeau puis texte). Dans les versions antérieures à SPIP 1.3, 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 affiche les auteurs de cet article, avec lien vers leur propre page publique (afin de pouvoir directement leur écrire ou de consulter la liste des articles qu’ils ont publié). Cela évite de créer une boucle AUTEURS pour obtenir le même résultat. Dans les versions antérieures à SPIP 1.9, cette balise affiche les auteurs de l’article avec lien vers leur adresse e-mail.

-  #PETITION affiche le texte de la pétition si elle existe. Si elle existe mais que le texte est vide, retourne un espace (une chaîne non vide sans incidence dans une page html).

-  #FORMULAIRE_SIGNATURE fabrique et affiche le formulaire permettant de signer la pétition associée à cet article.

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

-  #PARAMETRES_FORUM fabrique et affiche la liste des variables exploitées par le formulaire permettant de répondre à cet article. Par exemple :

Depuis SPIP 1.8.2 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 à cet article</a> renverra le visiteur sur la page actuelle une fois que le message a été validé.

Historique : Dans les versions antérieures à SPIP 1.9 il aurait fallu écrire forum.php3? et non spip.php?page=forum&

De façon générale jusqu’à SPIP 1.9, les urls des pages générées par SPIP étaient de la forme http://monsite.net/xxx.php3 et non pas http://monsite.net/spip.php?page=xxx.

Les logos

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

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

-  #LOGO_ARTICLE_RUBRIQUE affiche le logo de l’article, éventuellement remplacé par le logo de la rubrique s’il n’existe pas de logo spécifique à 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 affiche le logo sans survol ;
-  #LOGO_ARTICLE_SURVOL affiche le logo de survol.


Voir le squelette de cette page Site réalisé avec SPIP | Espace de traduction | Espace privé