smarty/libs/Smarty.class.php

<?
/*
 * Project:		Smarty: the PHP compiled template engine
 * File:		Smarty.class.php
 * Author:		Monte Ohrt <monte@ispi.net>
 *				original idea and implementation
 *
 *				Andrei Zmievski <andrei@ispi.net>
 *				parsing engine rewrite and a lot more
 *				
 *
 */

require("Smarty.addons.php");

class Smarty
{

	// public vars
	var	$compile_check	=	true;	// whether to check for compiling step or not:
									// This is generally set to false once the
									// application is entered into production and
									// initially compiled. Leave set to true
									// during development.

	var $template_dir			=	"templates"; // name of directory for templates	
	
	var $compile_dir_ext		=	"_c";	// the directory extention where
											// compiled templates are placed
	
	var $tpl_file_ext			=	".tpl";	// template file extentions
	
	var $max_recursion_depth	=	10;			// maximum recursion depth.
												// this is to help catch infinite loops.
												// 0 == unlimited recursion.
	var $allow_php				=	false;		// whether or not to allow embedded php
												// in the templates. By default, php tags
												// are escaped.
	var $left_delimiter			=	"{";		// template tag delimiters.
	var $right_delimiter		=	"}";

	var $config_dir				=	"./configs";	// directory where config files are located

	var $custom_tags			=	array(	'html_options'		=> 'smarty_func_html_options',
											'html_select_date'	=> 'smarty_func_html_select_date'
										 );
	
	var $modifiers				=	array(	'lower'			=> 'strtolower',
											'upper'			=> 'strtoupper',
											'capitalize'	=> 'ucwords',
											'escape'		=> 'smarty_mod_escape',
											'truncate'		=> 'smarty_mod_truncate',
											'spacify'		=> 'smarty_mod_spacify',
											'date_format'	=> 'smarty_mod_date_format',
											'string_format'	=> 'smarty_mod_string_format',
											'replace'		=> 'smarty_mod_replace'
										 );
	var $global_assign			=	array(	'SCRIPT_NAME'
										 );

	// internal vars
	var $_error_msg				=	false;		// error messages
	var $_tpl_vars				= 	array();
	var $_sectionelse_stack		=	array();	// keeps track of whether section had 'else' part
	var $_literal_blocks		=	array();	// keeps literal template blocks

	
/*======================================================================*\
	Function: Smarty
	Purpose:  Constructor
\*======================================================================*/
	function Smarty()
	{
		foreach ($this->global_assign as $var_name)
			$this->assign($var_name, $GLOBALS[$var_name]);
	}


/*======================================================================*\
	Function:	assign()
	Purpose:	assigns values to template variables
\*======================================================================*/

	function assign($tpl_var, $value = NULL)
	{
		if (is_array($tpl_var)){
			foreach ($tpl_var as $key => $val) {
				if (!empty($key))
					$this->_tpl_vars[$key] = $val;
			}
		} else {
			if (!empty($tpl_var) && isset($value))
				$this->_tpl_vars[$tpl_var] = $value;
		}
	}

	
/*======================================================================*\
	Function: append
	Purpose:  appens values to template variables
\*======================================================================*/
	function append($tpl_var, $value = NULL)
	{
		if (is_array($tpl_var)) {
			foreach ($tpl_var as $key => $val) {
				if (!empty($key)) {
					if (!is_array($this->_tpl_vars[$key]))
						settype($this->_tpl_vars[$key], 'array');
					$this->_tpl_vars[$key][] = $val;
				}
			}
		} else {
			if (!empty($tpl_var) && isset($value)) {
				if (!is_array($this->_tpl_vars[$tpl_var]))
					settype($this->_tpl_vars[$tpl_var], 'array');
				$this->_tpl_vars[$tpl_var][] = $value;
			}
		}
	}


/*======================================================================*\
	Function:	clear_assign()
	Purpose:	clear the given assigned template variable.
\*======================================================================*/

	function clear_assign($tpl_var)
	{
		unset($this->_tpl_vars[$tpl_var]);
	}

/*======================================================================*\
	Function:	clear_all_assign()
	Purpose:	clear all the assigned template variables.
\*======================================================================*/

