File indexing completed on 2024-05-12 06:03:16

 <?php
 /**
  * Zend Framework
  *
  * LICENSE
  *
  * This source file is subject to the new BSD license that is bundled
  * with this package in the file LICENSE.txt.
  * It is also available through the world-wide-web at this URL:
  * http://framework.zend.com/license/new-bsd
  * If you did not receive a copy of the license and are unable to
  * obtain it through the world-wide-web, please send an email
  * to license@zend.com so we can send you a copy immediately.
  *
  * @category   Zend
  * @package    Zend_View
  * @copyright  Copyright (c) 2005-2015 Zend Technologies USA Inc. (http://www.zend.com)
  * @license    http://framework.zend.com/license/new-bsd     New BSD License
  * @version    $Id$
  */
 
 /** @see Zend_Loader */
 // require_once 'Zend/Loader.php';
 
 /** @see Zend_Loader_PluginLoader */
 // require_once 'Zend/Loader/PluginLoader.php';
 
 /** @see Zend_View_Interface */
 // require_once 'Zend/View/Interface.php';
 
 /**
  * Abstract class for Zend_View to help enforce private constructs.
  *
  * @category   Zend
  * @package    Zend_View
  * @copyright  Copyright (c) 2005-2015 Zend Technologies USA Inc. (http://www.zend.com)
  * @license    http://framework.zend.com/license/new-bsd     New BSD License
  */
 abstract class Zend_View_Abstract implements Zend_View_Interface
 {
     /**
      * Path stack for script, helper, and filter directories.
      *
      * @var array
      */
     private $_path = array(
         'script' => array(),
         'helper' => array(),
         'filter' => array(),
     );
 
     /**
      * Script file name to execute
      *
      * @var string
      */
     private $_file = null;
 
     /**
      * Instances of helper objects.
      *
      * @var array
      */
     private $_helper = array();
 
     /**
      * Map of helper => class pairs to help in determining helper class from
      * name
      * @var array
      */
     private $_helperLoaded = array();
 
     /**
      * Map of helper => classfile pairs to aid in determining helper classfile
      * @var array
      */
     private $_helperLoadedDir = array();
 
     /**
      * Stack of Zend_View_Filter names to apply as filters.
      * @var array
      */
     private $_filter = array();
 
     /**
      * Stack of Zend_View_Filter objects that have been loaded
      * @var array
      */
     private $_filterClass = array();
 
     /**
      * Map of filter => class pairs to help in determining filter class from
      * name
      * @var array
      */
     private $_filterLoaded = array();
 
     /**
      * Map of filter => classfile pairs to aid in determining filter classfile
      * @var array
      */
     private $_filterLoadedDir = array();
 
     /**
      * Callback for escaping.
      *
      * @var string
      */
     private $_escape = 'htmlspecialchars';
 
     /**
      * Encoding to use in escaping mechanisms; defaults to utf-8
      * @var string
      */
     private $_encoding = 'UTF-8';
 
     /**
      * Flag indicating whether or not LFI protection for rendering view scripts is enabled
      * @var bool
      */
     private $_lfiProtectionOn = true;
 
     /**
      * Plugin loaders
      * @var array
      */
     private $_loaders = array();
 
     /**
      * Plugin types
      * @var array
      */
     private $_loaderTypes = array('filter', 'helper');
 
     /**
      * Strict variables flag; when on, undefined variables accessed in the view
      * scripts will trigger notices
      * @var boolean
      */
     private $_strictVars = false;
 
     /**
      * Constructor.
      *
      * @param array $config Configuration key-value pairs.
      */
     public function __construct($config = array())
     {
         // set inital paths and properties
         $this->setScriptPath(null);
 
         // $this->setHelperPath(null);
         $this->setFilterPath(null);
 
         // user-defined escaping callback
         if (array_key_exists('escape', $config)) {
             $this->setEscape($config['escape']);
         }
 
         // encoding
         if (array_key_exists('encoding', $config)) {
             $this->setEncoding($config['encoding']);
         }
 
         // base path
         if (array_key_exists('basePath', $config)) {
             $prefix = 'Zend_View';
             if (array_key_exists('basePathPrefix', $config)) {
                 $prefix = $config['basePathPrefix'];
             }
             $this->setBasePath($config['basePath'], $prefix);
         }
 
         // user-defined view script path
         if (array_key_exists('scriptPath', $config)) {
             $this->addScriptPath($config['scriptPath']);
         }
 
         // user-defined helper path
         if (array_key_exists('helperPath', $config)) {
             if (is_array($config['helperPath'])) {
                 foreach ($config['helperPath'] as $prefix => $path) {
                     $this->addHelperPath($path, $prefix);
                 }
             } else {
                 $prefix = 'Zend_View_Helper';
                 if (array_key_exists('helperPathPrefix', $config)) {
                     $prefix = $config['helperPathPrefix'];
                 }
                 $this->addHelperPath($config['helperPath'], $prefix);
             }
         }
 
         // user-defined filter path
         if (array_key_exists('filterPath', $config)) {
             if (is_array($config['filterPath'])) {
                 foreach ($config['filterPath'] as $prefix => $path) {
                     $this->addFilterPath($path, $prefix);
                 }
             } else {
                 $prefix = 'Zend_View_Filter';
                 if (array_key_exists('filterPathPrefix', $config)) {
                     $prefix = $config['filterPathPrefix'];
                 }
                 $this->addFilterPath($config['filterPath'], $prefix);
             }
         }
 
         // user-defined filters
         if (array_key_exists('filter', $config)) {
             $this->addFilter($config['filter']);
         }
 
         // strict vars
         if (array_key_exists('strictVars', $config)) {
             $this->strictVars($config['strictVars']);
         }
 
         // LFI protection flag
         if (array_key_exists('lfiProtectionOn', $config)) {
             $this->setLfiProtection($config['lfiProtectionOn']);
         }
 
         if (array_key_exists('assign', $config)
             && is_array($config['assign'])
         ) {
             foreach ($config['assign'] as $key => $value) {
                 $this->assign($key, $value);
             }
         }
 
         $this->init();
     }
 
     /**
      * Return the template engine object
      *
      * Returns the object instance, as it is its own template engine
      *
      * @return Zend_View_Abstract
      */
     public function getEngine()
     {
         return $this;
     }
 
     /**
      * Allow custom object initialization when extending Zend_View_Abstract or
      * Zend_View
      *
      * Triggered by {@link __construct() the constructor} as its final action.
      *
      * @return void
      */
     public function init()
     {
     }
 
     /**
      * Prevent E_NOTICE for nonexistent values
      *
      * If {@link strictVars()} is on, raises a notice.
      *
      * @param  string $key
      * @return null
      */
     public function __get($key)
     {
         if ($this->_strictVars) {
             trigger_error('Key "' . $key . '" does not exist', E_USER_NOTICE);
         }
 
         return null;
     }
 
     /**
      * Allows testing with empty() and isset() to work inside
      * templates.
      *
      * @param  string $key
      * @return boolean
      */
     public function __isset($key)
     {
         if ('_' != substr($key, 0, 1)) {
             return isset($this->$key);
         }
 
         return false;
     }
 
     /**
      * Directly assigns a variable to the view script.
      *
      * Checks first to ensure that the caller is not attempting to set a
      * protected or private member (by checking for a prefixed underscore); if
      * not, the public member is set; otherwise, an exception is raised.
      *
      * @param string $key The variable name.
      * @param mixed $val The variable value.
      * @return void
      * @throws Zend_View_Exception if an attempt to set a private or protected
      * member is detected
      */
     public function __set($key, $val)
     {
         if ('_' != substr($key, 0, 1)) {
             $this->$key = $val;
             return;
         }
 
         // require_once 'Zend/View/Exception.php';
         $e = new Zend_View_Exception('Setting private or protected class members is not allowed');
         $e->setView($this);
         throw $e;
     }
 
     /**
      * Allows unset() on object properties to work
      *
      * @param string $key
      * @return void
      */
     public function __unset($key)
     {
         if ('_' != substr($key, 0, 1) && isset($this->$key)) {
             unset($this->$key);
         }
     }
 
     /**
      * Accesses a helper object from within a script.
      *
      * If the helper class has a 'view' property, sets it with the current view
      * object.
      *
      * @param string $name The helper name.
      * @param array $args The parameters for the helper.
      * @return string The result of the helper output.
      */
     public function __call($name, $args)
     {
         // is the helper already loaded?
         $helper = $this->getHelper($name);
 
         // call the helper method
         return call_user_func_array(
             array($helper, $name),
             $args
         );
     }
 
     /**
      * Given a base path, sets the script, helper, and filter paths relative to it
      *
      * Assumes a directory structure of:
      * <code>
      * basePath/
      *     scripts/
      *     helpers/
      *     filters/
      * </code>
      *
      * @param  string $path
      * @param  string $prefix Prefix to use for helper and filter paths
      * @return Zend_View_Abstract
      */
     public function setBasePath($path, $classPrefix = 'Zend_View')
     {
         $path        = rtrim($path, '/');
         $path        = rtrim($path, '\\');
         $path       .= DIRECTORY_SEPARATOR;
         $classPrefix = rtrim($classPrefix, '_') . '_';
         $this->setScriptPath($path . 'scripts');
         $this->setHelperPath($path . 'helpers', $classPrefix . 'Helper');
         $this->setFilterPath($path . 'filters', $classPrefix . 'Filter');
         return $this;
     }
 
     /**
      * Given a base path, add script, helper, and filter paths relative to it
      *
      * Assumes a directory structure of:
      * <code>
      * basePath/
      *     scripts/
      *     helpers/
      *     filters/
      * </code>
      *
      * @param  string $path
      * @param  string $prefix Prefix to use for helper and filter paths
      * @return Zend_View_Abstract
      */
     public function addBasePath($path, $classPrefix = 'Zend_View')
     {
         $path        = rtrim($path, '/');
         $path        = rtrim($path, '\\');
         $path       .= DIRECTORY_SEPARATOR;
         $classPrefix = rtrim($classPrefix, '_') . '_';
         $this->addScriptPath($path . 'scripts');
         $this->addHelperPath($path . 'helpers', $classPrefix . 'Helper');
         $this->addFilterPath($path . 'filters', $classPrefix . 'Filter');
         return $this;
     }
 
     /**
      * Adds to the stack of view script paths in LIFO order.
      *
      * @param string|array The directory (-ies) to add.
      * @return Zend_View_Abstract
      */
     public function addScriptPath($path)
     {
         $this->_addPath('script', $path);
         return $this;
     }
 
     /**
      * Resets the stack of view script paths.
      *
      * To clear all paths, use Zend_View::setScriptPath(null).
      *
      * @param string|array The directory (-ies) to set as the path.
      * @return Zend_View_Abstract
      */
     public function setScriptPath($path)
     {
         $this->_path['script'] = array();
         $this->_addPath('script', $path);
         return $this;
     }
 
     /**
      * Return full path to a view script specified by $name
      *
      * @param  string $name
      * @return false|string False if script not found
      * @throws Zend_View_Exception if no script directory set
      */
     public function getScriptPath($name)
     {
         try {
             $path = $this->_script($name);
             return $path;
         } catch (Zend_View_Exception $e) {
             if (strstr($e->getMessage(), 'no view script directory set')) {
                 throw $e;
             }
 
             return false;
         }
     }
 
     /**
      * Returns an array of all currently set script paths
      *
      * @return array
      */
     public function getScriptPaths()
     {
         return $this->_getPaths('script');
     }
 
     /**
      * Set plugin loader for a particular plugin type
      *
      * @param  Zend_Loader_PluginLoader $loader
      * @param  string $type
      * @return Zend_View_Abstract
      */
     public function setPluginLoader(Zend_Loader_PluginLoader $loader, $type)
     {
         $type = strtolower($type);
         if (!in_array($type, $this->_loaderTypes)) {
             // require_once 'Zend/View/Exception.php';
             $e = new Zend_View_Exception(sprintf('Invalid plugin loader type "%s"', $type));
             $e->setView($this);
             throw $e;
         }
 
         $this->_loaders[$type] = $loader;
         return $this;
     }
 
     /**
      * Retrieve plugin loader for a specific plugin type
      *
      * @param  string $type
      * @return Zend_Loader_PluginLoader
      */
     public function getPluginLoader($type)
     {
         $type = strtolower($type);
         if (!in_array($type, $this->_loaderTypes)) {
             // require_once 'Zend/View/Exception.php';
             $e = new Zend_View_Exception(sprintf('Invalid plugin loader type "%s"; cannot retrieve', $type));
             $e->setView($this);
             throw $e;
         }
 
         if (!array_key_exists($type, $this->_loaders)) {
             $prefix     = 'Zend_View_';
             $pathPrefix = 'Zend/View/';
 
             $pType = ucfirst($type);
             switch ($type) {
                 case 'filter':
                 case 'helper':
                 default:
                     $prefix     .= $pType;
                     $pathPrefix .= $pType;
                     $loader = new Zend_Loader_PluginLoader(array(
                         $prefix => $pathPrefix
                     ));
                     $this->_loaders[$type] = $loader;
                     break;
             }
         }
         return $this->_loaders[$type];
     }
 
     /**
      * Adds to the stack of helper paths in LIFO order.
      *
      * @param string|array The directory (-ies) to add.
      * @param string $classPrefix Class prefix to use with classes in this
      * directory; defaults to Zend_View_Helper
      * @return Zend_View_Abstract
      */
     public function addHelperPath($path, $classPrefix = 'Zend_View_Helper_')
     {
         return $this->_addPluginPath('helper', $classPrefix, (array) $path);
     }
 
     /**
      * Resets the stack of helper paths.
      *
      * To clear all paths, use Zend_View::setHelperPath(null).
      *
      * @param string|array $path The directory (-ies) to set as the path.
      * @param string $classPrefix The class prefix to apply to all elements in
      * $path; defaults to Zend_View_Helper
      * @return Zend_View_Abstract
      */
     public function setHelperPath($path, $classPrefix = 'Zend_View_Helper_')
     {
         unset($this->_loaders['helper']);
         return $this->addHelperPath($path, $classPrefix);
     }
 
     /**
      * Get full path to a helper class file specified by $name
      *
      * @param  string $name
      * @return string|false False on failure, path on success
      */
     public function getHelperPath($name)
     {
         return $this->_getPluginPath('helper', $name);
     }
 
     /**
      * Returns an array of all currently set helper paths
      *
      * @return array
      */
     public function getHelperPaths()
     {
         return $this->getPluginLoader('helper')->getPaths();
     }
 
     /**
      * Registers a helper object, bypassing plugin loader
      *
      * @param  Zend_View_Helper_Abstract|object $helper
      * @param  string $name
      * @return Zend_View_Abstract
      * @throws Zend_View_Exception
      */
     public function registerHelper($helper, $name)
     {
         if (!is_object($helper)) {
             // require_once 'Zend/View/Exception.php';
             $e = new Zend_View_Exception('View helper must be an object');
             $e->setView($this);
             throw $e;
         }
 
         if (!$helper instanceof Zend_View_Interface) {
             if (!method_exists($helper, $name)) {
                 // require_once 'Zend/View/Exception.php';
                 $e =  new Zend_View_Exception(
                     'View helper must implement Zend_View_Interface or have a method matching the name provided'
                 );
                 $e->setView($this);
                 throw $e;
             }
         }
 
         if (method_exists($helper, 'setView')) {
             $helper->setView($this);
         }
 
         $name = ucfirst($name);
         $this->_helper[$name] = $helper;
         return $this;
     }
 
     /**
      * Get a helper by name
      *
      * @param  string $name
      * @return object
      */
     public function getHelper($name)
     {
         return $this->_getPlugin('helper', $name);
     }
 
     /**
      * Get array of all active helpers
      *
      * Only returns those that have already been instantiated.
      *
      * @return array
      */
     public function getHelpers()
     {
         return $this->_helper;
     }
 
     /**
      * Adds to the stack of filter paths in LIFO order.
      *
      * @param string|array The directory (-ies) to add.
      * @param string $classPrefix Class prefix to use with classes in this
      * directory; defaults to Zend_View_Filter
      * @return Zend_View_Abstract
      */
     public function addFilterPath($path, $classPrefix = 'Zend_View_Filter_')
     {
         return $this->_addPluginPath('filter', $classPrefix, (array) $path);
     }
 
     /**
      * Resets the stack of filter paths.
      *
      * To clear all paths, use Zend_View::setFilterPath(null).
      *
      * @param string|array The directory (-ies) to set as the path.
      * @param string $classPrefix The class prefix to apply to all elements in
      * $path; defaults to Zend_View_Filter
      * @return Zend_View_Abstract
      */
     public function setFilterPath($path, $classPrefix = 'Zend_View_Filter_')
     {
         unset($this->_loaders['filter']);
         return $this->addFilterPath($path, $classPrefix);
     }
 
     /**
      * Get full path to a filter class file specified by $name
      *
      * @param  string $name
      * @return string|false False on failure, path on success
      */
     public function getFilterPath($name)
     {
         return $this->_getPluginPath('filter', $name);
     }
 
     /**
      * Get a filter object by name
      *
      * @param  string $name
      * @return object
      */
     public function getFilter($name)
     {
         return $this->_getPlugin('filter', $name);
     }
 
     /**
      * Return array of all currently active filters
      *
      * Only returns those that have already been instantiated.
      *
      * @return array
      */
     public function getFilters()
     {
         return $this->_filter;
     }
 
     /**
      * Returns an array of all currently set filter paths
      *
      * @return array
      */
     public function getFilterPaths()
     {
         return $this->getPluginLoader('filter')->getPaths();
     }
 
     /**
      * Return associative array of path types => paths
      *
      * @return array
      */
     public function getAllPaths()
     {
         $paths = $this->_path;
         $paths['helper'] = $this->getHelperPaths();
         $paths['filter'] = $this->getFilterPaths();
         return $paths;
     }
 
     /**
      * Add one or more filters to the stack in FIFO order.
      *
      * @param string|array One or more filters to add.
      * @return Zend_View_Abstract
      */
     public function addFilter($name)
     {
         foreach ((array) $name as $val) {
             $this->_filter[] = $val;
         }
         return $this;
     }
 
     /**
      * Resets the filter stack.
      *
      * To clear all filters, use Zend_View::setFilter(null).
      *
      * @param string|array One or more filters to set.
      * @return Zend_View_Abstract
      */
     public function setFilter($name)
     {
         $this->_filter = array();
         $this->addFilter($name);
         return $this;
     }
 
     /**
      * Sets the _escape() callback.
      *
      * @param mixed $spec The callback for _escape() to use.
      * @return Zend_View_Abstract
      */
     public function setEscape($spec)
     {
         $this->_escape = $spec;
         return $this;
     }
 
     /**
      * Set LFI protection flag
      *
      * @param  bool $flag
      * @return Zend_View_Abstract
      */
     public function setLfiProtection($flag)
     {
         $this->_lfiProtectionOn = (bool) $flag;
         return $this;
     }
 
     /**
      * Return status of LFI protection flag
      *
      * @return bool
      */
     public function isLfiProtectionOn()
     {
         return $this->_lfiProtectionOn;
     }
 
     /**
      * Assigns variables to the view script via differing strategies.
      *
      * Zend_View::assign('name', $value) assigns a variable called 'name'
      * with the corresponding $value.
      *
      * Zend_View::assign($array) assigns the array keys as variable
      * names (with the corresponding array values).
      *
      * @see    __set()
      * @param  string|array The assignment strategy to use.
      * @param  mixed (Optional) If assigning a named variable, use this
      * as the value.
      * @return Zend_View_Abstract Fluent interface
      * @throws Zend_View_Exception if $spec is neither a string nor an array,
      * or if an attempt to set a private or protected member is detected
      */
     public function assign($spec, $value = null)
     {
         // which strategy to use?
         if (is_string($spec)) {
             // assign by name and value
             if ('_' == substr($spec, 0, 1)) {
                 // require_once 'Zend/View/Exception.php';
                 $e = new Zend_View_Exception('Setting private or protected class members is not allowed');
                 $e->setView($this);
                 throw $e;
             }
             $this->$spec = $value;
         } elseif (is_array($spec)) {
             // assign from associative array
             $error = false;
             foreach ($spec as $key => $val) {
                 if ('_' == substr($key, 0, 1)) {
                     $error = true;
                     break;
                 }
                 $this->$key = $val;
             }
             if ($error) {
                 // require_once 'Zend/View/Exception.php';
                 $e = new Zend_View_Exception('Setting private or protected class members is not allowed');
                 $e->setView($this);
                 throw $e;
             }
         } else {
             // require_once 'Zend/View/Exception.php';
             $e = new Zend_View_Exception('assign() expects a string or array, received ' . gettype($spec));
             $e->setView($this);
             throw $e;
         }
 
         return $this;
     }
 
     /**
      * Return list of all assigned variables
      *
      * Returns all public properties of the object. Reflection is not used
      * here as testing reflection properties for visibility is buggy.
      *
      * @return array
      */
     public function getVars()
     {
         $vars   = get_object_vars($this);
         foreach ($vars as $key => $value) {
             if ('_' == substr($key, 0, 1)) {
                 unset($vars[$key]);
             }
         }
 
         return $vars;
     }
 
     /**
      * Clear all assigned variables
      *
      * Clears all variables assigned to Zend_View either via {@link assign()} or
      * property overloading ({@link __set()}).
      *
      * @return void
      */
     public function clearVars()
     {
         $vars   = get_object_vars($this);
         foreach ($vars as $key => $value) {
             if ('_' != substr($key, 0, 1)) {
                 unset($this->$key);
             }
         }
     }
 
     /**
      * Processes a view script and returns the output.
      *
      * @param string $name The script name to process.
      * @return string The script output.
      */
     public function render($name)
     {
         // find the script file name using the parent private method
         $this->_file = $this->_script($name);
         unset($name); // remove $name from local scope
 
         ob_start();
         $this->_run($this->_file);
 
         return $this->_filter(ob_get_clean()); // filter output
     }
 
     /**
      * Escapes a value for output in a view script.
      *
      * If escaping mechanism is one of htmlspecialchars or htmlentities, uses
      * {@link $_encoding} setting.
      *
      * @param mixed $var The output to escape.
      * @return mixed The escaped value.
      */
     public function escape($var)
     {
         if (in_array($this->_escape, array('htmlspecialchars', 'htmlentities'))) {
             return call_user_func($this->_escape, $var, ENT_COMPAT, $this->_encoding);
         }
 
         if (1 == func_num_args()) {
             return call_user_func($this->_escape, $var);
         }
         $args = func_get_args();
         return call_user_func_array($this->_escape, $args);
     }
 
     /**
      * Set encoding to use with htmlentities() and htmlspecialchars()
      *
      * @param string $encoding
      * @return Zend_View_Abstract
      */
     public function setEncoding($encoding)
     {
         $this->_encoding = $encoding;
         return $this;
     }
 
     /**
      * Return current escape encoding
      *
      * @return string
      */
     public function getEncoding()
     {
         return $this->_encoding;
     }
 
     /**
      * Enable or disable strict vars
      *
      * If strict variables are enabled, {@link __get()} will raise a notice
      * when a variable is not defined.
      *
      * Use in conjunction with {@link Zend_View_Helper_DeclareVars the declareVars() helper}
      * to enforce strict variable handling in your view scripts.
      *
      * @param  boolean $flag
      * @return Zend_View_Abstract
      */
     public function strictVars($flag = true)
     {
         $this->_strictVars = ($flag) ? true : false;
 
         return $this;
     }
 
     /**
      * Finds a view script from the available directories.
      *
      * @param string $name The base name of the script.
      * @return void
      */
     protected function _script($name)
     {
         if ($this->isLfiProtectionOn() && preg_match('#\.\.[\\\/]#', $name)) {
             // require_once 'Zend/View/Exception.php';
             $e = new Zend_View_Exception('Requested scripts may not include parent directory traversal ("../", "..\\" notation)');
             $e->setView($this);
             throw $e;
         }
 
         if (0 == count($this->_path['script'])) {
             // require_once 'Zend/View/Exception.php';
             $e = new Zend_View_Exception('no view script directory set; unable to determine location for view script');
             $e->setView($this);
             throw $e;
         }
 
         foreach ($this->_path['script'] as $dir) {
             if (is_readable($dir . $name)) {
                 return $dir . $name;
             }
         }
 
         // require_once 'Zend/View/Exception.php';
         $message = "script '$name' not found in path ("
                  . implode(PATH_SEPARATOR, $this->_path['script'])
                  . ")";
         $e = new Zend_View_Exception($message);
         $e->setView($this);
         throw $e;
     }
 
     /**
      * Applies the filter callback to a buffer.
      *
      * @param string $buffer The buffer contents.
      * @return string The filtered buffer.
      */
     private function _filter($buffer)
     {
         // loop through each filter class
         foreach ($this->_filter as $name) {
             // load and apply the filter class
             $filter = $this->getFilter($name);
             $buffer = call_user_func(array($filter, 'filter'), $buffer);
         }
 
         // done!
         return $buffer;
     }
 
     /**
      * Adds paths to the path stack in LIFO order.
      *
      * Zend_View::_addPath($type, 'dirname') adds one directory
      * to the path stack.
      *
      * Zend_View::_addPath($type, $array) adds one directory for
      * each array element value.
      *
      * In the case of filter and helper paths, $prefix should be used to
      * specify what class prefix to use with the given path.
      *
      * @param string $type The path type ('script', 'helper', or 'filter').
      * @param string|array $path The path specification.
      * @param string $prefix Class prefix to use with path (helpers and filters
      * only)
      * @return void
      */
     private function _addPath($type, $path, $prefix = null)
     {
         foreach ((array) $path as $dir) {
             // attempt to strip any possible separator and
             // append the system directory separator
             $dir  = rtrim($dir, '/');
             $dir  = rtrim($dir, '\\');
             $dir .= '/';
 
             switch ($type) {
                 case 'script':
                     // add to the top of the stack.
                     array_unshift($this->_path[$type], $dir);
                     break;
                 case 'filter':
                 case 'helper':
                 default:
                     // add as array with prefix and dir keys
                     array_unshift($this->_path[$type], array('prefix' => $prefix, 'dir' => $dir));
                     break;
             }
         }
     }
 
     /**
      * Resets the path stack for helpers and filters.
      *
      * @param string $type The path type ('helper' or 'filter').
      * @param string|array $path The directory (-ies) to set as the path.
      * @param string $classPrefix Class prefix to apply to elements of $path
      */
     private function _setPath($type, $path, $classPrefix = null)
     {
         $dir = DIRECTORY_SEPARATOR . ucfirst($type) . DIRECTORY_SEPARATOR;
 
         switch ($type) {
             case 'script':
                 $this->_path[$type] = array(dirname(__FILE__) . $dir);
                 $this->_addPath($type, $path);
                 break;
             case 'filter':
             case 'helper':
             default:
                 $this->_path[$type] = array(array(
                     'prefix' => 'Zend_View_' . ucfirst($type) . '_',
                     'dir'    => dirname(__FILE__) . $dir
                 ));
                 $this->_addPath($type, $path, $classPrefix);
                 break;
         }
     }
 
     /**
      * Return all paths for a given path type
      *
      * @param string $type The path type  ('helper', 'filter', 'script')
      * @return array
      */
     private function _getPaths($type)
     {
         return $this->_path[$type];
     }
 
     /**
      * Register helper class as loaded
      *
      * @param  string $name
      * @param  string $class
      * @param  string $file path to class file
      * @return void
      */
     private function _setHelperClass($name, $class, $file)
     {
         $this->_helperLoadedDir[$name] = $file;
         $this->_helperLoaded[$name]    = $class;
     }
 
     /**
      * Register filter class as loaded
      *
      * @param  string $name
      * @param  string $class
      * @param  string $file path to class file
      * @return void
      */
     private function _setFilterClass($name, $class, $file)
     {
         $this->_filterLoadedDir[$name] = $file;
         $this->_filterLoaded[$name]    = $class;
     }
 
     /**
      * Add a prefixPath for a plugin type
      *
      * @param  string $type
      * @param  string $classPrefix
      * @param  array $paths
      * @return Zend_View_Abstract
      */
     private function _addPluginPath($type, $classPrefix, array $paths)
     {
         $loader = $this->getPluginLoader($type);
         foreach ($paths as $path) {
             $loader->addPrefixPath($classPrefix, $path);
         }
         return $this;
     }
 
     /**
      * Get a path to a given plugin class of a given type
      *
      * @param  string $type
      * @param  string $name
      * @return string|false
      */
     private function _getPluginPath($type, $name)
     {
         $loader = $this->getPluginLoader($type);
         if ($loader->isLoaded($name)) {
             return $loader->getClassPath($name);
         }
 
         try {
             $loader->load($name);
             return $loader->getClassPath($name);
         } catch (Zend_Loader_Exception $e) {
             return false;
         }
     }
 
     /**
      * Retrieve a plugin object
      *
      * @param  string $type
      * @param  string $name
      * @return object
      */
     private function _getPlugin($type, $name)
     {
         $name = ucfirst($name);
         switch ($type) {
             case 'filter':
                 $storeVar = '_filterClass';
                 $store    = $this->_filterClass;
                 break;
             case 'helper':
                 $storeVar = '_helper';
                 $store    = $this->_helper;
                 break;
         }
 
         if (!isset($store[$name])) {
             $class = $this->getPluginLoader($type)->load($name);
             $store[$name] = new $class();
             if (method_exists($store[$name], 'setView')) {
                 $store[$name]->setView($this);
             }
         }
 
         $this->$storeVar = $store;
         return $store[$name];
     }
 
     /**
      * Use to include the view script in a scope that only allows public
      * members.
      *
      * @return mixed
      */
     abstract protected function _run();
 }