SPIP 1.9.2
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} 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
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 SPIP
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 SPIP
1.7.1) sélectionne l’article de référence dont l’article courant est une traduction.
- 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). Voir la page consacrée au moteur de recherche.
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=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).
- #NOM_SITE et #URL_SITE affichent le nom et l’url du « lien hypertexte » de l’article (si vous avez activé cette option).
- #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 nonspip.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 formehttp://monsite.net/xxx.php3et non pashttp://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.