	function clear_all_assign()
	{
		$this->_tpl_vars = array();
	}


/*======================================================================*\
	Function: get_template_vars
	Purpose:  Returns an array containing template variables
\*======================================================================*/
	function &get_template_vars()
	{
		return $this->_tpl_vars;
	}


/*======================================================================*\
	Function:	display()
	Purpose:	executes & displays the template results
\*======================================================================*/

	function display($tpl_file)
	{
		if(preg_match("/^(.+)\/([^\/]+)$/",$tpl_file,$match))
		{
			// compile files
			$this->_compile($match[1]);
			//assemble compile directory path to file
			$_compile_file = preg_replace("/([\.\/]*[^\/]+)(.*)/","\\1".preg_quote($this->compile_dir_ext,"/")."\\2",$tpl_file);
			
			extract($this->_tpl_vars);		
			include($_compile_file);
		}
	}	
		
/*======================================================================*\
	Function:	fetch()
	Purpose:	executes & returns the template results
\*======================================================================*/

	function fetch($tpl_file)
	{
		ob_start();
		$this->display($tpl_file);
		$results = ob_get_contents();
		ob_end_clean();
		return $results;
	}

/*======================================================================*\
	Function:	compile()
	Purpose:	called to compile the templates
\*======================================================================*/

	function _compile($tpl_dir)
	{
		if($this->compile_check)
		{
			if($this->_traverse_files($tpl_dir,0))
				return true;
			else
				return false;
		}
		else
			return false;
	}

/*======================================================================*\
	Function:	_traverse_files()
	Purpose:	traverse the template files & process each one
\*======================================================================*/

	function _traverse_files($tpl_dir,$depth)
	{
		// exit if recursion depth is met
		if($this->max_recursion_depth != 0 && $depth >= $this->max_recursion_depth)
		{
			$this->_set_error_msg("recursion depth of $depth reached on $tpl_dir/$curr_file. exiting.");
			return false;
		}
		if(is_dir($tpl_dir))
		{
			if($tpl_dir)

			$dir_handle = opendir($tpl_dir);
			while($curr_file = readdir($dir_handle))
			{
				if(!preg_match("/".preg_quote($this->tpl_file_ext,"/")."$/",$curr_file))
				{
					//echo "skipping $curr_file<br>\n";
					continue;
				}
				
				$filepath = $tpl_dir."/".$curr_file;
				//echo "filepath is $filepath<br>\n";
				if(is_readable($filepath))
				{
					if(is_file($filepath))
					{
						//echo "is file.<br>\n";
						//echo $filepath, $depth<br>\n";
						if(!$this->_process_file($filepath))
							return false;						
					}
					elseif(is_dir($filepath))
					{
						//echo "is directory.<br>\n";
						if(!$this->_traverse_files($filepath,$depth+1))
							return false;
					}
					else
					{
						// invalid file type, skipping
						$this->_set_error_msg("Invalid filetype for $filepath, skipping");
						continue;
					}
				}
			}
		}
		else
		{
			$this->_set_error_msg("Directory \"$tpl_dir\" does not exist or is not a directory.");
			return false;
		}
		return true;
	}

/*======================================================================*\
	Function:	_process_file()
	Input:		test template files for modifications
				and execute the compilation for each
				one requiring it.
\*======================================================================*/

