SPIP-Contrib

SPIP-Contrib

عربي | Deutsch | English | Español | français | italiano | Nederlands

290 Plugins, 198 contribs sur SPIP-Zone, 87 visiteurs en ce moment

Accueil > Dates, calendriers et agendas > Affichage selon dates > Balise #TRIMESTRE > Une nouvelle balise : exemple avec #TRIMESTRE

Une nouvelle balise : exemple avec #TRIMESTRE

21 août 2007 – par Cyril Marion – commentaire

4 votes

Un exemple de création d’une balise #TRIMESTRE dans les boucles articles.

Cette contrib permet de créer, puis d’utiliser une nouvelle balise #TRIMESTRE, à la fois en tant que balise dans une boucle articles, mais aussi comme critère dans la boucle.

Il faut ajouter ces 3 fonctions dans le fichiers « mes_fonctions.php » [1].

1. Créer la fonction qui calcule le trimestre à partir d’une date

Le format choisi pour le trimestre est de la forme « annee - trimestre » de manière à pouvoir opérer des tris. Le calcul s’effectue à partir des fonctions date de SPIP :

  1. function calculer_trimestre($la_date) {
  2.   $la_date = normaliser_date($la_date);
  3.   $le_mois = mois($la_date);
  4.   $l_annee = annee($la_date);
  5.   $le_trimestre = $l_annee.'-'.ceil ($le_mois/3);
  6.   return $le_trimestre;
  7. }

Télécharger

