keyval = array('' => '~'); # so that ~~ in the template creates a single ~ $this->sub_templates = array(); } # set a key/value pair. if a ~tag~ in the template matches key it will be replaced by value function set($key, $value) { $this->keyval[$key] = $value; } # clear a value. Functionally equivalent to set($key, '') but cleaner and more efficient function clear($key) { unset($this->keyval[$key]); } # grab a value you stuck in earlier with set() function get($key) { return $this->keyval[$key]; } # run the template engine on one of the sub-templates and append the result # to the keyval in the main array. See tem_test.php for an example of how # this can be used. function sub($sub_template_name) { $this->keyval[$sub_template_name] .= template_run($this->sub_templates[$sub_template_name], $this->keyval); # after running a sub-template, clear its sub-templates if(isset($this->sub_subs[$sub_template_name])) { foreach($this->sub_subs[$sub_template_name] as $sub_sub) { $this->clear($sub_sub); } } } # this is used by tem::load() and should be otherwise useless function _load(&$in, &$out, &$parents, &$parent) { while($in) { # scan for one of: 1) the begining of a sub-template 2) the end of this one 3) the end of the file $n = strpos($in, '', substr($in, 0, 12)) == 0) { $in = substr($in, 12); $parent = array_pop($parents); return; } $matches = array(); # this limits sub_template names to 50 chars if(ereg('^', substr($in, 0, 65), $matches)) { list($start_tag, $tag_name) = $matches; # keep track of the tree if(!isset($this->sub_subs[$parent])) { $this->sub_subs[$parent] = array(); } array_push($this->sub_subs[$parent], $tag_name); array_push($parents, $parent); $parent = $tag_name; $out .= '~' . $tag_name . '~'; $in = substr($in, strlen($start_tag)); $this->sub_templates[$tag_name] = ''; $this->_load($in, $this->sub_templates[$tag_name], $parents, $parent); } else { # it's not a start tag or end tag, so let's pass it through: $out .= substr($in, 0, 5); $in = substr($in, 5); } } #repeat } # like load() except you pass a string instead of a filename function load_str($str) { $this->template = ''; $parents = array('top_level_subs' => array()); $parent = 'top_level_subs'; $this->_load($str, $this->template, $parents, $parent); } # This is useful when you have sub-templates that you want to mess with # before the main template is run. But can also be used to simply specify # the filename ahead of time. function load($filename) { $this->filename = $filename; $this->load_str(read_whole_file($filename)); } # Run the template. Pass a filename, or a string, unless you've already # specified a template with load() function run($templ = false) { $template_string = $this->template; $template_file = $this->file; if($templ !== false) { if(strlen($templ) < 150 && file_exists($templ)) { $template_file = $templ; unset($template_string); } else { $template_string = $templ; } } if(!$template_string) { if(!$template_file) { print "sorry, no template to run\n"; exit(1); } $template_string = read_whole_file($template_file); } return template_run($template_string, $this->keyval); } # same as run() except the output is print()ed function output($templ = false) { print($this->run($templ)); } # return the names of the top level subs, or an empty array function top_sub_names() { if(isset($this->sub_subs['top_level_subs'])) { return $this->sub_subs['top_level_subs']; } else { return array(); } } # return the contents of the top-level sub-templates # # this does not run the sub-templates, so if you've not called tem_sub() on them, they will be blank. # # Return a hash. # keys: name of top level sub-template. # values: contents of said sub-template. function top_subs() { $ret = array(); $names = $this->top_sub_names(); foreach($names as $name) { $ret[$name] = $this->get($name); } return $ret; } } # Below are functions so you can use the above class without allocating or # keeping track of it. # get a reference to the current template object function tem_init() { if(!$GLOBALS['wfpl_template']) { $GLOBALS['wfpl_template'] = new tem(); } } function tem_set($key, $value) { tem_init(); $GLOBALS['wfpl_template']->set($key, $value); } function tem_get($key) { tem_init(); return $GLOBALS['wfpl_template']->get($key); } function tem_run($templ = false) { tem_init(); return $GLOBALS['wfpl_template']->run($templ); } function tem_sub($sub_template_name) { tem_init(); $GLOBALS['wfpl_template']->sub($sub_template_name); } function tem_load($filename) { tem_init(); $GLOBALS['wfpl_template']->load($filename); } function tem_output($filename = false) { tem_init(); $GLOBALS['wfpl_template']->output($filename); } # this is used in template_run() and should be of no other use function template_filler($matches) { list($tag, $enc) = explode('.', $matches[1], 2); $value = $GLOBALS['wfpl_template_keyval'][$tag]; if($enc) { $encs = explode('.', $enc); foreach($encs as $enc) { $enc = "enc_$enc"; if(function_exists($enc)) { $value = $enc($value, $tag); } else { print "ERROR: encoder function '$enc' not found.
\n"; exit(1); } } } return $value; } # pass a template string and an associative array of the key/values and it # returns the result. function template_run($template, &$keyval) { $GLOBALS['wfpl_template_keyval'] =& $keyval; return preg_replace_callback(array('||', '|~([^~]*)~|', '|([^<]*)|', '|

([^<]*)

|'), 'template_filler', $template); } function tem_top_sub_names() { tem_init(); return $GLOBALS['wfpl_template']->top_sub_names(); } function tem_top_subs() { tem_init(); return $GLOBALS['wfpl_template']->top_subs(); } # replaces currently set template, and returns the old. function tem_load_new($file) { $old = $GLOBALS['wfpl_template']; $GLOBALS['wfpl_template'] = new tem(); $GLOBALS['wfpl_template']->load($file); return $old; } ?>