	function _process_file($filepath)
	{
		if(preg_match("/^(.+)\/([^\/]+)$/",$filepath,$match))
		{
			$tpl_file_dir = $match[1];			
			$tpl_file_name = $match[2];

			//assemble compile directory path
			$compile_dir = preg_replace("/([\.\/]*[^\/]+)(.*)/","\\1".preg_quote($this->compile_dir_ext,"/")."\\2",$match[1]);
			
			//echo "compile dir: $compile_dir<br>\n";
			//create directory if none exists
			if(!file_exists($compile_dir)) {
				$compile_dir_parts = preg_split('!/+!', $compile_dir);
				$new_dir = "";
				foreach ($compile_dir_parts as $dir_part) {
					$new_dir .= $dir_part."/";
					if (!file_exists($new_dir) && !mkdir($new_dir, 0755)) {
						$this->_set_error_msg("problem creating directory \"$compile_dir\"");
						return false;				
					}
				}
			}

			// compile the template file if none exists or has been modified
			if(!file_exists($compile_dir."/".$tpl_file_name) ||
				($this->_modified_file($filepath,$compile_dir."/".$tpl_file_name)))
			{
				if(!$this->_compile_file($filepath,$compile_dir."/".$tpl_file_name))
					return false;				
			}
			else
			{
				// no compilation needed
				return true;
			}
		}
		else
		{
			$this->_set_error_msg("problem matching \"$filepath.\"");
			return false;
		}
		return true;
	}

/*======================================================================*\
	Function:	_modified_file()
	Input:		return comparison of modification times of files
\*======================================================================*/

	function _modified_file($filepath,$compilepath)
	{
		if(filemtime($filepath) >= filemtime($compilepath))
			return true;
		return false;
	}

/*======================================================================*\
	Function:	_compile_file()
	Input:		compile a template file
\*======================================================================*/

	function _compile_file($filepath,$compilepath)
	{
		if(!($template_contents = $this->_read_file($filepath)))
			return false;

		$ldq = preg_quote($this->left_delimiter, "/");
		$rdq = preg_quote($this->right_delimiter, "/");

		/* Pull out the literal blocks. */
		preg_match_all("!{$ldq}literal{$rdq}(.*?){$ldq}/literal{$rdq}!s", $template_contents, $match);
		$this->_literal_blocks = $match[1];
		$template_contents = preg_replace("!{$ldq}literal{$rdq}(.*?){$ldq}/literal{$rdq}!s",
						 				  '{literal}', $template_contents);

		/* Gather all template tags. */
		preg_match_all("/$ldq\s*(.*?)\s*$rdq/s", $template_contents, $match);
		$template_tags = $match[1];
		/* Split content by template tags to obtain non-template content. */
		$text_blocks = preg_split("/$ldq.*?$rdq/s", $template_contents);
		if(!$this->allow_php) {
			/* Escape php tags. */
			$text_blocks = preg_replace('!<\?([^?]*?)\?>!', '&lt;?$1?&gt;', $text_blocks);
		}

		$compiled_tags = array();
		foreach ($template_tags as $template_tag)
			$compiled_tags[] = $this->_compile_tag($template_tag);

		for ($i = 0; $i < count($compiled_tags); $i++) {
			$compiled_contents .= $text_blocks[$i].$compiled_tags[$i];
		}
		$compiled_contents .= $text_blocks[$i];
		
		/* Reformat data between 'strip' and '/strip' tags, removing spaces, tabs and newlines. */
		if (preg_match_all("!{$ldq}strip{$rdq}.*?{$ldq}/strip{$rdq}!s", $compiled_contents, $match)) {
			$strip_tags = $match[0];
			$strip_tags_modified = preg_replace("!$ldq/?strip$rdq|[\t ]+$|^[\t ]+!m", '', $strip_tags);
			$strip_tags_modified = preg_replace('![\r\n]+!m', ' ', $strip_tags_modified);
			for ($i = 0; $i < count($strip_tags); $i++)
				$compiled_contents = preg_replace("!{$ldq}strip{$rdq}.*?{$ldq}/strip{$rdq}!s",
												  $strip_tags_modified[$i], $compiled_contents, 1);
		}

		if(!$this->_write_file($compilepath, $compiled_contents))
			return false;

		return true;
	}

