Changeset 241

Timestamp:

09/29/08 08:14:33 (15 years ago)

Author:

kozlika

Message:

Add all template functions I know + an icon

Location:

plugins/moreTpl

Files:

• _define.php (modified) (1 diff)
• _public.php (modified) (9 diffs)
• icon.png (added)

plugins/moreTpl/_define.php

@@ -14 +14 @@
         /* Name */                      "MoreTpl",
         /* Description*/                "More template markers for your themes",
-        /* Author */                    "Kozlika",
-        /* Version */                   '0.6',
+        /* Author */                    "Kozlika and contributors",
+        /* Version */                   '0.7',
         /* Permissions */               'usage,contentadmin'
 );

plugins/moreTpl/_public.php

@@ -1 +1 @@
 <?php
+
 # -- BEGIN LICENSE BLOCK ----------------------------------
 #
@@ -11 +12 @@
 # -- END LICENSE BLOCK ------------------------------------
 
+if (!defined('DC_RC_PATH')) { 
+     return; 
+     }
+
+$core->tpl->addBlock('EntryIfPosition',array('tplMoreTpl','EntryIfPosition'));
 $core->tpl->addValue('EntryExcerptAndContent',array('tplMoreTpl','EntryExcerptAndContent'));
 $core->tpl->addValue('EntryCategoryShortURL',array('tplMoreTpl','EntryCategoryShortURL'));
@@ -17 +23 @@
 $core->tpl->addValue('EntryTrackbackCountDigit',array('tplMoreTpl','EntryTrackbackCountDigit'));
 $core->tpl->addValue('TagEntriesCount',array('tplmoreTpl','TagEntriesCount'));
