<?php /**************************************************************************\ * phpGroupWare API - Template class * * (C) Copyright 1999-2000 NetUSE GmbH Kristian Koehntopp * * ------------------------------------------------------------------------ * * This is not part of phpGroupWare, but is used by phpGroupWare. * * http://www.phpgroupware.org/ * * ------------------------------------------------------------------------ * * This program is free software; you can redistribute it and/or modify it * * under the terms of the GNU Lesser General Public License as published * * by the Free Software Foundation; either version 2.1 of the License, or * * any later version. * \**************************************************************************/ /* $Id$ */ 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 = ''; var $oldroot = ''; /* $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 = ''; var $print = False; /***************************************************************************/ /* public: Constructor. * root: template directory. * unknowns: how to handle unknown variables. */ function Template($root = '.', $unknowns = 'remove') { if(@isset($GLOBALS['phpgw_info']['flags']['printview']) && $GLOBALS['phpgw_info']['flags']['printview'] == True) { $this->print = True; } $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->oldroot = $this->root; $this->root = $root; return True; } function reset_root() { $this->root = $this->oldroot; } /* 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 { reset($handle); while(list($h, $f) = each($handle)) { $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); $this->set_var($name, $m[1][0]); } /* 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 = '', $append=False) { if (!is_array($varname)) { if (!empty($varname)) { if ($this->debug) { print "scalar: set *$varname* to *$value*<br>\n"; } $this->varkeys[$varname] = $this->varname($varname); if ($append) { $this->varvals[$varname] = $this->get_var($varname).$value; } else { $this->varvals[$varname] = $value; } } } else { reset($varname); while(list($k, $v) = each($varname)) { if (!empty($k)) { if ($this->debug) { print "array: set *$k* to *$v*<br>\n"; } $this->varkeys[$k] = $this->varname($k); if ($append) { $this->varvals[$k] = $this->get_var($k).$v; } else { $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); reset($this->varkeys); while (list($k, $v) = each($this->varkeys)) { $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); $this->set_var($target, $str, $append); } else { reset($handle); while(list($i, $h) = each($handle)) { $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() { reset($this->varkeys); while(list($k, $v) = each($this->varkeys)) { $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); while(list($k, $v) = each($varname)) { $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; } reset($m); while(list($k, $v) = each($m)) { 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; } /* If they want NOGIF policy, then I do a global replace */ if (@$GLOBALS['phpgw_info']['server']['image_type'] == 2) { $str = str_replace ('.gif','.png',$str); } 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 ($this->print && $time!=2 && $time!=4) { $new_filename = $new_filename.'_print'; } if (!file_exists($new_filename)) { switch($time) { case 2: $new_root = str_replace($GLOBALS['phpgw_info']['server']['template_set'],'default',$root); $new_filename = $this->filename($filename,$new_root,3); break; case 3: $new_filename = $this->filename($filename,$root,4); break; case 4: $this->halt("filename: file $new_filename does not exist."); break; default: if (!$this->print) { $new_root = str_replace($GLOBALS['phpgw_info']['server']['template_set'],'default',$root); $new_filename = $this->filename(str_replace($root.'/','',$new_filename),$new_root,4); } else { $new_filename = $this->filename($filename,$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(); } /* public, override: haltmsg($msg) * msg: error message to show. */ function haltmsg($msg) { printf("<b>Template Error:</b> %s<br>\n", $msg); } }