template_fs.php

   1 <?php
   2 /*=====================================================================*\
   3 || ###################################################################
   4 || # Iris Studios Shared Object Framework [#]version[#]
   5 || # Copyright ©2002-[#]year[#] Iris Studios, Inc.
   6 || #
   7 || # This program is free software; you can redistribute it and/or modify
   8 || # it under the terms of the GNU General Public License as published by
   9 || # the Free Software Foundation; version [#]gpl[#] of the License.
  10 || #
  11 || # This program is distributed in the hope that it will be useful, but
  12 || # WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  13 || # or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
  14 || # more details.
  15 || #
  16 || # You should have received a copy of the GNU General Public License along
  17 || # with this program; if not, write to the Free Software Foundation, Inc.,
  18 || # 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
  19 || ###################################################################
  20 \*=====================================================================*/
  21
  22 /**
  23 * File System Template System
  24 * template_fs.php
  25 *
  26 * @package      ISSO
  27 */
  28
  29 $this->load('template', null);
  30
  31 /**
  32 * File System Template System
  33 *
  34 * This framework merely replaces the template loading functions with
  35 * file-system based ones.
  36 *
  37 * @author               Iris Studios, Inc.
  38 * @copyright    Copyright ©2002 - [#]year[#], Iris Studios, Inc.
  39 * @version              $Revision$
  40 * @package              ISSO
  41 *
  42 */
  43 class Template_FS extends Template
  44 {
  45         /**
  46         * The path, from the path of the application, where templates are stored
  47         * @var  string
  48         * @access       private
  49         */
  50         var $templatedir = '';
  51
  52         /**
  53         * The extension all the template files have
  54         * @var  string
  55         * @access       private
  56         */
  57         var $extension = 'tpl';
  58
  59         /**
  60         * Fields array that is used in this module
  61         * @var  array
  62         * @access       private
  63         */
  64         var $fields = array(
  65                 'templatedir'   => array(REQ_YES,       '$this->registry->fetch_sourcepath',    false),
  66                 'extension'             => array(REQ_YES,       null,                                                                   false)
  67         );
  68
  69         // ###################################################################
  70         /**
  71         * Constructor
  72         */
  73         function __construct(&$registry)
  74         {
  75                 $this->registry =& $registry;
  76         }
  77
  78         // ###################################################################
  79         /**
  80         * (PHP 4) Constructor
  81         */
  82         function Template_FS(&$registry)
  83         {
  84                 $this->__construct($registry);
  85         }
  86
  87         // ###################################################################
  88         /**
  89         * Sets an ISSO field
  90         *
  91         * @access       public
  92         *
  93         * @param        string  Field name
  94         * @param        mixed   Value of the field
  95         */
  96         function set($name, $value)
  97         {
  98                 $this->registry->do_set($name, $value, 'template_fs');
  99         }
 100
 101         // ###################################################################
 102         /**
 103         * Takes an array of template names, loads them, and then stores a
 104         * parsed version for optimum speed.
 105         *
 106         * @access       public
 107         *
 108         * @param        array   List of template names to be cached
 109         */
 110         function cache($namearray)
 111         {
 112                 if (sizeof($this->cache) > 0)
 113                 {
 114                         trigger_error('You cannot cache templates more than once per initialization', E_USER_WARNING);
 115                 }
 116                 else
 117                 {
 118                         foreach ($namearray AS $name)
 119                         {
 120                                 $template = $this->_load($name);
 121                                 $template = $this->_parse($template);
 122                                 $this->cache["$name"] = $template;
 123                                 $this->usage["$name"] = 0;
 124                         }
 125                 }
 126         }
 127
 128         // ###################################################################
 129         /**
 130         * Loads a template from the file system from the specified
 131         * $templatedir with the file extension $extension
 132         *
 133         * @access       private
 134         *
 135         * @param        string  The name of the template call
 136         */
 137         function _load($name)
 138         {
 139                 $path = $this->registry->apppath . $this->templatedir . $name . '.' . $this->extension;
 140                 if (is_file($path))
 141                 {
 142                         if (($template = @file_get_contents($path)) !== false)
 143                         {
 144                                 return $template;
 145                         }
 146                         else
 147                         {
 148                                 trigger_error("Could not load the template '$path'", E_USER_ERROR);
 149                                 exit;
 150                         }
 151                 }
 152                 else
 153                 {
 154                         trigger_error("Could not load the template '$path'", E_USER_ERROR);
 155                         exit;
 156                 }
 157         }
 158 }
 159
 160 /*=====================================================================*\
 161 || ###################################################################
 162 || # $HeadURL$
 163 || # $Id$
 164 || ###################################################################
 165 \*=====================================================================*/
 166 ?>