Source for file jTpl.class.php

Documentation is available at jTpl.class.php

  1. <?php
  2. /**
  3. @package     jelix
  4. @subpackage  jtpl
  5. @author      Laurent Jouanneau
  6. @contributor Dominique Papin
  7. @copyright   2005-2009 Laurent Jouanneau, 2007 Dominique Papin
  8. @link        http://www.jelix.org
  9. @licence     GNU Lesser General Public Licence see LICENCE file or http://www.gnu.org/licenses/lgpl.html
  10. */
  11.  
  12. /**
  13.  * template engine
  14.  * @package     jelix
  15.  * @subpackage  jtpl
  16.  */
  17. class jTpl {
  18.  
  19.  
  20.     /**
  21.      * all assigned template variables.
  22.      * It have a public access only for plugins. So you musn't use directly this property
  23.      * except from tpl plugins.
  24.      * See methods of jTpl to manage template variables
  25.      * @var array 
  26.      */
  27.     public $_vars = array ();
  28.  
  29.     /**
  30.      * temporary template variables for plugins.
  31.      * It have a public access only for plugins. So you musn't use directly this property
  32.      * except from tpl plugins.
  33.      * @var array 
  34.      */
  35.     public $_privateVars = array ();
  36.  
  37.     /**
  38.      * internal use
  39.      * It have a public access only for plugins. So you musn't use directly this property
  40.      * except from tpl plugins.
  41.      * @var array 
  42.      */
  43.     public $_meta = array();
  44.  
  45.     public function __construct ({
  46.         global $gJConfig;
  47.         $this->_vars['j_basepath'$gJConfig->urlengine['basePath'];
  48.         $this->_vars['j_jelixwww'$gJConfig->urlengine['jelixWWWPath'];
  49.         $this->_vars['j_jquerypath'$gJConfig->urlengine['jqueryPath'];
  50.         $this->_vars['j_themepath'$gJConfig->urlengine['basePath'].'themes/'.$gJConfig->theme.'/';
  51.         $this->_vars['j_locale'$gJConfig->locale;
  52.         $this->_vars['j_datenow'date('Y-m-d');
  53.         $this->_vars['j_timenow'date('H:i:s');
  54.     }
  55.  
  56.     /**
  57.      * assign a value in a template variable
  58.      * @param string|array$name the variable name, or an associative array 'name'=>'value'
  59.      * @param mixed  $value the value (or null if $name is an array)
  60.      */
  61.     public function assign ($name$value null{
  62.         if (is_array($name)) {
  63.             $this->_vars = array_merge($this->_vars$name);
  64.         else {
  65.             $this->_vars[$name$value;
  66.         }
  67.     }
  68.  
  69.     /**
  70.      * assign a value by reference in a template variable
  71.      * @param string $name the variable name
  72.      * @param mixed  $value the value
  73.      * @since jelix 1.1
  74.      */
  75.     public function assignByRef ($name$value{
  76.         $this->_vars[$name&$value;
  77.     }
  78.  
  79.     /**
  80.      * concat a value in with a value of an existing template variable
  81.      * @param string|array$name the variable name, or an associative array 'name'=>'value'
  82.      * @param mixed  $value the value (or null if $name is an array)
  83.      */
  84.     public function append ($name$value null{
  85.         if (is_array($name)) {
  86.             foreach ($name as $key => $val{
  87.                 if (isset($this->_vars[$key]))
  88.                     $this->_vars[$key.= $val;
  89.                 else
  90.                     $this->_vars[$key$val;
  91.             }
  92.         else {
  93.             if (isset($this->_vars[$name]))
  94.                 $this->_vars[$name.= $value;
  95.             else
  96.                 $this->_vars[$name$value;
  97.         }
  98.     }
  99.  
  100.     /**
  101.      * assign a value in a template variable, only if the template variable doesn't exist
  102.      * @param string|array$name the variable name, or an associative array 'name'=>'value'
  103.      * @param mixed  $value the value (or null if $name is an array)
  104.      */
  105.     public function assignIfNone ($name$value null{
  106.         if (is_array($name)) {
  107.             foreach ($name as $key => $val{
  108.                 if (!isset($this->_vars[$key]))
  109.                     $this->_vars[$key$val;
  110.             }
  111.         else {
  112.             if (!isset($this->_vars[$name]))
  113.                 $this->_vars[$name$value;
  114.         }
  115.     }
  116.  
  117.     /**
  118.      * assign a zone content to a template variable
  119.      * @param string $name the variable name
  120.      * @param string $zoneName  a zone selector
  121.      * @param array  $params  parameters for the zone
  122.      * @see jZone
  123.      */
  124.     function assignZone ($name$zoneName$params array()) {
  125.         $this->_vars[$namejZone::get ($zoneName$params);
  126.     }
  127.  
  128.     /**
  129.      * append a zone content to a template variable
  130.      * @param string $name the variable name
  131.      * @param string $zoneName  a zone selector
  132.      * @param array  $params  parameters for the zone
  133.      * @see jZone
  134.      * @since 1.0
  135.      */
  136.     function appendZone ($name$zoneName$params array()) {
  137.         if (isset($this->_vars[$name]))
  138.             $this->_vars[$name.= jZone::get ($zoneName$params);
  139.         else
  140.             $this->_vars[$namejZone::get ($zoneName$params);
  141.     }
  142.  
  143.     /**
  144.      * assign a zone content to a template variable only if this variable doesn't exist
  145.      * @param string $name the variable name
  146.      * @param string $zoneName  a zone selector
  147.      * @param array  $params  parameters for the zone
  148.      * @see jZone
  149.      */
  150.     function assignZoneIfNone ($name$zoneName$params array()) {
  151.         if (!isset($this->_vars[$name]))
  152.             $this->_vars[$namejZone::get ($zoneName$params);
  153.     }
  154.  
  155.     /**
  156.      * says if a template variable exists
  157.      * @param string $name the variable template name
  158.      * @return boolean true if the variable exists
  159.      */
  160.     public function isAssigned ($name{
  161.         return isset($this->_vars[$name]);
  162.     }
  163.  
  164.     /**
  165.      * return the value of a template variable
  166.      * @param string $name the variable template name
  167.      * @return mixed the value (or null if it isn't exist)
  168.      */
  169.     public function get ($name{
  170.         if (isset ($this->_vars[$name])) {
  171.             return $this->_vars[$name];
  172.         else {
  173.             $return null;
  174.             return $return;
  175.         }
  176.     }
  177.  
  178.     /**
  179.      * Return all template variables
  180.      * @return array 
  181.      */
  182.     public function getTemplateVars ({
  183.         return $this->_vars;
  184.     }
  185.  
  186.     /**
  187.      * process all meta instruction of a template
  188.      * @param string $tpl template selector
  189.      * @param string $outputtype the type of output (html, text etc..)
  190.      * @param boolean $trusted  says if the template file is trusted or not
  191.      */
  192.     public function meta ($tpl$outputtype ''$trusted true{
  193.         $sel new jSelectorTpl($tpl,$outputtype,$trusted);
  194.         $tpl $sel->toString();
  195.         if (in_array($tpl$this->processedMeta)) {
  196.             // we want to process meta only one time, when a template is included
  197.             // several time in an other template, or, more important, when a template
  198.             // is included in a recursive manner (in this case, it did cause infinite loop, see #1396). 
  199.             return;
  200.         }
  201.         $this->processedMeta[$tpl;
  202.         $md $this->getTemplate ($sel$outputtype$trusted);
  203.         $fct 'template_meta_'.$md;
  204.         $fct($this);
  205.  
  206.         return $this->_meta;
  207.     }
  208.  
  209.     /**
  210.      * display the generated content from the given template
  211.      * @param string $tpl template selector
  212.      * @param string $outputtype the type of output (html, text etc..)
  213.      * @param boolean $trusted  says if the template file is trusted or not
  214.      */
  215.     public function display ($tpl$outputtype ''$trusted true{
  216.         $sel new jSelectorTpl($tpl,$outputtype,$trusted);
  217.         $tpl $sel->toString();
  218.         $previousTpl $this->_templateName;
  219.         $this->_templateName = $tpl;
  220.         $this->recursiveTpl[$tpl;
  221.         $md $this->getTemplate ($sel$outputtype$trusted);
  222.         $fct 'template_'.$md;
  223.         $fct($this);
  224.         array_pop($this->recursiveTpl);
  225.         $this->_templateName = $previousTpl;
  226.     }
  227.  
  228.     /**
  229.      * contains the name of the template file
  230.      * It have a public access only for plugins. So you musn't use directly this property
  231.      * except from tpl plugins.
  232.      * @var string 
  233.      * @since 1.1
  234.      */
  235.     public $_templateName;
  236.  
  237.     protected $recursiveTpl = array();
  238.     protected $processedMeta = array();
  239.  
  240.     /**
  241.      * include the compiled template file and call one of the generated function
  242.      * @param string|jSelectorTpl$tpl template selector
  243.      * @param string $outputtype the type of output (html, text etc..)
  244.      * @param boolean $trusted  says if the template file is trusted or not
  245.      * @return string the suffix name of the function to call
  246.      */
  247.     protected function getTemplate ($tpl$outputtype ''$trusted true{
  248.         $tpl->userModifiers $this->userModifiers;
  249.         $tpl->userFunctions $this->userFunctions;
  250.         jIncluder::inc($tpl);
  251.         return md5($tpl->module.'_'.$tpl->resource.'_'.$tpl->outputType.($trusted?'_t':''));
  252.     }
  253.  
  254.     /**
  255.      * return the generated content from the given template
  256.      * @param string $tpl template selector
  257.      * @param string $outputtype the type of output (html, text etc..)
  258.      * @param boolean $trusted  says if the template file is trusted or not
  259.      * @param boolean $callMeta false if meta should not be called
  260.      * @return string the generated content
  261.      */
  262.     public function fetch ($tpl$outputtype=''$trusted true$callMeta=true{
  263.         $content '';
  264.         ob_start ();
  265.         try{
  266.             $sel new jSelectorTpl($tpl$outputtype$trusted);
  267.             $tpl $sel->toString();
  268.             $previousTpl $this->_templateName;
  269.             $this->_templateName = $tpl;
  270.             $this->processedMeta[$tpl;
  271.             $this->recursiveTpl[$tpl;
  272.             $md $this->getTemplate ($sel$outputtype$trusted);
  273.             if ($callMeta{
  274.                 $fct 'template_meta_'.$md;
  275.                 $fct($this);
  276.             }
  277.             $fct 'template_'.$md;
  278.             $fct($this);
  279.             array_pop($this->recursiveTpl);
  280.             $this->_templateName = $previousTpl;
  281.             $content ob_get_clean();
  282.  
  283.         catch(Exception $e{
  284.             ob_end_clean();
  285.             throw $e;
  286.         }
  287.         return $content;
  288.     }
  289.  
  290.     protected $userModifiers = array();
  291.  
  292.     /**
  293.      * register a user modifier. The function should accept at least a
  294.      * string as first parameter, and should return this string
  295.      * which can be modified.
  296.      * @param string $name  the name of the modifier in a template
  297.      * @param string $functionName the corresponding PHP function
  298.      * @since jelix 1.1
  299.      */
  300.     public function registerModifier ($name$functionName{
  301.         $this->userModifiers[$name$functionName;
  302.     }
  303.  
  304.     protected $userFunctions = array();
  305.  
  306.     /**
  307.      * register a user function. The function should accept a jTpl object
  308.      * as first parameter.
  309.      * @param string $name  the name of the modifier in a template
  310.      * @param string $functionName the corresponding PHP function
  311.      * @since jelix 1.1
  312.      */
  313.     public function registerFunction ($name$functionName{
  314.         $this->userFunctions[$name$functionName;
  315.     }
  316.  
  317.     /**
  318.      * return the current encoding
  319.      * @return string the charset string
  320.      * @since 1.0b2
  321.      */
  322.     public static function getEncoding ({
  323.         return $GLOBALS['gJConfig']->charset;
  324.     }
  325.  
  326. }

Documentation generated on Mon, 19 Sep 2011 14:13:41 +0200 by phpDocumentor 1.4.3