	function _compile_tag($template_tag)
	{
		/* Matched comment. */
		if ($template_tag{0} == '*' && $template_tag{strlen($tokens)-1} == '*')
			return "";

		/* Split tag into two parts: command and the arguments. */
		preg_match('/^(
					   (?:"[^"\\\\]*(?:\\\\.[^"\\\\]*)*" | \'[^\'\\\\]*(?:\\\\.[^\'\\\\]*)*\' | (?>[^"\' ]+))+
					  )
				      (?:\s+(.*))?
					    /x', $template_tag, $match);
		list(, $tag_command, $tag_args) = $match;

		/* If the tag name matches a variable or section property definition,
		   we simply process it. */
		if (preg_match('!^\$(\w+/)*\w+(?>\|@?\w+(:[^|]+)?)*$!', $tag_command) ||	// if a variable
			preg_match('!^#(\w+)#(?>\|@?\w+(:[^|]+)?)*$!', $tag_command)		||  // or a configuration variable
			preg_match('!^%\w+\.\w+%(?>\|@?\w+(:[^|]+)?)*$!', $tag_command)) {    // or a section property
			settype($tag_command, 'array');
			$this->_parse_vars_props($tag_command);
			return "<?php print $tag_command[0]; ?>";
		}

		switch ($tag_command) {
			case 'include':
				return $this->_compile_include_tag($tag_args);

			case 'if':
				return $this->_compile_if_tag($tag_args);

			case 'else':
				return '<?php else: ?>';

			case 'elseif':
				return $this->_compile_if_tag($tag_args, true);

			case '/if':
				return '<?php endif; ?>';

			case 'ldelim':
				return $this->left_delimiter;

			case 'rdelim':
				return $this->right_delimiter;

			case 'section':
				array_push($this->_sectionelse_stack, false);
				return $this->_compile_section_start($tag_args);

			case 'sectionelse':
				$this->_sectionelse_stack[count($this->_sectionelse_stack)-1] = true;
				return "<?php endfor; else: ?>";

			case '/section':
				if (array_pop($this->_sectionelse_stack))
					return "<?php endif; ?>";
				else
					return "<?php endfor; endif; ?>";

			case 'config_load':
				return $this->_compile_config_load_tag($tag_args);

			case 'strip':
			case '/strip':
				return $this->left_delimiter.$tag_command.$this->right_delimiter;

			case 'literal':
				list (,$literal_block) = each($this->_literal_blocks);
				return $literal_block;

			default:
				if (isset($this->custom_tags[$tag_command])) {
					return $this->_compile_custom_tag($tag_command, $tag_args);
				} else
					/* TODO syntax error: unknown tag */
				return "";
		}
	}


	function _compile_custom_tag($tag_command, $tag_args)
	{
		$attrs = $this->_parse_attrs($tag_args);
		$function = $this->custom_tags[$tag_command];
		foreach ($attrs as $arg_name => $arg_value) {
			if (is_bool($arg_value))
				$arg_value = $arg_value ? 'true' : 'false';
			$arg_list[] = "'$arg_name' => $arg_value";
		}

		return "<?php $function(array(".implode(',', (array)$arg_list).")); ?>";
	}


	function _compile_config_load_tag($tag_args)
	{
		$attrs = $this->_parse_attrs($tag_args);

		if (empty($attrs['file'])) {
			/* TODO syntax error: missing 'file' attribute */
		}

		$output  = '<?php include_once "Config_File.php";'."\n";
	    $output .= 'if (!is_object($_conf_obj) || get_class($_conf_obj) != "config_file") {'."\n";
		$output .= '	$_conf_obj  = new Config_File("'.$this->config_dir.'");'."\n";
	    $output .= '}'."\n";
	   	$output .= '$_config = array_merge((array)$_config, $_conf_obj->get('.$attrs['file'].'));'."\n";

		if (!empty($attrs['section']))
			$output .= '$_config = array_merge((array)$_config, $_conf_obj->get('.$attrs['file'].', '.$attrs['section'].')); ';

		$output .= '?>';

		return $output;
	}


	function _compile_include_tag($tag_args)
	{
		$attrs = $this->_parse_attrs($tag_args);

		if (empty($attrs['file'])) {
			/* TODO syntax error: missing 'file' attribute */
		} else
			$attrs['file'] = $this->_dequote($attrs['file']);
		
		return '<?php include "'.$this->template_dir.$this->compile_dir_ext.'/'.$attrs['file'].'"; ?>';
	}

	function _compile_section_start($tag_args)
	{
		$attrs = $this->_parse_attrs($tag_args);

		$output = "<?php\n";
		$section_name = $attrs['name'];
		if (empty($section_name)) {
			/* TODO syntax error: section needs a name */
		}

		$output .= "unset(\$_sections[$section_name]);\n";
		$section_props = "\$_sections[$section_name]['properties']";

		foreach ($attrs as $attr_name => $attr_value) {
			switch ($attr_name) {
				case 'loop':
					$output .= "{$section_props}['loop'] = count($attr_value);\n";
					break;

				case 'show':
					if (is_bool($attr_value))
						$attr_value = $attr_value ? 'true' : 'false';
					$output .= "{$section_props}['$attr_name'] = $attr_value;\n";
					break;

				default:
					$output .= "{$section_props}['$attr_name'] = $attr_value;\n";
					break;
			}
		}

		if (isset($attrs['loop'])) {
			$loop_check_code = "{$section_props}['loop'] > 0 && ";
		} else {
			$output .= "{$section_props}['loop'] = 1;\n";
		}

		if (isset($attrs['show'])) {
			$show_check_code = "{$section_props}['show'] && ";
		}

		$output .= "if ($loop_check_code $show_check_code true): ";

		$output .= "
			for ({$section_props}['index'] = 0;
				 {$section_props}['index'] < {$section_props}['loop'];
				 {$section_props}['index']++):\n";

		$output .= "?>\n";

		return $output;
	}

	function _compile_if_tag($tag_args, $elseif = false)
	{
		/* Tokenize args for 'if' tag. */
		preg_match_all('/(?:
						 "[^"\\\\]*(?:\\\\.[^"\\\\]*)*" 		| # match all double quoted strings allowed escaped double quotes
						 \'[^\'\\\\]*(?:\\\\.[^\'\\\\]*)*\'		| # match all single quoted strings allowed escaped single quotes
						 [()]									| # match parentheses
						 [^"\'\s()]+							  # match any other token that is not any of the above
						)/x', $tag_args, $match);
		$tokens = $match[0];

		$this->_parse_vars_props($tokens);

		$is_arg_stack = array();
		
		for ($i = 0; $i < count($tokens); $i++) {
			$token = &$tokens[$i];
			switch ($token) {
				case 'eq':
					$token = '==';
					break;

				case 'ne':
				case 'neq':
					$token = '!=';
					break;

				case 'lt':
					$token = '<';
					break;

				case 'le':
				case 'lte':
					$token = '<=';
					break;

				case 'gt':
					$token = '>';
					break;
				
				case 'ge':
				case 'gte':
					$token = '>=';
					break;

				case 'and':
					$token = '&&';
					break;

				case 'or':
					$token = '||';
					break;

				case 'not':
					$token = '!';
					break;

				case 'mod':
					$token = '%';
					break;

				case '(':
					array_push($is_arg_stack, $i);
					break;

				case 'is':
					/* If last token was a ')', we operate on the parenthesized
					   expression. The start of the expression is on the stack.
					   Otherwise, we operate on the last encountered token. */
					if ($tokens[$i-1] == ')')
						$is_arg_start = array_pop($is_arg_stack);
					else
						$is_arg_start = $i-1;
					/* Construct the argument for 'is' expression, so it knows
					   what to operate on. */
					$is_arg = implode(' ', array_slice($tokens, $is_arg_start, $i - $is_arg_start));

					/* Pass all tokens from next one until the end to the
					   'is' expression parsing function. The function will
					   return modified tokens, where the first one is the result
					   of the 'is' expression and the rest are the tokens it
					   didn't touch. */
					$new_tokens = $this->_parse_is_expr($is_arg, array_slice($tokens, $i+1));

					/* Replace the old tokens with the new ones. */
					array_splice($tokens, $is_arg_start, count($tokens), $new_tokens);

					/* Adjust argument start so that it won't change from the
					   current position for the next iteration. */
					$i = $is_arg_start;
					break;
			}
		}

		if ($elseif)
			return '<?php elseif ('.implode(' ', $tokens).'): ?>';
		else
			return '<?php if ('.implode(' ', $tokens).'): ?>';
	}

	function _parse_is_expr($is_arg, $tokens)
	{
		$expr_end = 0;

		if (($first_token = array_shift($tokens)) == 'not') {
			$negate_expr = true;
			$expr_type = array_shift($tokens);
		} else
			$expr_type = $first_token;

		switch ($expr_type) {
			case 'even':
				if ($tokens[$expr_end] == 'by') {
					$expr_end++;
					$expr_arg = $tokens[$expr_end++];
					$expr = "!(($is_arg / $expr_arg) % $expr_arg)";
				}
				else
					$expr = "!($is_arg % 2)";
				break;

			case 'odd':
				if ($tokens[$expr_end] == 'by') {
					$expr_end++;
					$expr_arg = $tokens[$expr_end++];
					$expr = "(($is_arg / $expr_arg) % $expr_arg)";
				}
				else
					$expr = "($is_arg % 2)";
				break;

			case 'mod':
				$expr_arg = $tokens[$expr_end++];
				$expr = "!($is_arg % $expr_arg)";
				break;

			default:
				/* TODO strict syntax checking */
				break;
		}

		if ($negate_expr) {
			$expr = "!($expr)";
		}

		array_splice($tokens, 0, $expr_end, $expr);

		return $tokens;
	}

	function _parse_attrs($tag_args)
	{
		/* Tokenize tag attributes. */
		preg_match_all('/(?:"[^"\\\\]*(?:\\\\.[^"\\\\]*)*"       | 
						  \'[^\'\\\\]*(?:\\\\.[^\'\\\\]*)*\'     | (?>[^"\'= ]+)
						 )+ |
						 [=]
					    /x', $tag_args, $match);
		$tokens = $match[0];
		$var_delims = array('$', '#', '%');

		$attrs = array();
		/* Parse state:
		   	0 - expecting attr name
			1 - expecting '=' or another attr name
			2 - expecting attr value (not '=') */
		$state = 0;

		foreach ($tokens as $token) {
			switch ($state) {
				case 0:
					/* If the token is a valid identifier, we set attribute name
					   and go to state 1. */
					if (preg_match('!\w+!', $token)) {
						$attr_name = $token;
						$state = 1;
					} else
						/* TODO syntax error: invalid attr name */;
					break;

				case 1:
					/* If the token is a valid identifier, the previously set
					   attribute name does not need an argument. We put it in
					   the attrs array, set the new attribute name to the
					   current token and don't switch state.

					   If the token is '=', then we go to state 2. */
					if ($token == '=') {
						$state = 2;
					} else
						/* TODO syntax error: expecting '=' */;
					break;

				case 2:
					/* If token is not '=', we set the attribute value and go to
					   state 0. */
					if ($token != '=') {
						/* We booleanize the token if it's a non-quoted possible
						   boolean value. */
						if (preg_match('!^(on|yes|true)$!', $token))
							$token = true;
						else if (preg_match('!^(off|no|false)$!', $token))
							$token = false;
						/* If the token is not variable (doesn't start with
						   '$', '#', or '%') and not enclosed in single or
						   double quotes we single-quote it. */
						else if (!in_array($token{0}, $var_delims) &&
								 !(($token{0} == '"' || $token[0] == "'") &&
								 $token{strlen($token)-1} == $token{0}))
							$token = "'".$token."'";

						$attrs[$attr_name] = $token;
						$state = 0;
					} else
						/* TODO syntax error: '=' can't be a value */;
					break;
			}
		}

		$this->_parse_vars_props($attrs);

		return $attrs;
	}
	
	function _parse_vars_props(&$tokens)
	{
		$var_exprs = preg_grep('!^\$(\w+/)*\w+(?>\|@?\w+(:[^|]+)?)*$!', $tokens);
		$conf_var_exprs = preg_grep('!^#(\w+)#(?>\|@?\w+(:[^|]+)?)*$!', $tokens);
		$sect_prop_exprs = preg_grep('!^%\w+\.\w+%(?>\|@?\w+(:[^|]+)?)*$!', $tokens);

		if (count($var_exprs)) {
			foreach ($var_exprs as $expr_index => $var_expr) {
				$tokens[$expr_index] = $this->_parse_var($var_expr);
			}
		}
		
		if (count($conf_var_exprs)) {
			foreach ($conf_var_exprs as $expr_index => $var_expr) {
				$tokens[$expr_index] = $this->_parse_conf_var($var_expr);
			}
		}

		if (count($sect_prop_exprs)) {
			foreach ($sect_prop_exprs as $expr_index => $section_prop_expr) {
				$tokens[$expr_index] = $this->_parse_section_prop($section_prop_expr);
			}
		}
	}

	function _parse_var($var_expr)
	{
		$modifiers = explode('|', substr($var_expr, 1));

		$sections = explode('/', array_shift($modifiers));
		$var_name = array_pop($sections);

		$output = "\$$var_name";

		foreach ($sections as $section) {
			$output .= "[\$_sections['$section']['properties']['index']]";
		}

		$this->_parse_modifiers($output, $modifiers);

		return $output;
	}

	function _parse_conf_var($conf_var_expr)
	{
		$modifiers = explode('|', $conf_var_expr);

		$var_name = substr(array_shift($modifiers), 1, -1);

		$output = "\$_config['$var_name']";

		$this->_parse_modifiers($output, $modifiers);

		return $output;
	}

	function _parse_section_prop($section_prop_expr)
	{
		$modifiers = explode('|', $section_prop_expr);

		preg_match('!%(\w+)\.(\w+)%!', array_shift($modifiers), $match);
		$section_name = $match[1];
		$prop_name = $match[2];

		$output = "\$_sections['$section_name']['properties']['$prop_name']";

		$this->_parse_modifiers($output, $modifiers);

		return $output;
	}

	function _parse_modifiers(&$output, $modifiers)
	{
		foreach ($modifiers as $modifier) {
			$modifier = explode(':', $modifier);
			$modifier_name = array_shift($modifier);

			if ($modifier_name{0} == '@') {
				$map_array = 'false';
				$modifier_name = substr($modifier_name, 1);
			} else
				$map_array = 'true';

			/*
			 * First we lookup the modifier function name in the registered
			 * modifiers table.
			 */
			$mod_func_name = $this->modifiers[$modifier_name];

			/*
			 * If we don't find that modifier there, we assume it's just a PHP
			 * function name.
			 */
			/* TODO strict syntax check */
			if (!isset($mod_func_name))
				$mod_func_name = $modifier_name;

			$this->_parse_vars_props($modifier);

			if (count($modifier) > 0)
				$modifier_args = ', '.implode(', ', $modifier);
			else
				$modifier_args = '';

			$output = "_smarty_mod_handler('$mod_func_name', $map_array, $output$modifier_args)";
		}
	}
	

/*======================================================================*\
	Function: _dequote
	Purpose:  Remove starting and ending quotes from the string
\*======================================================================*/
	function _dequote($string)
	{
		if (($string{0} == "'" || $string{0} == '"') &&
			$string{strlen($string)-1} == $string{0})
			return substr($string, 1, -1);
	}

	
/*======================================================================*\
	Function:	_read_file()
	Purpose:	read in a file
\*======================================================================*/

	function _read_file($filename)
	{
		if(! ($fd = fopen($filename,"r")))
		{
			$this->_set_error_msg("problem reading \"$filename.\"");
			return false;
		}
		$contents = fread($fd,filesize($filename));
		fclose($fd);
		return $contents;
	}

/*======================================================================*\
	Function:	_write_file()
	Purpose:	write out a file
\*======================================================================*/

	function _write_file($filename,$contents)
	{
		if(!($fd = fopen($filename,"w")))
		{
			$this->_set_error_msg("problem writing \"$filename.\"");
			return false;
		}
		fwrite($fd,$contents);
		fclose($fd);
		return true;
	}

/*======================================================================*\
	Function:	_set_error_msg()
	Purpose:	set the error message
\*======================================================================*/

	function _set_error_msg($error_msg)
	{
		$this->_error_msg="smarty error: $error_msg";
		return true;
	}

}

?>