phpgroupware-cvs
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[Phpgroupware-cvs] phpgwapi/inc/class.Template.inc.php, 1.34


From: nomail
Subject: [Phpgroupware-cvs] phpgwapi/inc/class.Template.inc.php, 1.34
Date: Thu, 30 Dec 2004 07:47:30 +0100

Update of /phpgwapi/inc
Added Files:
        Branch: 
          class.Template.inc.php

date: 2004/12/30 06:47:30;  author: skwashd;  state: Exp;  lines: +41 -36

Log Message:
new HEAD
=====================================================================
<?php
        /**
        * Template class
        * @author Kristian Koehntopp
        * @author Dan Kuykendall
        * @copyright Copyright (C) 1999,2000 NetUSE GmbH Kristian Koehntopp
        * @copyright Portions Copyright (C) 2001-2004 Free Software Foundation, 
Inc. http://www.fsf.org/
        * @license http://www.fsf.org/licenses/lgpl.html GNU Lesser General 
Public License
        * @package phpgwapi
        * @subpackage gui
        * @version $Id: class.Template.inc.php,v 1.34 2004/12/30 06:47:30 
skwashd Exp $
        * @internal Based on phplib
        */

        /**
        * Template class
        * 
        * @package phpgwapi
        * @subpackage gui
        */
        class Template
        {
                var $classname = 'Template';

                /* if set, echo assignments */
                var $debug = False;

                /* $file[handle] = 'filename'; */
                var $file = array();

                /* relative filenames are relative to this pathname */
                var $root = '';

                /* $varkeys[key] = 'key'; $varvals[key] = 'value'; */
                var $varkeys = array();
                var $varvals = array();

                /* 'remove'  => remove undefined variables
                 * 'comment' => replace undefined variables with comments
                 * 'keep'    => keep undefined variables
                 */
                var $unknowns = 'remove';

                /* 'yes' => halt, 'report' => report error, continue, 'no' => 
ignore error quietly */
                var $halt_on_error = 'yes';

                /* last error message is retained here */
                var $last_error = '';

                
/***************************************************************************/
                /* public: Constructor.
                 * root:     template directory.
                 * unknowns: how to handle unknown variables.
                 */
                function Template($root = '.', $unknowns = 'remove')
                {
                        $this->set_root($root);
                        $this->set_unknowns($unknowns);
                }

                /* public: setroot(pathname $root)
                 * root:   new template directory.
                 */
                function set_root($root)
                {
                        if (!is_dir($root))
                        {
                                $this->halt("set_root: $root is not a 
directory.");
                                return false;
                        }
                        $this->root = $root;
                        return true;
                }

                /* public: set_unknowns(enum $unknowns)
                 * unknowns: 'remove', 'comment', 'keep'
                 *
                 */
                function set_unknowns($unknowns = 'keep')
                {
                        $this->unknowns = $unknowns;
                }

                /* public: set_file(array $filelist)
                 * filelist: array of handle, filename pairs.
                 *
                 * public: set_file(string $handle, string $filename)
                 * handle: handle for a filename,
                 * filename: name of template file
                 */
                function set_file($handle, $filename = '')
                {
                        if (!is_array($handle))
                        {
                                if ($filename == '')
                                {
                                        $this->halt("set_file: For handle 
$handle filename is empty.");
                                        return false;
                                }
                                $this->file[$handle] = 
$this->filename($filename);
                        }
                        else
                        {
                                foreach($handle as $h => $f)
                                {
                                        $this->file[$h] = $this->filename($f);
                                }
                        }
                }

                /* public: set_block(string $parent, string $handle, string 
$name = '')
                 * extract the template $handle from $parent, 
                 * place variable {$name} instead.
                 */
                function set_block($parent, $handle, $name = '')
                {
                        if (!$this->loadfile($parent))
                        {
                                $this->halt("subst: unable to load $parent.");
                                return false;
                        }
                        if ($name == '')
                        {
                                $name = $handle;
                        }
                        $str = $this->get_var($parent);
                        $reg = "/<!--\s+BEGIN $handle\s+-->(.*)\n\s*<!--\s+END 
$handle\s+-->/sm";
                        preg_match_all($reg, $str, $m);
                        $str = preg_replace($reg, '{' . "$name}", $str);
                        $this->set_var($handle, $m[1][0]);
                        $this->set_var($parent, $str);
                }

                /* public: set_var(array $values)
                 * values: array of variable name, value pairs.
                 *
                 * public: set_var(string $varname, string $value)
                 * varname: name of a variable that is to be defined
                 * value:   value of that variable
                 */
                function set_var($varname, $value = '')
                {
                        if (!is_array($varname))
                        {
                                if (!empty($varname))
                                {
                                        if ($this->debug)
                                        {
                                                print "scalar: set *$varname* 
to *$value*<br>\n";
                                        }
                                        $this->varkeys[$varname] = 
$this->varname($varname);
                                        $this->varvals[$varname] = $value;
                                }
                        }
                        else
                        {
                                foreach($varname as $k => $v)
                                {
                                        if (!empty($k))
                                        {
                                                if ($this->debug)
                                                {
                                                        print "array: set *$k* 
to *$v*<br>\n";
                                                }
                                                $this->varkeys[$k] = 
$this->varname($k);
                                                $this->varvals[$k] = $v;
                                        }
                                }
                        }
                }

                /* public: subst(string $handle)
                 * handle: handle of template where variables are to be 
substituted.
                 */
                function subst($handle)
                {
                        if (!$this->loadfile($handle))
                        {
                                $this->halt("subst: unable to load $handle.");
                                return false;
                        }

                        $str = $this->get_var($handle);
                        
                        if( !is_array($this->varkeys) )
                        {
                                return $str;
                        }
                        
                        foreach($this->varkeys as $k => $v)
                        {
                                $str = str_replace($v, $this->varvals[$k], 
$str);
                        }
                        return $str;
                }

                /* public: psubst(string $handle)
                 * handle: handle of template where variables are to be 
substituted.
                 */
                function psubst($handle)
                {
                        print $this->subst($handle);
                        return false;
                }

                /* public: parse(string $target, string $handle, boolean append)
                 * public: parse(string $target, array  $handle, boolean append)
                 * target: handle of variable to generate
                 * handle: handle of template to substitute
                 * append: append to target handle
                 */
                function parse($target, $handle, $append = false)
                {
                        if (!is_array($handle))
                        {
                                $str = $this->subst($handle);
                                if ($append)
                                {
                                        $this->set_var($target, 
$this->get_var($target) . $str);
                                }
                                else
                                {
                                        $this->set_var($target, $str);
                                }
                        }
                        else
                        {
                                foreach($handle as $i => $h)
                                {
                                        $str = $this->subst($h);
                                        $this->set_var($target, $str);
                                }
                        }
                        return $str;
                }

                function pparse($target, $handle, $append = false)
                {
                        print $this->parse($target, $handle, $append);
                        return false;
                }

                /* This is short for finish parse */
                function fp($target, $handle, $append = False)
                {
                        return $this->finish($this->parse($target, $handle, 
$append));
                }

                /* This is a short cut for print finish parse */
                function pfp($target, $handle, $append = False)
                {
                        echo $this->finish($this->parse($target, $handle, 
$append));
                }

                /* public: get_vars()
                 */
                function get_vars()
                {
                        if( !is_array($this->varkeys) )
                        {
                                $this->varkeys = array();
                        }
                        
                        foreach($this->varkeys as $k => $v)
                        {
                                $result[$k] = $this->varvals[$k];
                        }
                        return $result;
                }

                /* public: get_var(string varname)
                 * varname: name of variable.
                 *
                 * public: get_var(array varname)
                 * varname: array of variable names
                 */
                function get_var($varname)
                {
                        if (!is_array($varname))
                        {
                                return $this->varvals[$varname];
                        }
                        else
                        {
                                reset($varname);
                                foreach($varname as $k => $v)
                                {
                                        $result[$k] = $this->varvals[$k];
                                }
                                return $result;
                        }
                }

                /* public: get_undefined($handle)
                 * handle: handle of a template.
                 */
                function get_undefined($handle)
                {
                        if (!$this->loadfile($handle))
                        {
                                $this->halt("get_undefined: unable to load 
$handle.");
                                return false;
                        }

                        preg_match_all("/\{([^}]+)\}/", 
$this->get_var($handle), $m);
                        $m = $m[1];
                        if (!is_array($m))
                        {
                                return false;
                        }
                        foreach($m as $k => $v)
                        {
                                if (!isset($this->varkeys[$v]))
                                {
                                        $result[$v] = $v;
                                }
                        }

                        if (count($result))
                        {
                                return $result;
                        }
                        else
                        {
                                return false;
                        }
                }

                /* public: finish(string $str)
                 * str: string to finish.
                 */
                function finish($str)
                {
                        switch ($this->unknowns)
                        {
                                case 'keep':
                                        break;
                                case 'remove':
                                        $str = preg_replace('/{[^ \t\r\n}]+}/', 
'', $str);
                                        break;
                                case 'comment':
                                        $str = preg_replace('/{([^ 
\t\r\n}]+)}/', "<!-- Template $handle: Variable \\1 undefined -->", $str);
                                        break;
                        }

                        return $str;
                }

                /* public: p(string $varname)
                 * varname: name of variable to print.
                 */
                function p($varname)
                {
                        print $this->finish($this->get_var($varname));
                }

                function get($varname)
                {
                        return $this->finish($this->get_var($varname));
                }

                
/***************************************************************************/
                /* private: filename($filename)
                 * filename: name to be completed.
                 */
                function filename($filename,$root='',$time=1)
                {
                        if($root=='')
                        {
                                $root=$this->root;
                        }
                        if (substr($filename, 0, 1) != '/')
                        {
                                $new_filename = $root.'/'.$filename;
                        }
                        else
                        {
                                $new_filename = $filename;
                        }

                        if (!file_exists($new_filename))
                        {
                                if($time==2)
                                {
                                        $this->halt("filename: file 
$new_filename does not exist.");
                                }
                                else
                                {
                                        $new_root = 
str_replace($GLOBALS['phpgw_info']['server']['template_set'],'simple',$root);
                                        $new_filename = 
$this->filename(str_replace($root.'/','',$new_filename),$new_root,2);
                                }
                        }
                        return $new_filename;
                }

                /* private: varname($varname)
                 * varname: name of a replacement variable to be protected.
                 */
                function varname($varname)
                {
                        return '{'.$varname.'}';
                }

                /* private: loadfile(string $handle)
                 * handle:  load file defined by handle, if it is not loaded 
yet.
                 */
                function loadfile($handle)
                {
                        if (isset($this->varkeys[$handle]) and 
!empty($this->varvals[$handle]))
                        {
                                return true;
                        }
                        if (!isset($this->file[$handle]))
                        {
                                $this->halt("loadfile: $handle is not a valid 
handle.");
                                return false;
                        }
                        $filename = $this->file[$handle];

                        $str = implode('', @file($filename));
                        if (empty($str))
                        {
                                $this->halt("loadfile: While loading $handle, 
$filename does not exist or is empty.");
                                return false;
                        }

                        $this->set_var($handle, $str);
                        return true;
                }

                
/***************************************************************************/
                /* public: halt(string $msg)
                 * msg:    error message to show.
                 */
                function halt($msg)
                {
                        $this->last_error = $msg;

                        if ($this->halt_on_error != 'no')
                        {
                                $this->haltmsg($msg);
                        }

                        if ($this->halt_on_error == 'yes')
                        {
                                echo('<b>Halted.</b>');
                        }

                        $GLOBALS['phpgw']->common->phpgw_exit(True);
                }

                /* public, override: haltmsg($msg)
                 * msg: error message to show.
                 */
                function haltmsg($msg)
                {
                        printf("<b>Template Error:</b> %s<br>\n", $msg);
                }
        }




reply via email to

[Prev in Thread] Current Thread [Next in Thread]