uZine 3

La gestion des dates

l'équipe de SPIP — 2003-05-26T21:23:12Z

[SPIP 1.6] introduit une série de critères et de balises pour mieux gérer les dates des articles. En voici une liste.

Afficher les dates

#DATE est la date de mise en ligne. (Modifiable après la mise en ligne de l'article, de la brève, etc. La date d'une rubrique est celle de son élément le plus récent.)

#DATE_REDAC est la date de première publication. (Modifiable à volonté, disponible sur les articles seulement.)

#DATE_MODIF [SPIP 1.5]
est la date de dernière édition de l'article : précisément, il s'agit de la dernière date à laquelle cet article a été ouvert en édition qu'il ait été modifié ou pas. Pratique dans de nombreux cas, mais pas d'une rigueur scientifique... (Non modifiable, sauf si on veut la fixer à « maintenant » : il suffit alors... d'ouvrir l'article en édition.)

#DATE_NOUVEAUTES [SPIP 1.6] permet d'afficher la date du dernier envoi du mail présentant les nouveautés.

Contexte de date

[SPIP 1.6] fournit à toutes les boucles un contexte de date. Si l'on se trouve à l'intérieur d'une boucle (ARTICLES), (BREVES) ou (RUBRIQUES), la date en question est la date de publication de l'article, de la brève ou la date de dernière modification de la rubrique.

Si l'on se trouve au premier niveau du squelette, la date passée dans le contexte est la date du jour, sauf si une date est passée dans l'URL de la page.

Dans ce dernier cas, et pour les versions de php supérieures à 3.0.12, la date passée dans l'URL est analysée avec la fonction strtotime : ainsi ?date=2003, ?date=2003/01 fonctionneront, mais aussi date=-1year (il y a un an), ?date=1march1970 (articles publiés le 1er mars 1970), etc.

Critère de date, d'âge, et d'âge relatif

Le critère {age} permet de sélectionner les articles en fonction de la durée qui sépare leur date de publication en ligne avec la date courante. Ainsi {age<30} permettra de ne pas afficher les articles âgés de plus de 30 jours.

L'{age_relatif} permet de comparer les dates de publication de deux articles : si l'on vient de sélectionner un article dans un boucle, une seconde boucle placée à l'intérieur de la première pourra demander les articles publiés dans la semaine qui précède celui-ci, via {age_relatif<=7}{age_relatif>=0}, etc.

