<?php
/* $Id$ */
namespace Mammut\Template;
/**
 * Generic template interface
 * 
 * @author Stefan Daurer <s.daurer@q-spot.org>
 * @package Mammut\Template
 */
interface iTemplate {
	
	public function getRoot();
	public function setRoot($dir);
	
	/**
	 * load a template from a file
	 * @param $file	string/MFFile the template file
	 * @param $runPHP	boolean set this to true if you want to parse the file a php one
	 */
	public function loadTemplate($file, $runPHP = true);
	/**
	 * load a template from a string
	 * @param $data	string the template data
	 */
	public function loadString($data);
	
	/**
	 * @return array a string list of all parameters defined in the layout
	 */
	public function getParamList();
	
	/**
	 * fetches the value of a defined parameter
	 * @param $name	string the parameter name
	 * @return mixed the parameter value or NULL
	 */
	public function getParam($name);
	/**
	 * Sets the value of a parameter.
	 * @param $name	string The parameter name.
	 * @param $value mixed The parameter value. Clousures will get a context object as first parameter.
	 */
	public function setParam($name, $value);
	
	/**
	 * renders the template to a string
	 * @return string the rendered document
	 */
	public function getDocument();
	
}