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
}
# 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;
$tmp = read_whole_file($filename);
$this->template = '';
$parents = array('top_level_subs' => array());
$parent = 'top_level_subs';
$this->_load($tmp, $this->template, $parents, $parent);
}
# Run the template. Pass a filename, or a string, unless you've already
# specified a template with load()
function run($templ = false) {
if($templ !== false) {
if(strlen($templ) < 150 && file_exists($templ)) {
$this->filename = $templ;
unset($this->template);
} else {
$this->template = $templ;
}
}
if(!$this->template) {
if(!$this->filename) {
print "sorry, no template to run\n";
exit(1);
}
$this->template = read_whole_file($this->filename);
}
return template_run($this->template, $this->keyval);
}
# same as run() except the output is print()ed
function output($templ = false) {
print($this->run($templ));
}
}
# 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);
} 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); } ?>