Les critères {age} et {age_relatif} permettent de distinguer deux articles publiés le même jour (ce n'était pas le cas avant [SPIP 1.6]). On peut donc désormais programmer des boucles pour obtenir l'article « précédent » ou le « suivant » :

<BOUCLE_art(ARTICLES){id_article}> <BOUCLE_precedent(ARTICLES){age_relatif>=0}{par date}{inverse}{1,1}> précédent : <a href='#URL_ARTICLE'>#TITRE</a> #DATE </BOUCLE_precedent> <br /> <b>#TITRE</b> - #DATE <br /> <BOUCLE_suivant(ARTICLES){age_relatif<0}{par date}{0,1}> suivant : <a href='#URL_ARTICLE'>#TITRE</a> #DATE </BOUCLE_suivant> </BOUCLE_art>

Attention ! Malgré les apparences les comparaisons de date sont d'un maniement délicat : en effet, à cause des « dates floues » (un article publié un mois donné, sans que le jour soit précisé), le calcul de l'age_relatif peut donner la valeur zéro dans un sens, et pas dans l'autre ! D'où la dissymétrie des boucles présentées ci-dessus : dans un sens on cherche le « second plus récent » des articles {age_relatif>=0} (car le plus récent, avec la comparaison non-stricte, ne peut être que l'article lui-même) ; dans l'autre le plus âgé des articles publiés strictement plus tard.

Les critères {jour_relatif}, {mois_relatif} et {annee_relatif} fonctionnent comme l'age_relatif, mais prennent en compte des dates arrondies au jour, au mois et à l'année respectivement ; par exemple, si l'URL comporte la variable ?date=2003-01-01, la boucle suivante donnera « tous les les articles du mois de mars 2003 »

<h3>Articles de [(#DATE|nom_mois)] [(#DATE|annee)] :</h3> <BOUCLE_blog(ARTICLES){mois_relatif=0}{par date}{"<br />"}> <a href='#URL_ARTICLE'>#TITRE</a> ([(#DATE|jour)]/[(#DATE|nom_mois)] </BOUCLE_blog>

La date de rédaction antérieure

Si vous avez activé l'utilisation des dates de publication antérieure, la plupart des critères présentés ci-dessus fonctionnent : il suffit d'ajouter _redac au critère. Ainsi {age_redac>365} affichera les articles dont la date de publication antérieure remonte à plus d'un an.

Si une boucle sélectionne un article dont l'age_redac est défini, une boucle interne comportant le critère {annee_relatif_redac=0} ira chercher les articles dont la date de publication antérieure appartient à la même année.

Un exemple de sommaire de site trié par date

A titre d'exemple, voici comment on peut afficher tous les articles d'un site, triés par mois de publication :

<BOUCLE_articlem(ARTICLES){par date}{inverse}> <BOUCLE_premierdumois(ARTICLES){id_article}{doublons}> <BR><UL><b> [(#DATE|nom_mois|majuscules)] [(#DATE|annee)] </b> <li><a href="#URL_ARTICLE">[(#TITRE|couper{50})]</a> - [(#DATE|jour)]/[(#DATE|mois)]</li> </BOUCLE_premierdumois> <BOUCLE_MOIS(ARTICLES) {mois_relatif=0}{doublons}{par date}{inverse} > <li><a href="#URL_ARTICLE">[(#TITRE|couper{50})]</a> - [(#DATE|jour)]/[(#DATE|mois)]</li> </BOUCLE_MOIS> </ul> </BOUCLE_articlem>

Les critères communs à toutes les boucles

l'équipe de SPIP — 2001-05-04T22:00:00Z

Certains critères s'appliquent à (presque) tous les types de boucles. Ce sont des critères destinés à restreindre le nombre de résultats affichés ou à indiquer l'ordre d'affichage. On peut sans difficulté combiner plusieurs de ces critères de sélection.

Classer les résultats

{par critère_de_classement} indique l'ordre de présentation des résultats. Ce critère de classement correspond à l'une des balises tirées de la base de données pour chaque type de boucle. Par exemple, on pourra classer les articles {par date}, {par date_redac} ou {par titre}. (Notez que, si les balises sont en majuscules, les critères de classement sont en minuscules.)

Cas particulier : {par hasard} permet d'obtenir une liste présentée dans un ordre aléatoire.

Inverser le classement. De plus, {inverse} provoque l'affichage du classement inversé. Par exemple {par date} commence par les articles les plus anciens ; avec {par date}{inverse} on commence la liste avec les articles les plus récents.

Classer par numéro. (SPIP 1.3) Lorsqu'on réalise le classement selon un élément de texte (par exemple le titre), le classement est réalisé par ordre alphabétique. Cependant, pour forcer un ordre d'affichage, on peut indiquer un numéro devant le titre, par exemple : « 1. Mon premier article », « 2. Deuxième article », « 3. Troisième... », etc ; avec un classement alphabétique, le classement de ces éléments donnerait la série « 1, 10, 11, 2, 3... ». Pour rétablir le classement selon les numéros, on peut utiliser le critère :

{par num critère}

Par exemple :

<BOUCLE_articles(ARTICLES){id_rubrique}{par date}{inverse}>

affiche les articles d'une rubrique classés selon l'ordre chronologique inversé (les plus récents au début, les plus anciens à la fin), et :

<BOUCLE_articles(ARTICLES){id_rubrique}{par titre}>

les affiche selon l'ordre alphabétique de leur titre ; enfin :

<BOUCLE_articles(ARTICLES){id_rubrique}{par num titre}>

les affiche selon l'ordre du numéro de leur titre (remarque : l'option {par num titre} ne fonctionne pas pour les plus anciennes versions de MySQL, antérieures à la version 3.23).

Comparaisons, égalités

{critère < valeur} Comparaison avec une valeur fixée (on peut utiliser « > », « < », « = », « >= », « <= ». Tous les critères de classement (tels que tirés de la base de données) peuvent également être utilisés pour limiter le nombre de résultats.

Par exemple :

<BOUCLE_art(ARTICLES){id_article=5}>

affiche l'article dont le numéro est 5 (utile pour mettre en vedette un article précis sur la page d'accueil).

<BOUCLE_art(ARTICLES){id_secteur=2}>

affiche les articles du secteur numéro 2.

Expressions régulières. Très puissant (mais nettement plus complexe à manipuler), le terme de comparaison « == » introduit une comparaison selon une expression régulière. Par exemple :

<BOUCLE_art(ARTICLES){titre==^[aA]}>

sélectionne les articles dont le titre commence par « a » ou « A ».

Négation. (SPIP 1.2) On peut utiliser la notation {xxx != yyy}, le ! correspondant à la négation (opérateur logique NOT).

<BOUCLE_art(ARTICLES){titre!==^[aA]}>

sélectionne les articles dont le titre ne commence pas par « a » ou « A ».

<BOUCLE_art(ARTICLES){id_secteur != 2}>

sélectionne les articles qui n'appartiennent pas au secteur numéro 2.

Pour faciliter l'utilisation des comparaisons sur les dates, on a ajouté des critères :
age et age_redac correspondent respectivement à l'ancienneté de la publication et de la première publication d'un article, en jours : {age<30} sélectionne les éléménts publiés depuis un mois ;
les critères mois, mois_redac, annee, annee_redac permettent de comparer avec des valeurs fixes ({annee<=2000} pour les éléments publiés avant la fin de l'année 2000).

On peut combiner plusieurs de ces critères pour effectuer des sélections très précises. Par exemple :

<BOUCLE_art(ARTICLES){id_secteur=2}{id_rubrique!=3}{age<30}>

affiche les articles du secteur 2, à l'exclusion de ceux de la rubrique 3, et publiés depuis moins de 30 jours.

Astuce. Le critère age est très pratique pour afficher les articles ou les brèves dont la date est située « dans le futur », avec des valeurs négatives (à condition d'avoir sélectionné, dans la Configuration précise du site, l'option « Publier les articles post-datés »). Par exemple, ce critère permet de mettre en valeur des événements futurs. {age<0} sélectionne les articles ou les brèves dont la date est située dans le futur (« après » aujourd'hui)...

(SPIP 1.3) Âge par rapport à une date fixée. Le critère age est calculé par rapport à la date d'aujourd'hui (ainsi {age<30} correspond aux articles publiés depuis moins d'un mois par rapport à aujourd'hui). Le critère age_relatif compare la date d'un article ou d'une brève à une date « courante » ; par exemple, à l'intérieur d'une boucle ARTICLES, on connaît déjà une date pour chaque résultat de la boucle, on peut donc sélectionner par rapport à cette date (et non plus par rapport à aujourd'hui).

Par exemple :

<BOUCLE_article_principal(ARTICLES){id_article}> <h1>#TITRE</h1> <BOUCLE_suivant(ARTICLES){id_rubrique}{age_relatif<=0}{exclus}{par date}{0,1}> Article suivant: #TITRE </BOUCLE_suivant> </BOUCLE_article_principal>

la BOUCLE_suivant affiche un seul article de la même rubrique, classé par date, dont la date de publication est inférieure ou égale à la date de l'« article_principal » ; c'est-à-dire l'article de la même rubrique publié après l'article principal.

Affichage d'une partie des résultats

{a,b} où a et b sont des chiffres. Ce critère permet de limiter le nombre de résultats. a indique le résultat à partir duquel on commence l'affichage (attention, le premier résultat est numéroté 0 - zéro) ; b indique le nombre de résultats affichés.

Par exemple {0,10} affiche les dix premiers résultats ; {4,2} affiche les deux résultats à partir du cinquième (inclus).

{debut_xxx,b} est une variante très élaborée de la précédente. Elle permet de faire commencer la limitation des résultats par une variable passée dans l'URL (celle variable remplace ainsi le a que l'on indiquait précédemment). C'est un fonctionnement un peu compliqué, que fort heureusement on n'a pas besoin d'utiliser trop souvent.

La variable passée dans l'URL commence forcément par debut_xxx (où xxx est un mot choisi par le webmestre) . Ainsi, pour une page dont l'URL est :

petition.php3?id_article=13&debut_signatures=200

avec un squelette (petition.html) contenant par exemple :

<BOUCLE_signatures(SIGNATURES){id_article}{debut_signatures,100}>

on obtiendra la liste des 100 signatures à partir de la 200-ième. Avec l'URL :

petition.php3?id_article=13&debut_signatures=300

on obtient la liste des 100 signatures à partir de la 300-ième.

{a/b} où a et b sont des chiffres. Ce critère permet d'afficher une partie a (proportionnellement) des résultats en fonction d'un nombre de « tranches » b.

Par exemple : {1/3} affiche le premier tiers des résultats. Ce critère est surtout utile pour présenter des listes sur plusieurs colonnes. Pour obtenir un affichage sur deux colonnes, il suffit de créer une première boucle, affichée dans une case de tableau, avec le critère {1/2} (la première moitié des résultats), puis une seconde boucle dans une seconde case, avec le critère {2/2} (la seconde moitié des résultats).

Attention. L'utilisation du critère {doublons} avec ce critère est périlleuse. Par exemple :

<BOUCLE_prem(ARTICLES){id_rubrique}{1/2}{doublons}> <li> #TITRE </BOUCLE_prem> <BOUCLE_deux(ARTICLES){id_rubrique}{2/2}{doublons}> <li> #TITRE </BOUCLE_deux>

n'affichera pas tous les articles de la rubrique ! Imaginons par exemple qu'il y ait au total 20 articles dans notre rubrique. La BOUCLE_prem va afficher la première moitié des articles, c'est-à-dire les 10 premiers, et interdire (à cause de {doublons}) de les réutiliser. La BOUCLE_deux, elle, va récupérer la deuxième moitié des articles de cette rubrique qui n'ont pas encore été affichés par la BOUCLE_prem ; donc, la moitié des 10 articles suivants, c'est-à-dire les 5 derniers articles de la rubrique. Vous avez donc « perdu » 5 articles dans l'opération...

Affichage entre les résultats

{"inter"} permet d'indiquer un code HTML (ici, inter) inséré entre les résultats de la boucle. Par exemple, pour séparer une liste d'auteurs par une virgule, on indiquera :

<BOUCLE_auteurs(AUTEURS){id_article}{", "}>