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