A noter : cette fonction peut aussi s’utiliser telle quelle en tant que filtre sur une date à la manière classique : [(#DATE|calculer_trimestre)].

2. Ajouter la nouvelle colonne (le nouveau champ) dans la boucle

Afin de « déclarer » la nouvelle colonne, il faut modifier la fonction boucle_ARTICLE [2] de la façon suivante :

  1. function boucle_ARTICLE($id_boucle, &$boucles) {
  2.   $boucle = &$boucles[$id_boucle];
  3.   $id_table = $boucle->id_table;
  4.   $boucle->select[] = "CONCAT(year(date), '-', quarter(date)) AS trimestre";
  5.   $boucle->from[$id_table] = "spip_article";
  6.   $mstatut = $id_table .'.statut';
  7.  
  8.   // Restreindre aux elements publies
  9.   if (!$boucle->modificateur['criteres']['statut']) {
  10.     if (!$GLOBALS['var_preview']) {
  11.       $boucle->where[]= array("'='", "'$mstatut'", "'\"publie\"'");
  12.       if ($GLOBALS['meta']["post_dates"] == 'non')
  13.       $boucle->where[]= array("'<'", "'$id_table" . ".date'", "'NOW()'");
  14.     }
  15.     else $boucle->where[]= array("'IN'", "'$mstatut'", "'(\"publie\",\"prop\")'");
  16.   }
  17.  
  18.   return calculer_boucle($id_boucle, $boucles);
  19.  
  20. }

Télécharger

Cette modification peut s’apprécier en mode debug en cliquant sur « résultat » : on voit que la requête appelle un nouveau champ.

3. Créer la balise #TRIMESTRE qui retournera le trimestre

  1. function balise_TRIMESTRE($p) {
  2.   $date_evenement = champ_sql('date', $p);
  3.   $p->code = "calculer_trimestre($date_evenement)";
  4.   $p->interdire_scripts = false;
  5.   return $p;   
  6. }

Télécharger

Désormais il est possible dans une boucle ARTICLES d’utiliser un critère « trimestre », et d’afficher une balise #TRIMESTRE dans les squelettes.

Le débat

L’interêt de cette contrib réside plus sur la méthode pour se créer une nouvelle balise (boucle + balise), ou un nouveau champ virtuel, que dans l’obtention d’un trimestre à partir d’une date (que l’on obtient aussi facilement avec un petit filtre utilisant la fonction « quarter(date) » de MySQL).

L’interrogation est plutôt : qu’est-ce qui est mieux (pour un résultat équivalent et un boulot équivalent) ?
-  soit : filtre + critère => 2 fonctions dans mes_fonctions
-  soit : nouveau champ virtuel => idem, 2 fonctions de plus (boucle et balise)

Le débat est lancé

P.-S.

De la même manière il doit être possible de créer une nouvelle balise qui provienne d’une requête avec plein de join sur plusieurs tables...

Notes

[1Nota : « mes_fonctions.php » est à créer, s’il n’existe pas, dans votre répertoire « squelettes ». C’est un fichier php il doit être ouvert et fermé par les balises <?php et ?>, avec rien avant et après

[2on peut appeler aussi la fonction boucle_ARTICLE_dist s’il s’agit d’ajouter la fonction en dehors d’un plugin

Dernière modification de cette page le 21 août 2007

Retour en haut de la page

Vos commentaires

  • Le 26 décembre 2007 à 16:48, par Patrice Vanneufville En réponse à : Une nouvelle balise : exemple avec #TRIMESTRE

    Salut à tous,

    Voici qq idées qui ont été évoquées en août et que je trouve utile de replacer ici, le débat n’est peut-être pas encore clos...

    La surcharge de la boucle ARTICLES est incompatible avec le plugin acces_restreint.

    Est-ce qu’on peut pas arriver au même résultat sans cette surcharge ?

    un simple filtre trimestre ?

    function trimestre($la_date) {
      $la_date = normaliser_date($la_date);
      $le_mois = mois($la_date);
      return ceil($le_mois/3);
    }

    à utiliser comme ceci : [(#DATE|trimestre)]

    ou même : [(#DATE|annee)]-[(#DATE|trimestre)]

    Ok pour le code de ta balise #TRIMESTRE :

    function balise_TRIMESTRE($p) {
      $date = champ_sql('date', $p);
      $p->code = "trimestre($date)";
      $p->interdire_scripts = false;
      return $p;  
    }

    Pour le critère d’une boucle, voici une solution :

    function critere_trimestre($idb, &$boucles, $crit) {
        $params = $crit->param;
        if (count($params) < 1)
              erreur_squelette(_T('zbug_info_erreur_squelette'), BOUCLE$idb : trimestre ?");
        $trimestre= array_shift($params);
        $trimestre = $trimestre[0]->texte;
        if (strpos($trimestre, '|')!=false) $op = "REGEXP \'$trimestre\'";
            $op = "REGEXP \'$trimestre\'";
            else $op = "= $trimestre";
        $boucle = &$boucles[$idb];
        $table = $boucle->id_table;
        $where = "quarter($table.date) $op";
        if ($crit->not) $where = "NOT($where)";
        $boucle->where[] = "'$where'";
    }

    Exemples :

        <BOUCLE_articles(ARTICLES) {trimestre 3}>
        ou : {trimestre 3|4}
        ou : {!trimestre 3}
        ou : {!trimestre 3|4}

    Mais tout ce binz peut-être aussi obtenu comme ceci :

        <BOUCLE_articles(ARTICLES) {quarter(date)=3}>
        ou : {quarter(date)==3|4}
        ou : {quarter(date)!=3}
        ou : {quarter(date)!==3|4}

    Répondre à ce message

Répondre à cet article

Qui êtes-vous ?

Pour afficher votre trombine avec votre message, enregistrez-la d’abord sur gravatar.com (gratuit et indolore) et n’oubliez pas d’indiquer votre adresse e-mail ici.

Ajoutez votre commentaire ici Les choses à faire avant de poser une question (Prolégomènes aux rapports de bugs. )
Ajouter un document

Retour en haut de la page

Ça discute par ici

  • LIM : alléger l’espace privé

    20 avril 2015 – 50 commentaires

    Ce plugin permet de désactiver l’affichage de blocs ou de boutons, présents par défaut dans SPIP mais qui peuvent devenir inutiles dans le cadre de votre projet. Il allège du coup l’interface d’édition et supprime d’éventuels risques de confusion dans (...)

  • Calendrier Mini 2.0

    19 mai 2012 – 254 commentaires

    Ce plugin ajoute la balise #CALENDRIER_MINI qui insère un petit widget de navigation par mois dans les dates des évènements. Fonctionnement du mini calendrier Le mini calendrier présente un mois à la fois. Les jours du mois comportant des (...)

  • Albums 3

    8 août 2014 – 283 commentaires

    Le plugin « Albums » évolue dans une version 3 pour SPIP 3. Avant d’effectuer une mise à jour depuis la version 1 ou 2, consultez les notes sur la rétro-compatibilité. Les modèles, notamment, on reçut quelques changements pour la bonne cause. En (...)

  • Acces Restreint 3.0

    11 décembre 2008 – 838 commentaires

    Le plugin accès restreint permet de définir et de gérer des zones de l’espace public en accès restreint. Cette version du plugin a été redévelopée et optimisée tout spécialement pour SPIP 2.0. Il en découle une amélioration des performances sur les gros (...)

  • Champs Extras 3

    16 janvier 2012 – 646 commentaires

    Ce plugin permet de créer et/ou de gérer des champs supplémentaires dans les objets éditoriaux de SPIP. Il permet donc de prendre en compte et d’afficher de nouveaux éléments dans n’importe quel objet éditorial de SPIP. Screencast Vous n’aimez pas (...)