+$core->tpl->addValue('CoreVersion',array('tplMyMoreTpl','CoreVersion'));
+$core->tpl->addValue('MetaSeparator',array('tplMyMoreTpl','MetaSeparator'));
+$core->tpl->addValue('EntryUpdate',array('tplMyMoreTpl','EntryUpdate'));
+$core->tpl->addBlock('PrevOrNextEntries',array('tplMyMoreTpl','PrevOrNextEntries'));
+
 
 class tplMoreTpl
 {
-     /*
+     /**
+     Fonction interne, ne peut pas être utilisée directement depuis le template
+     
+     @param    str       <b>string</b>       String to parse
+     @param    var       <b>string</b>       Tested variable name
+     @return   <b>string</b>
+     */
+     public static function testInExpr($str,$var)
+     {
+          $or = array();
+          foreach (explode(',',$str) as $v)
+          {
+               $v = trim($v);
+               $and = explode(' ',$v);
+               foreach ($and as $k_=>$v_)
+               {
+                    $v_ = trim($v_);
+                    $neg = false;
+                    $op = '==';
+                    
+                    # Not
+                    if (preg_match('/^!/',$v_)) {
+                         $v_ = substr($v_,1);
+                         $neg = true;
+                         $op = '!=';
+                    }
+                    
+                    # Number specification
+                    if (preg_match('/^[1-9][0-9]*$/',$v_,$m)) {
+                         $nb = (integer) $m[0];
+                         $res = $var.$op.$nb;
+                         $neg = false;
+                    }
+                    # Interval specification
+                    elseif (preg_match('/^([1-9][0-9]*)-([1-9][0-9]*)?$/',$v_,$m)) {
+                         $n1 = (integer) $m[1];
+                         if (isset($m[2])) {
+                              $n2 = (integer) $m[2];
+                              if ($n1 > $n2) {
+                                   list($n1,$n2) = array($n2,$n1);
+                              }
+                              $res = $var.'>='.$n1.' && '.$var.'<='.$n2;
+                         } else {
+                              $res = $var.'>='.$n1.'';
+                         }
+                    }
+                    # Step specification
+                    elseif (preg_match('#^/([1-9][0-9]*)(?:\+([0-9]+))?$#',$v_,$m)) {
+                         $n1 = (integer) $m[1];
+                         if (isset($m[2])) {
+                              $n2 = (integer) $m[2];
+                              $res = '('.$var.'-'.$n2.')%'.$n1.$op.'0';
+                         } else {
+                              $res = $var.'%'.$n1.$op.'0';
+                         }
+                         $neg = false;
+                    }
+                    # Odd items
+                    elseif ($v_ == 'odd') {
+                         $res = $var.'&1';
+                    }
+                    # Invalid format : cancel current alternative
+                    else {
+                         $res = 'false';
+                         $neg = false;
+                    }
+                    
+                    $res = ($neg ? '!' : '').'('.$res.')';
+                    $and[$k_] = $res;
+               }
+               $or[] = implode(' && ',$and);
+          }
+          
+          return implode(' || ',$or);
+     }
+
+     /**
+     Cette fonction vérifie la position du billet (1er, 2ème, 3ème, etc.)
+     par rapport à l'argument "is" spécifié, qui contient la liste des
+     positions acceptées, séparées par des virgules.
+     
+     Lisez la documentation en ligne pour plus de détails sur la syntaxe à
+     utiliser.
+     
+     Utilisation : <tpl:EntryIfPosition is="x,y,a-b odd,!z,/n+m">
+     */
+     public static function EntryIfPosition($attr,$content)
+     {
+          $is = isset($attr['is']) ? trim($attr['is']) : '';
+          $expr = self::testInExpr($is,'$idx');
+          return
+          '<?php $idx = $_ctx->posts->index()+1; if ('.$expr.'): ?>'.
+          $content.
+          '<?php endif; unset($idx); ?>';
+     }
+          
+     /**
      Cette fonction recueille le contenu du post_chapo et du post_content
      (par exemple pour lui appliquer un cut_string ou afficher le premier billet in extenso)
@@ -38 +145 @@
      }
 
-     /*
+     /**
      Cette fonction affiche le nom "URL" de la categorie dans le contexte d'un billet
      (par exemple pour affecter une class dans la div post)
@@ -51 +158 @@
      }
 
-     /*
-     Cette fonction affiche en chiffres le nombre de bilets d'une catégorie (en chiffres)
+     /**
+     Cette fonction affiche en chiffres le nombre de bilets d'une catégorie
      (par exemple pour le content-info de category.html)
      Utilisation : {{tpl:CategoryEntriesCount}} -> 3
@@ -64 +171 @@
      }
 
-     /*
+     /**
      Cette fonction affiche le nombre de commentaires en chiffres et sans mention
      Utilisation : {{tpl:EntryCommentCountDigit}} -> 4
@@ -94 +201 @@
      }
 
-     /*
+     /**
      Cette fonction affiche le nombre de trackbacks en chiffres
      Utilisation : {{tpl:EntryTrackbackCountDigit}} -> 2
@@ -123 +230 @@
           "} ?>";
      }
-
-     /*
+     /**
      Cette fonction affiche le nombre de billets correspondant à un tag
      Utilisation (dans la page tags.html, tag.html ou une boucle <tpl:Metadata>) :
      {{tpl:TagEntriesCount}} -> 12
-     */
+     */   
      public static function TagEntriesCount($attr)
      {
@@ -135 +241 @@
          return '<?php echo '.sprintf($f, $n).'; ?>';
      }
+     /**
+          CoreVersion
+
+          Cette fonction affiche la version du noyau Dotclear d'après le champ core de la table version
+          (par exemple pour préciser la version après "Propulsé par Dotclear")
+          Utilisation : {{tpl:CoreVersion}} -> 2.0 RC1
+          */
+          public static function CoreVersion($attr)
+          {
+               $f = $GLOBALS['core']->tpl->getFilters($attr);
+
+               return
+               '<?php echo '.sprintf($f,'$GLOBALS["core"]->getVersion()').'; ?>';
+          }
+
+          /**
+          MetaSeparator
+
+          Cette fonction affiche un séparateur (qui peut être spécifié en paramètre) entre
+          les tags d'un billet. Cela permet par exemple d'utiliser une virgule comme
+          séparateur de tags et de ne pas avoir une virgule superflue qui traîne après
+          le dernier tag.
+
+          Paramètre du tag :
+            - separator : indique le texte à utiliser comme séparateur (valeur par défaut : ' - ')
+
+          Exemples d'utilisation :
+
+          Le bloc de code :
+            <tpl:EntryMetaData><a href="{{tpl:MetaURL}}">{{tpl:MetaID}}</a>{{tpl:MetaSeparator}}</tpl:EntryMetaData>
+          affiche une liste de tous les tags du billet en les séparant simplement par un tiret.
+          */
+          public static function MetaSeparator($attr)
+          {
+               $ret = isset($attr['separator']) ? $attr['separator'] : ' - ';
+               $ret = html::escapeHTML($ret);
+               return '<?php if (! $_ctx->meta->isEnd()) { ' . "echo '".addslashes($ret)."'; } ?>";
+          }
+
+          /**
+          EntryUpdate
+
+          Cette fonction affiche la date et l'heure de la dernière mise à jour du billet
+          Le format d'affichage répond à la syntaxe de la fonction strftime():
+               http://fr.php.net/manual/fr/function.strftime.php 
+
+          Exemples d'utilisation :
+
+          {{tpl:EntryUpdateDate}} affichera "date_format, time_format"
+          où date_format et time_format sont les formats de l'affichage de
+          la date et de l'heure définis dans les "Paramètres du blog" 
+
+          {{tpl:lang Last update :}} {{tpl:EntryUpdate format="%A %e %B %Y, %H:%M:%S"}}
+          affichera :
+          "Dernière mise à jour : vendredi 30 novembre 2007, 16:53:05"
+          */
+          $GLOBALS['__l10n']['Last update :'] = 'Dernière mise à jour :';
+          public static function EntryUpdate($attr)
+          {
+               global $core;
+
+               $format = (!empty($attr['format'])) ? $attr['format'] : 
+                    $core->blog->settings->date_format.', '.$core->blog->settings->time_format; 
+               $f = $GLOBALS['core']->tpl->getFilters($attr);
+
+               return('<?php echo '.'dt::dt2str(\''.$format.'\','.sprintf($f,'$_ctx->posts->post_upddt').
+                    ',\''.$core->blog->settings->blog_timezone.'\'); ?>');
+          }
+
+          /**
+          PrevOrNextEntries
+
+          Cette fonction crée un bloc balise pour le template post.html qui permet d'afficher les x billets précédant ou suivant le billet courant. Possibilité de filtrer par langue, catégorie et de définir le nombre de résultats à retourner
+
+          Utilisation : <tpl:PrevOrNextEntries>[...]</tpl:PrevOrNextEntries>
+
+          Paramètres :
+          - Option "cat" accepte 0 pour exécuter la requête sur tous les posts ou 1 pour que ce ne soit que des billets de la même catégorie que le post en cours qui s'affichent => défaut 0
+          - Option "lng" (pour les blogs multilangues) accepte 0 pour trier tous les posts de toutes les langues ou 1 pour les billets de la même langue que le post en cours => défaut 0
+          - Option "dir" accepte 0 pour les x posts précédents ou 1 pour les x posts suivants => défaut 0
+          - Option "qty" accepte une valeur numérique qui correspondra au nombre de posts retournés par DC (dans la limite du nb total de posts publiés sans password) => défaut 2
+
+          Précision :
+          - Les 4 options sont utilisables simultanément vous pouvez donc afficher le billet suivant rédigé dans la même langue et publié dans la même catégorie à l'aide du code suivant :
+          - Si vous souhaitez utiliser la valeur par défaut de l'option, il est inutile, et même recommandé dans une démarche d'optimisation, de ne pas utiliser cet argument. Par exemple si vous souhaitez afficher les deux billets précédents parmi toutes les catégories et toutes les langues, le bloc de base indiqué dans "Utilisation" est suffisant.
+          */
+
+          public function PrevOrNextEntries($attr,$content)
+               {
+                    function getPrevOrNextPosts($post,$cat,$lng,$dir,$qty)
+                    {
+                    global $core;
+                    if($cat==1) { $params['sql'] = $post->cat_id ? ' AND P.cat_id = '.$post->cat_id : ' AND P.cat_id IS NULL'; }
+                    if($lng==1) { $params['sql'] .= $post->post_lang ? ' AND P.post_lang = \''.$core->con->escape($post->post_lang).'\'' : ' AND P.post_lang IS NULL'; }
+                    if($dir==1) { $sign='>'; $order='ASC'; } else { $sign='<'; $order='DESC'; }
+                    $dt = $post->post_dt; $post_id = $post->post_id;
+                    $params['post_type'] = $post->post_type; $params['limit'] = $qty;  $params['order'] = 'post_dt '.$order.', P.post_id '.$order;
+                    $params['sql'] .= ' AND ((post_dt = \''.$core->con->escape($dt).'\' AND P.post_id '.$sign.' '.$post_id.') OR post_dt '.$sign.' \''.$core->con->escape($dt).'\') ';
+                    $rs = $core->blog->getPosts($params);
+                    if ($rs->isEmpty()) {
+                    return null;
+                    }
+
+                    return $rs;
+                    }
+
+                         $cat = !empty($attr['cat']) ? $attr['cat'] : '0';
+                         $lng = !empty($attr['lng']) ? $attr['lng'] : '0';
+                         $dir = !empty($attr['dir']) ? $attr['dir'] : '0';
+                         $qty = !empty($attr['qty']) ? $attr['qty'] : '2';
+                         return '<?php $prev_post = getPrevOrNextPosts($_ctx->posts,'.$cat.','.$lng.','.$dir.','.$qty.'); ?>'."\n".
+                         '<?php if ($prev_post !== null) : ?>'.
+
+                              '<?php $_ctx->posts = $prev_post; unset($prev_post);'."\n".
+                              'while ($_ctx->posts->fetch()) : ?>'.
+                              $content.
+                              '<?php endwhile; $_ctx->posts = null; ?>'.
+                         "<?php endif; ?>\n";
+               }
+
 }
 ?>