<?php /* vim: set binary expandtab tabstop=4 shiftwidth=4 textwidth=80:
-------------------------------------------------------------------------------
                                    mlib
-------------------------------------------------------------------------------
This file is part of mlib.

mlib is free software; you can redistribute it and/or modify it under
the terms of the GNU Lesser General Public License as published by the Free
Software Foundation; either version 2 of the License, or (at your option)
any later version.

mlib is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more 
details.
 
You should have received a copy of the GNU Lesser General Public License; if 
not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330,
Boston, MA  02111-1307  USA
-------------------------------------------------------------------------------
Created: Wed Jun 17 19:03:14 2003
Authors: Leandro Lucarella <luca@lugmen.org.ar>
-------------------------------------------------------------------------------
$Id$
-----------------------------------------------------------------------------*/

require_once 'MLIB/Tpl.php';

/**
 * FileDir is a class based on HIT (Hooks vs IT Template Engine).
 * Hooks vs IT (HIT) is a simple template implementation, based on hooks and IT 
 * template systems.
 *
 *
 * @note This class was originally created as a part of BIFE.
 * @author Leandro Lucarella <luca@llucax.hn.org>
 * @todo Add a global example and an explanation of the directory structure to
 *       use, etc.
 */
class MLIB_Tpl_FileDir extends /* implements */ MLIB_Tpl 
{
    /**
     * Root directory where template files are.
     */
    var $root = '.';

    /**
     * If it's true, it looks for template files in PHP's include_path.
     */
    var $useIncludePath = false;

    /**
     * Group of templates to use.
     * In this implementation is a subdirectory in $root.
     *
     * @protected
     */
    var $group = '';

    /**
     * Constructor.
     * For PHP4 backward compatibility.
     *
     * @copydoc __construct()
     * @see __construct()
     */
    function MLIB_Tpl_FileDir($root = '.', $useIncludePath = false, $group = '')
    {
        $this->__construct($root, $useIncludePath, $group);
    }

    /**
     * Constructor.
     *
     * @param root           Root directory where template files are.
     * @param useIncludePath If it's true, it looks for template files in
     *                       PHP's include_path.
     * @param group          Group of templates to use (a subdirectory in
     *                       root in this implementation).
     *
     * @todo Add an example.
     */
    function __construct($root = '.', $useIncludePath = false, $group = '')
    {
        $this->root           = $root;
        $this->useIncludePath = $useIncludePath;
        $this->pushGroup($group);
    }

    /**
     * Parse a template returning the results.
     * If $vars is an array, the {[keys]} are replaced with [values] ($val is ignored). 
     * If is a string, {$vars} is replaced with $val.
     *
     * @copydoc MLIB_Tpl::parse()
     * @todo Add an example.
     */
    function parse($name, $vars = '', $val = '', $group = null)
    {
        $tpl = $this->getFileContent($this->getFilename($name, $group));
        if ($vars) {
            if (is_string($vars)) {
                $vars = array($vars => $val);
            }
            foreach ($vars as $key => $val) {
                $keys[] = '{' . $key . '}';
                $vals[] = $val;
            }
            return str_replace($keys, $vals, $tpl);
        } else {
            return $tpl;
        }
    }

    function pushGroup($group = '')
    {
        $this->group[] = $group;
    }

    function popGroup()
    {
        return array_pop($this->group);
    }

    function getGroup()
    {
        return end($this->group);
    }

    function exists($name, $group = null)
    {
        $tpl = $this->getFileContent($this->getFilename($name, $group));
        if (!$this->useIncludePath) {
            return is_readable($file);
        } else {
            $include_path = array_unique(preg_split('/[:;]/', ini_get('include_path')));
            foreach ($include_path as $path) {
                if (is_readable("$path/$file")) {
                    return true;
                }
            }
            return false;
        }
    }

    /**
     * Returns the template filename.
     * Returns the template filename based on the $name and the $group of the
     * template. If $group is null it uses the current group in the groups
     * stack.
     *
     * @param name  Tempate's name.
     * @param group Group where to look for the template.
     *
     * @protected
     * @return Filename.
     */
    function getFilename($name, $group = null)
    {
        $group = is_null($group) ? end($this->group) : $group;
        if ($group) {
            $file = "{$this->root}/$group/$name.tpl.html";
        } else {
            $file = "{$this->root}/$name.tpl.html";
        }
        return $file;
    }

    /**
     * Returns the contents of a file as a string.
     * It uses useIncludePath to search (or not) for the file in the PHP's
     * include_path.
     *
     * @param filename Filename.
     *
     * @protected
     * @return File contents as a string.
     */
    function getFileContent($filename)
    {
        return file_get_contents($filename, $this->useIncludePath);
    }

}

/**
 * @example Tpl/FileDir/test.php
 *
 * This example will create an HTML page with a header, body and a footer.
 * In order to do this, I will use three template groups (header, body, footer).
 * All this templates are located in TPLS directory.
 */

?>