Source for file loop.php

Documentation is available at loop.php

  1. <?php
  2.  
  3. /**
  4.  * Loops over an array and moves the scope into each value, allowing for shorter loop constructs
  5.  *
  6.  * Note that to access the array key within a loop block, you have to use the {$_key} variable,
  7.  * you can not specify it yourself.
  8.  * <pre>
  9.  *  * from : the array that you want to iterate over
  10.  *  * name : loop name to access it's iterator variables through {$.loop.name.var} see {@link http://wiki.dwoo.org/index.php/IteratorVariables} for details
  11.  * </pre>
  12.  * Example :
  13.  *
  14.  * instead of a foreach block such as :
  15.  *
  16.  * <code>
  17.  * {foreach $variable value}
  18.  *   {$value.foo} {$value.bar}
  19.  * {/foreach}
  20.  * </code>
  21.  *
  22.  * you can do :
  23.  *
  24.  * <code>
  25.  * {loop $variable}
  26.  *   {$foo} {$bar}
  27.  * {/loop}
  28.  * </code>
  29.  *
  30.  * This software is provided 'as-is', without any express or implied warranty.
  31.  * In no event will the authors be held liable for any damages arising from the use of this software.
  32.  *
  33.  * This file is released under the LGPL
  34.  * "GNU Lesser General Public License"
  35.  * More information can be found here:
  36.  * {@link http://www.gnu.org/copyleft/lesser.html}
  37.  *
  38.  * @author     Jordi Boggiano <[email protected]>
  39.  * @copyright  Copyright (c) 2008, Jordi Boggiano
  40.  * @license    http://www.gnu.org/copyleft/lesser.html  GNU Lesser General Public License
  41.  * @link       http://dwoo.org/
  42.  * @version    0.9.1
  43.  * @date       2008-05-30
  44.  * @package    Dwoo
  45.  */
  46. class Dwoo_Plugin_loop extends Dwoo_Block_Plugin implements Dwoo_ICompilable_Block
  47. {
  48.     public static $cnt=0;
  49.  
  50.     public function init($from, $name='default')
  51.     {
  52.     }
  53.  
  54.     public static function preProcessing(Dwoo_Compiler $compiler, array $params, $prepend, $append, $type)
  55.     {
  56.         $params = $compiler->getCompiledParams($params);
  57.         $tpl = $compiler->getTemplateSource(true);
  58.  
  59.         // assigns params
  60.         $src = $params['from'];
  61.         $name = $params['name'];
  62.  
  63.         // evaluates which global variables have to be computed
  64.         $varName = '$dwoo.loop.'.trim($name, '"\'').'.';
  65.         $shortVarName = '$.loop.'.trim($name, '"\'').'.';
  66.         $usesAny = strpos($tpl, $varName) !== false || strpos($tpl, $shortVarName) !== false;
  67.         $usesFirst = strpos($tpl, $varName.'first') !== false || strpos($tpl, $shortVarName.'first') !== false;
  68.         $usesLast = strpos($tpl, $varName.'last') !== false || strpos($tpl, $shortVarName.'last') !== false;
  69.         $usesIndex = $usesFirst || strpos($tpl, $varName.'index') !== false || strpos($tpl, $shortVarName.'index') !== false;
  70.         $usesIteration = $usesLast || strpos($tpl, $varName.'iteration') !== false || strpos($tpl, $shortVarName.'iteration') !== false;
  71.         $usesShow = strpos($tpl, $varName.'show') !== false || strpos($tpl, $shortVarName.'show') !== false;
  72.         $usesTotal = $usesLast || strpos($tpl, $varName.'total') !== false || strpos($tpl, $shortVarName.'total') !== false;
  73.  
  74.         // gets foreach id
  75.         $cnt = self::$cnt++;
  76.  
  77.         // builds pre processing output
  78.         $out = Dwoo_Compiler::PHP_OPEN . "\n".'$_loop'.$cnt.'_data = '.$src.';';
  79.         // adds foreach properties
  80.         if ($usesAny) {
  81.             $out .= "\n".'$this->globals["loop"]['.$name.'] = array'."\n(";
  82.             if ($usesIndex) $out .="\n\t".'"index"        => 0,';
  83.             if ($usesIteration) $out .="\n\t".'"iteration"        => 1,';
  84.             if ($usesFirst) $out .="\n\t".'"first"        => null,';
  85.             if ($usesLast) $out .="\n\t".'"last"        => null,';
  86.             if ($usesShow) $out .="\n\t".'"show"        => $this->isArray($_loop'.$cnt.'_data, true, true),';
  87.             if ($usesTotal) $out .="\n\t".'"total"        => $this->isArray($_loop'.$cnt.'_data) ? count($_loop'.$cnt.'_data) : 0,';
  88.             $out.="\n);\n".'$_loop'.$cnt.'_glob =& $this->globals["loop"]['.$name.'];';
  89.         }
  90.         // checks if foreach must be looped
  91.         $out .= "\n".'if ($this->isArray($_loop'.$cnt.'_data, true, true) === true)'."\n{";
  92.         // iterates over keys
  93.         $out .= "\n\t".'foreach ($_loop'.$cnt.'_data as $tmp_key => $this->scope["-loop-"])'."\n\t{";
  94.         // updates properties
  95.         if ($usesFirst) {
  96.             $out .= "\n\t\t".'$_loop'.$cnt.'_glob["first"] = (string) ($_loop'.$cnt.'_glob["index"] === 0);';
  97.         }
  98.         if ($usesLast) {
  99.             $out .= "\n\t\t".'$_loop'.$cnt.'_glob["last"] = (string) ($_loop'.$cnt.'_glob["iteration"] === $_loop'.$cnt.'_glob["total"]);';
  100.         }
  101.         $out .= "\n\t\t".'$_loop'.$cnt.'_scope = $this->setScope(array("-loop-"));' . "\n/* -- loop start output */\n".Dwoo_Compiler::PHP_CLOSE;
  102.  
  103.         // build post processing output and cache it
  104.         $postOut = Dwoo_Compiler::PHP_OPEN . "\n".'/* -- loop end output */'."\n\t\t".'$this->setScope($_loop'.$cnt.'_scope, true);';
  105.         // update properties
  106.         if ($usesIndex) {
  107.             $postOut.="\n\t\t".'$_loop'.$cnt.'_glob["index"]+=1;';
  108.         }
  109.         if ($usesIteration) {
  110.             $postOut.="\n\t\t".'$_loop'.$cnt.'_glob["iteration"]+=1;';
  111.         }
  112.         // end loop
  113.         $postOut .= "\n\t}\n}\n";
  114.  
  115.         // get block params and save the post-processing output already
  116.         $currentBlock =& $compiler->getCurrentBlock();
  117.         $currentBlock['params']['postOutput'] = $postOut . Dwoo_Compiler::PHP_CLOSE;
  118.  
  119.         return $out;
  120.     }
  121.  
  122.     public static function postProcessing(Dwoo_Compiler $compiler, array $params, $prepend, $append, $content)
  123.     {
  124.         return $content . $params['postOutput'];
  125.     }
  126. }

Documentation generated on Sun, 03 Aug 2008 15:12:41 +0200 by phpDocumentor 1.4.0