<?php
/*=====================================================================*\
|| ################################################################### ||
|| # Iris Studios Shared Object Framework [#]version[#]
|| # --------------------------------------------------------------- # ||
|| # Copyright Š2002-[#]year[#] by Iris Studios, Inc. All Rights Reserved. # ||
|| # This file may not be reproduced in any way without permission.  # ||
|| # --------------------------------------------------------------- # ||
|| # User License Agreement at http://www.iris-studios.com/license/  # ||
|| ################################################################### ||
\*=====================================================================*/

/**
* File System Template System
* template_fs.php
*
* @package	ISSO
*/

if (!$this->is_loaded('template'))
{
	$this->locate('template');
}

$OBJECT = 'File-Based Template System';
$CLASS = 'FS_Template';
$OBJ = 'template';

/**
* File System Template System
*
* This framework merely replaces the template loading functions with
* file-system based ones.
*
* @author		Iris Studios, Inc.
* @copyright	Copyright Š2002 - [#]year[#], Iris Studios, Inc.
* @version		$Revision$
* @package		ISSO
* 
*/
class FS_Template extends DB_Template
{
	/**
	* The path, from the path of the application, where templates are stored
	* @var	str
	* @see	Shared_Object_Framework::$apppath, _load()
	*/
	var $templatedir = '';
	
	/**
	* The extension all the template files have
	* @var	str
	* @see	_load()
	*/
	var $extension = 'tpl';
	
	/**
	* Takes an array of template names, loads them, and then stores
	* a parsed version for optimum speed.
	*
	* @param	array		List of template names to be cached
	*/
	function cache($namearray)
	{
		if (sizeof($this->cache) > 0)
		{
			trigger_error('You cannot cache templates more than once per initialization', E_USER_WARNING);
		}
		else
		{
			foreach ($namearray AS $name)
			{
				$template = $this->_load($name);
				$template = $this->_parse($template);
				$this->cache["$name"] = $template;
				$this->usage["$name"] = 0;
			}
		}
	}
	
	/**
	* Loads a template from the file system from the specified $templatedir
	* with the file extension $extension
	*
	* @param	str		The name of the template call
	*/
	function _load($name)
	{
		global $_isso;
		
		$path = $_isso->apppath . $this->templatedir . $name . '.' . $this->extension;
		if (is_file($path))
		{
			if (($template = @file_get_contents($path)) !== false)
			{
				return $template;
			}
			else
			{
				trigger_error("Could not load the template '$path'", E_USER_ERROR);
				exit;
			}
		}
		else
		{
			trigger_error("Could not load the template '$path'", E_USER_ERROR);
			exit;
		}
	}
}

/*=====================================================================*\
|| ###################################################################
|| # $HeadURL$
|| # $Id$
|| ###################################################################
\*=====================================================================*/
?>