Blame | Last modification | View Log | RSS feed
<?php/*** Methods for displaying presentation data in the view.** CakePHP(tm) : Rapid Development Framework (http://cakephp.org)* Copyright (c) Cake Software Foundation, Inc. (http://cakefoundation.org)** Licensed under The MIT License* For full copyright and license information, please see the LICENSE.txt* Redistributions of files must retain the above copyright notice.** @copyright Copyright (c) Cake Software Foundation, Inc. (http://cakefoundation.org)* @link http://cakephp.org CakePHP(tm) Project* @package Cake.View* @since CakePHP(tm) v 0.10.0.1076* @license http://www.opensource.org/licenses/mit-license.php MIT License*/App::uses('HelperCollection', 'View');App::uses('AppHelper', 'View/Helper');App::uses('Router', 'Routing');App::uses('ViewBlock', 'View');App::uses('CakeEvent', 'Event');App::uses('CakeEventManager', 'Event');App::uses('CakeResponse', 'Network');/*** View, the V in the MVC triad. View interacts with Helpers and view variables passed* in from the controller to render the results of the controller action. Often this is HTML,* but can also take the form of JSON, XML, PDF's or streaming files.** CakePHP uses a two-step-view pattern. This means that the view content is rendered first,* and then inserted into the selected layout. This also means you can pass data from the view to the* layout using `$this->set()`** Since 2.1, the base View class also includes support for themes by default. Theme views are regular* view files that can provide unique HTML and static assets. If theme views are not found for the* current view the default app view files will be used. You can set `$this->theme = 'mytheme'`* in your Controller to use the Themes.** Example of theme path with `$this->theme = 'SuperHot';` Would be `app/View/Themed/SuperHot/Posts`** @package Cake.View* @property CacheHelper $Cache* @property FormHelper $Form* @property HtmlHelper $Html* @property JsHelper $Js* @property NumberHelper $Number* @property PaginatorHelper $Paginator* @property RssHelper $Rss* @property SessionHelper $Session* @property TextHelper $Text* @property TimeHelper $Time* @property ViewBlock $Blocks*/class View extends Object {/*** Helpers collection** @var HelperCollection*/public $Helpers;/*** ViewBlock instance.** @var ViewBlock*/public $Blocks;/*** Name of the plugin.** @link http://manual.cakephp.org/chapter/plugins* @var string*/public $plugin = null;/*** Name of the controller.** @var string*/public $name = null;/*** Current passed params** @var mixed*/public $passedArgs = array();/*** An array of names of built-in helpers to include.** @var mixed*/public $helpers = array();/*** Path to View.** @var string*/public $viewPath = null;/*** Variables for the view** @var array*/public $viewVars = array();/*** Name of view to use with this View.** @var string*/public $view = null;/*** Name of layout to use with this View.** @var string*/public $layout = 'default';/*** Path to Layout.** @var string*/public $layoutPath = null;/*** Turns on or off CakePHP's conventional mode of applying layout files. On by default.* Setting to off means that layouts will not be automatically applied to rendered views.** @var bool*/public $autoLayout = true;/*** File extension. Defaults to CakePHP's template ".ctp".** @var string*/public $ext = '.ctp';/*** Sub-directory for this view file. This is often used for extension based routing.* Eg. With an `xml` extension, $subDir would be `xml/`** @var string*/public $subDir = null;/*** Theme name.** @var string*/public $theme = null;/*** Used to define methods a controller that will be cached.** @see Controller::$cacheAction* @var mixed*/public $cacheAction = false;/*** Holds current errors for the model validation.** @var array*/public $validationErrors = array();/*** True when the view has been rendered.** @var bool*/public $hasRendered = false;/*** List of generated DOM UUIDs.** @var array*/public $uuids = array();/*** An instance of a CakeRequest object that contains information about the current request.* This object contains all the information about a request and several methods for reading* additional information about the request.** @var CakeRequest*/public $request;/*** Reference to the Response object** @var CakeResponse*/public $response;/*** The Cache configuration View will use to store cached elements. Changing this will change* the default configuration elements are stored under. You can also choose a cache config* per element.** @var string* @see View::element()*/public $elementCache = 'default';/*** Element cache settings** @var array* @see View::_elementCache();* @see View::_renderElement*/public $elementCacheSettings = array();/*** List of variables to collect from the associated controller.** @var array*/protected $_passedVars = array('viewVars', 'autoLayout', 'ext', 'helpers', 'view', 'layout', 'name', 'theme','layoutPath', 'viewPath', 'request', 'plugin', 'passedArgs', 'cacheAction');/*** Scripts (and/or other <head /> tags) for the layout.** @var array*/protected $_scripts = array();/*** Holds an array of paths.** @var array*/protected $_paths = array();/*** Holds an array of plugin paths.** @var array*/protected $_pathsForPlugin = array();/*** The names of views and their parents used with View::extend();** @var array*/protected $_parents = array();/*** The currently rendering view file. Used for resolving parent files.** @var string*/protected $_current = null;/*** Currently rendering an element. Used for finding parent fragments* for elements.** @var string*/protected $_currentType = '';/*** Content stack, used for nested templates that all use View::extend();** @var array*/protected $_stack = array();/*** Instance of the CakeEventManager this View object is using* to dispatch inner events. Usually the manager is shared with* the controller, so it it possible to register view events in* the controller layer.** @var CakeEventManager*/protected $_eventManager = null;/*** Whether the event manager was already configured for this object** @var bool*/protected $_eventManagerConfigured = false;/*** Constant for view file type 'view'** @var string*/const TYPE_VIEW = 'view';/*** Constant for view file type 'element'** @var string*/const TYPE_ELEMENT = 'element';/*** Constant for view file type 'layout'** @var string*/const TYPE_LAYOUT = 'layout';/*** Constructor** @param Controller $controller A controller object to pull View::_passedVars from.*/public function __construct(Controller $controller = null) {if (is_object($controller)) {$count = count($this->_passedVars);for ($j = 0; $j < $count; $j++) {$var = $this->_passedVars[$j];$this->{$var} = $controller->{$var};}$this->_eventManager = $controller->getEventManager();}if (empty($this->request) && !($this->request = Router::getRequest(true))) {$this->request = new CakeRequest(null, false);$this->request->base = '';$this->request->here = $this->request->webroot = '/';}if (is_object($controller) && isset($controller->response)) {$this->response = $controller->response;} else {$this->response = new CakeResponse();}$this->Helpers = new HelperCollection($this);$this->Blocks = new ViewBlock();$this->loadHelpers();parent::__construct();}/*** Returns the CakeEventManager manager instance that is handling any callbacks.* You can use this instance to register any new listeners or callbacks to the* controller events, or create your own events and trigger them at will.** @return CakeEventManager*/public function getEventManager() {if (empty($this->_eventManager)) {$this->_eventManager = new CakeEventManager();}if (!$this->_eventManagerConfigured) {$this->_eventManager->attach($this->Helpers);$this->_eventManagerConfigured = true;}return $this->_eventManager;}/*** Renders a piece of PHP with provided parameters and returns HTML, XML, or any other string.** This realizes the concept of Elements, (or "partial layouts") and the $params array is used to send* data to be used in the element. Elements can be cached improving performance by using the `cache` option.** @param string $name Name of template file in the/app/View/Elements/ folder,* or `MyPlugin.template` to use the template element from MyPlugin. If the element* is not found in the plugin, the normal view path cascade will be searched.* @param array $data Array of data to be made available to the rendered view (i.e. the Element)* @param array $options Array of options. Possible keys are:* - `cache` - Can either be `true`, to enable caching using the config in View::$elementCache. Or an array* If an array, the following keys can be used:* - `config` - Used to store the cached element in a custom cache configuration.* - `key` - Used to define the key used in the Cache::write(). It will be prefixed with `element_`* - `plugin` - (deprecated!) Load an element from a specific plugin. This option is deprecated, and* will be removed in CakePHP 3.0. Use `Plugin.element_name` instead.* - `callbacks` - Set to true to fire beforeRender and afterRender helper callbacks for this element.* Defaults to false.* - `ignoreMissing` - Used to allow missing elements. Set to true to not trigger notices.* @return string Rendered Element*/public function element($name, $data = array(), $options = array()) {$file = $plugin = null;if (isset($options['plugin'])) {$name = Inflector::camelize($options['plugin']) . '.' . $name;}if (!isset($options['callbacks'])) {$options['callbacks'] = false;}if (isset($options['cache'])) {$contents = $this->_elementCache($name, $data, $options);if ($contents !== false) {return $contents;}}$file = $this->_getElementFilename($name);if ($file) {return $this->_renderElement($file, $data, $options);}if (empty($options['ignoreMissing'])) {list ($plugin, $name) = pluginSplit($name, true);$name = str_replace('/', DS, $name);$file = $plugin . 'Elements' . DS . $name . $this->ext;trigger_error(__d('cake_dev', 'Element Not Found: %s', $file), E_USER_NOTICE);}}/*** Checks if an element exists** @param string $name Name of template file in the /app/View/Elements/ folder,* or `MyPlugin.template` to check the template element from MyPlugin. If the element* is not found in the plugin, the normal view path cascade will be searched.* @return bool Success*/public function elementExists($name) {return (bool)$this->_getElementFilename($name);}/*** Renders view for given view file and layout.** Render triggers helper callbacks, which are fired before and after the view are rendered,* as well as before and after the layout. The helper callbacks are called:** - `beforeRender`* - `afterRender`* - `beforeLayout`* - `afterLayout`** If View::$autoRender is false and no `$layout` is provided, the view will be returned bare.** View and layout names can point to plugin views/layouts. Using the `Plugin.view` syntax* a plugin view/layout can be used instead of the app ones. If the chosen plugin is not found* the view will be located along the regular view path cascade.** @param string $view Name of view file to use* @param string $layout Layout to use.* @return string|null Rendered content or null if content already rendered and returned earlier.* @triggers View.beforeRender $this, array($viewFileName)* @triggers View.afterRender $this, array($viewFileName)* @throws CakeException If there is an error in the view.*/public function render($view = null, $layout = null) {if ($this->hasRendered) {return;}if ($view !== false && $viewFileName = $this->_getViewFileName($view)) {$this->_currentType = static::TYPE_VIEW;$this->getEventManager()->dispatch(new CakeEvent('View.beforeRender', $this, array($viewFileName)));$this->Blocks->set('content', $this->_render($viewFileName));$this->getEventManager()->dispatch(new CakeEvent('View.afterRender', $this, array($viewFileName)));}if ($layout === null) {$layout = $this->layout;}if ($layout && $this->autoLayout) {$this->Blocks->set('content', $this->renderLayout('', $layout));}$this->hasRendered = true;return $this->Blocks->get('content');}/*** Renders a layout. Returns output from _render(). Returns false on error.* Several variables are created for use in layout.** - `title_for_layout` - A backwards compatible place holder, you should set this value if you want more control.* - `content_for_layout` - contains rendered view file* - `scripts_for_layout` - Contains content added with addScript() as well as any content in* the 'meta', 'css', and 'script' blocks. They are appended in that order.** Deprecated features:** - `$scripts_for_layout` is deprecated and will be removed in CakePHP 3.0.* Use the block features instead. `meta`, `css` and `script` will be populated* by the matching methods on HtmlHelper.* - `$title_for_layout` is deprecated and will be removed in CakePHP 3.0.* Use the `title` block instead.* - `$content_for_layout` is deprecated and will be removed in CakePHP 3.0.* Use the `content` block instead.** @param string $content Content to render in a view, wrapped by the surrounding layout.* @param string $layout Layout name* @return mixed Rendered output, or false on error* @triggers View.beforeLayout $this, array($layoutFileName)* @triggers View.afterLayout $this, array($layoutFileName)* @throws CakeException if there is an error in the view.*/public function renderLayout($content, $layout = null) {$layoutFileName = $this->_getLayoutFileName($layout);if (empty($layoutFileName)) {return $this->Blocks->get('content');}if (empty($content)) {$content = $this->Blocks->get('content');} else {$this->Blocks->set('content', $content);}$this->getEventManager()->dispatch(new CakeEvent('View.beforeLayout', $this, array($layoutFileName)));$scripts = implode("\n\t", $this->_scripts);$scripts .= $this->Blocks->get('meta') . $this->Blocks->get('css') . $this->Blocks->get('script');$this->viewVars = array_merge($this->viewVars, array('content_for_layout' => $content,'scripts_for_layout' => $scripts,));$title = $this->Blocks->get('title');if ($title === '') {if (isset($this->viewVars['title_for_layout'])) {$title = $this->viewVars['title_for_layout'];} else {$title = Inflector::humanize($this->viewPath);}}$this->viewVars['title_for_layout'] = $title;$this->Blocks->set('title', $title);$this->_currentType = static::TYPE_LAYOUT;$this->Blocks->set('content', $this->_render($layoutFileName));$this->getEventManager()->dispatch(new CakeEvent('View.afterLayout', $this, array($layoutFileName)));return $this->Blocks->get('content');}/*** Render cached view. Works in concert with CacheHelper and Dispatcher to* render cached view files.** @param string $filename the cache file to include* @param string $timeStart the page render start time* @return bool Success of rendering the cached file.*/public function renderCache($filename, $timeStart) {$response = $this->response;ob_start();include $filename;$type = $response->mapType($response->type());if (Configure::read('debug') > 0 && $type === 'html') {echo "<!-- Cached Render Time: " . round(microtime(true) - $timeStart, 4) . "s -->";}$out = ob_get_clean();if (preg_match('/^<!--cachetime:(\\d+)-->/', $out, $match)) {if (time() >= $match['1']) {//@codingStandardsIgnoreStart@unlink($filename);//@codingStandardsIgnoreEndunset($out);return false;}return substr($out, strlen($match[0]));}}/*** Returns a list of variables available in the current View context** @return array Array of the set view variable names.*/public function getVars() {return array_keys($this->viewVars);}/*** Returns the contents of the given View variable(s)** @param string $var The view var you want the contents of.* @return mixed The content of the named var if its set, otherwise null.* @deprecated 3.0.0 Will be removed in 3.0. Use View::get() instead.*/public function getVar($var) {return $this->get($var);}/*** Returns the contents of the given View variable.** @param string $var The view var you want the contents of.* @param mixed $default The default/fallback content of $var.* @return mixed The content of the named var if its set, otherwise $default.*/public function get($var, $default = null) {if (!isset($this->viewVars[$var])) {return $default;}return $this->viewVars[$var];}/*** Get the names of all the existing blocks.** @return array An array containing the blocks.* @see ViewBlock::keys()*/public function blocks() {return $this->Blocks->keys();}/*** Start capturing output for a 'block'** @param string $name The name of the block to capture for.* @return void* @see ViewBlock::start()*/public function start($name) {$this->Blocks->start($name);}/*** Start capturing output for a 'block' if it has no content** @param string $name The name of the block to capture for.* @return void* @see ViewBlock::startIfEmpty()*/public function startIfEmpty($name) {$this->Blocks->startIfEmpty($name);}/*** Append to an existing or new block. Appending to a new* block will create the block.** @param string $name Name of the block* @param mixed $value The content for the block.* @return void* @see ViewBlock::concat()*/public function append($name, $value = null) {$this->Blocks->concat($name, $value);}/*** Prepend to an existing or new block. Prepending to a new* block will create the block.** @param string $name Name of the block* @param mixed $value The content for the block.* @return void* @see ViewBlock::concat()*/public function prepend($name, $value = null) {$this->Blocks->concat($name, $value, ViewBlock::PREPEND);}/*** Set the content for a block. This will overwrite any* existing content.** @param string $name Name of the block* @param mixed $value The content for the block.* @return void* @see ViewBlock::set()*/public function assign($name, $value) {$this->Blocks->set($name, $value);}/*** Fetch the content for a block. If a block is* empty or undefined '' will be returned.** @param string $name Name of the block* @param string $default Default text* @return string default The block content or $default if the block does not exist.* @see ViewBlock::get()*/public function fetch($name, $default = '') {return $this->Blocks->get($name, $default);}/*** Check if a block exists** @param string $name Name of the block* @return bool*/public function exists($name) {return $this->Blocks->exists($name);}/*** End a capturing block. The compliment to View::start()** @return void* @see ViewBlock::end()*/public function end() {$this->Blocks->end();}/*** Provides view or element extension/inheritance. Views can extends a* parent view and populate blocks in the parent template.** @param string $name The view or element to 'extend' the current one with.* @return void* @throws LogicException when you extend a view with itself or make extend loops.* @throws LogicException when you extend an element which doesn't exist*/public function extend($name) {if ($name[0] === '/' || $this->_currentType === static::TYPE_VIEW) {$parent = $this->_getViewFileName($name);} else {switch ($this->_currentType) {case static::TYPE_ELEMENT:$parent = $this->_getElementFileName($name);if (!$parent) {list($plugin, $name) = $this->pluginSplit($name);$paths = $this->_paths($plugin);$defaultPath = $paths[0] . 'Elements' . DS;throw new LogicException(__d('cake_dev','You cannot extend an element which does not exist (%s).',$defaultPath . $name . $this->ext));}break;case static::TYPE_LAYOUT:$parent = $this->_getLayoutFileName($name);break;default:$parent = $this->_getViewFileName($name);}}if ($parent == $this->_current) {throw new LogicException(__d('cake_dev', 'You cannot have views extend themselves.'));}if (isset($this->_parents[$parent]) && $this->_parents[$parent] == $this->_current) {throw new LogicException(__d('cake_dev', 'You cannot have views extend in a loop.'));}$this->_parents[$this->_current] = $parent;}/*** Adds a script block or other element to be inserted in $scripts_for_layout in* the `<head />` of a document layout** @param string $name Either the key name for the script, or the script content. Name can be used to* update/replace a script element.* @param string $content The content of the script being added, optional.* @return void* @deprecated 3.0.0 Will be removed in 3.0. Superseded by blocks functionality.* @see View::start()*/public function addScript($name, $content = null) {if (empty($content)) {if (!in_array($name, array_values($this->_scripts))) {$this->_scripts[] = $name;}} else {$this->_scripts[$name] = $content;}}/*** Generates a unique, non-random DOM ID for an object, based on the object type and the target URL.** @param string $object Type of object, i.e. 'form' or 'link'* @param string $url The object's target URL* @return string*/public function uuid($object, $url) {$c = 1;$url = Router::url($url);$hash = $object . substr(md5($object . $url), 0, 10);while (in_array($hash, $this->uuids)) {$hash = $object . substr(md5($object . $url . $c), 0, 10);$c++;}$this->uuids[] = $hash;return $hash;}/*** Allows a template or element to set a variable that will be available in* a layout or other element. Analogous to Controller::set().** @param string|array $one A string or an array of data.* @param string|array $two Value in case $one is a string (which then works as the key).* Unused if $one is an associative array, otherwise serves as the values to $one's keys.* @return void*/public function set($one, $two = null) {$data = null;if (is_array($one)) {if (is_array($two)) {$data = array_combine($one, $two);} else {$data = $one;}} else {$data = array($one => $two);}if (!$data) {return false;}$this->viewVars = $data + $this->viewVars;}/*** Retrieve the current view type** @return string*/public function getCurrentType() {return $this->_currentType;}/*** Magic accessor for helpers. Provides access to attributes that were deprecated.** @param string $name Name of the attribute to get.* @return mixed*/public function __get($name) {switch ($name) {case 'base':case 'here':case 'webroot':case 'data':return $this->request->{$name};case 'action':return $this->request->params['action'];case 'params':return $this->request;case 'output':return $this->Blocks->get('content');}if (isset($this->Helpers->{$name})) {$this->{$name} = $this->Helpers->{$name};return $this->Helpers->{$name};}return $this->{$name};}/*** Magic accessor for deprecated attributes.** @param string $name Name of the attribute to set.* @param mixed $value Value of the attribute to set.* @return mixed*/public function __set($name, $value) {switch ($name) {case 'output':return $this->Blocks->set('content', $value);default:$this->{$name} = $value;}}/*** Magic isset check for deprecated attributes.** @param string $name Name of the attribute to check.* @return bool*/public function __isset($name) {if (isset($this->{$name})) {return true;}$magicGet = array('base', 'here', 'webroot', 'data', 'action', 'params', 'output');if (in_array($name, $magicGet)) {return $this->__get($name) !== null;}return false;}/*** Interact with the HelperCollection to load all the helpers.** @return void*/public function loadHelpers() {$helpers = HelperCollection::normalizeObjectArray($this->helpers);foreach ($helpers as $properties) {list(, $class) = pluginSplit($properties['class']);$this->{$class} = $this->Helpers->load($properties['class'], $properties['settings']);}}/*** Renders and returns output for given view filename with its* array of data. Handles parent/extended views.** @param string $viewFile Filename of the view* @param array $data Data to include in rendered view. If empty the current View::$viewVars will be used.* @return string Rendered output* @triggers View.beforeRenderFile $this, array($viewFile)* @triggers View.afterRenderFile $this, array($viewFile, $content)* @throws CakeException when a block is left open.*/protected function _render($viewFile, $data = array()) {if (empty($data)) {$data = $this->viewVars;}$this->_current = $viewFile;$initialBlocks = count($this->Blocks->unclosed());$eventManager = $this->getEventManager();$beforeEvent = new CakeEvent('View.beforeRenderFile', $this, array($viewFile));$eventManager->dispatch($beforeEvent);$content = $this->_evaluate($viewFile, $data);$afterEvent = new CakeEvent('View.afterRenderFile', $this, array($viewFile, $content));$afterEvent->modParams = 1;$eventManager->dispatch($afterEvent);$content = $afterEvent->data[1];if (isset($this->_parents[$viewFile])) {$this->_stack[] = $this->fetch('content');$this->assign('content', $content);$content = $this->_render($this->_parents[$viewFile]);$this->assign('content', array_pop($this->_stack));}$remainingBlocks = count($this->Blocks->unclosed());if ($initialBlocks !== $remainingBlocks) {throw new CakeException(__d('cake_dev', 'The "%s" block was left open. Blocks are not allowed to cross files.', $this->Blocks->active()));}return $content;}/*** Sandbox method to evaluate a template / view script in.** @param string $viewFile Filename of the view* @param array $dataForView Data to include in rendered view.* If empty the current View::$viewVars will be used.* @return string Rendered output*/protected function _evaluate($viewFile, $dataForView) {$this->__viewFile = $viewFile;extract($dataForView);ob_start();include $this->__viewFile;unset($this->__viewFile);return ob_get_clean();}/*** Loads a helper. Delegates to the `HelperCollection::load()` to load the helper** @param string $helperName Name of the helper to load.* @param array $settings Settings for the helper* @return Helper a constructed helper object.* @see HelperCollection::load()*/public function loadHelper($helperName, $settings = array()) {return $this->Helpers->load($helperName, $settings);}/*** Returns filename of given action's template file (.ctp) as a string.* CamelCased action names will be under_scored! This means that you can have* LongActionNames that refer to long_action_names.ctp views.** @param string $name Controller action to find template filename for* @return string Template filename* @throws MissingViewException when a view file could not be found.*/protected function _getViewFileName($name = null) {$subDir = null;if ($this->subDir !== null) {$subDir = $this->subDir . DS;}if ($name === null) {$name = $this->view;}$name = str_replace('/', DS, $name);list($plugin, $name) = $this->pluginSplit($name);if (strpos($name, DS) === false && $name[0] !== '.') {$name = $this->viewPath . DS . $subDir . Inflector::underscore($name);} elseif (strpos($name, DS) !== false) {if ($name[0] === DS || $name[1] === ':') {if (is_file($name)) {return $name;}$name = trim($name, DS);} elseif ($name[0] === '.') {$name = substr($name, 3);} elseif (!$plugin || $this->viewPath !== $this->name) {$name = $this->viewPath . DS . $subDir . $name;}}$paths = $this->_paths($plugin);$exts = $this->_getExtensions();foreach ($exts as $ext) {foreach ($paths as $path) {if (file_exists($path . $name . $ext)) {return $path . $name . $ext;}}}throw new MissingViewException(array('file' => $name . $this->ext));}/*** Splits a dot syntax plugin name into its plugin and filename.* If $name does not have a dot, then index 0 will be null.* It checks if the plugin is loaded, else filename will stay unchanged for filenames containing dot** @param string $name The name you want to plugin split.* @param bool $fallback If true uses the plugin set in the current CakeRequest when parsed plugin is not loaded* @return array Array with 2 indexes. 0 => plugin name, 1 => filename*/public function pluginSplit($name, $fallback = true) {$plugin = null;list($first, $second) = pluginSplit($name);if (CakePlugin::loaded($first) === true) {$name = $second;$plugin = $first;}if (isset($this->plugin) && !$plugin && $fallback) {$plugin = $this->plugin;}return array($plugin, $name);}/*** Returns layout filename for this template as a string.** @param string $name The name of the layout to find.* @return string Filename for layout file (.ctp).* @throws MissingLayoutException when a layout cannot be located*/protected function _getLayoutFileName($name = null) {if ($name === null) {$name = $this->layout;}$subDir = null;if ($this->layoutPath !== null) {$subDir = $this->layoutPath . DS;}list($plugin, $name) = $this->pluginSplit($name);$paths = $this->_paths($plugin);$file = 'Layouts' . DS . $subDir . $name;$exts = $this->_getExtensions();foreach ($exts as $ext) {foreach ($paths as $path) {if (file_exists($path . $file . $ext)) {return $path . $file . $ext;}}}throw new MissingLayoutException(array('file' => $file . $this->ext));}/*** Get the extensions that view files can use.** @return array Array of extensions view files use.*/protected function _getExtensions() {$exts = array($this->ext);if ($this->ext !== '.ctp') {$exts[] = '.ctp';}return $exts;}/*** Finds an element filename, returns false on failure.** @param string $name The name of the element to find.* @return mixed Either a string to the element filename or false when one can't be found.*/protected function _getElementFileName($name) {list($plugin, $name) = $this->pluginSplit($name);$paths = $this->_paths($plugin);$exts = $this->_getExtensions();foreach ($exts as $ext) {foreach ($paths as $path) {if (file_exists($path . 'Elements' . DS . $name . $ext)) {return $path . 'Elements' . DS . $name . $ext;}}}return false;}/*** Return all possible paths to find view files in order** @param string $plugin Optional plugin name to scan for view files.* @param bool $cached Set to false to force a refresh of view paths. Default true.* @return array paths*/protected function _paths($plugin = null, $cached = true) {if ($cached === true) {if ($plugin === null && !empty($this->_paths)) {return $this->_paths;}if ($plugin !== null && isset($this->_pathsForPlugin[$plugin])) {return $this->_pathsForPlugin[$plugin];}}$paths = array();$viewPaths = App::path('View');$corePaths = array_merge(App::core('View'), App::core('Console/Templates/skel/View'));if (!empty($plugin)) {$count = count($viewPaths);for ($i = 0; $i < $count; $i++) {if (!in_array($viewPaths[$i], $corePaths)) {$paths[] = $viewPaths[$i] . 'Plugin' . DS . $plugin . DS;}}$paths = array_merge($paths, App::path('View', $plugin));}$paths = array_unique(array_merge($paths, $viewPaths));if (!empty($this->theme)) {$theme = Inflector::camelize($this->theme);$themePaths = array();foreach ($paths as $path) {if (strpos($path, DS . 'Plugin' . DS) === false) {if ($plugin) {$themePaths[] = $path . 'Themed' . DS . $theme . DS . 'Plugin' . DS . $plugin . DS;}$themePaths[] = $path . 'Themed' . DS . $theme . DS;}}$paths = array_merge($themePaths, $paths);}$paths = array_merge($paths, $corePaths);if ($plugin !== null) {return $this->_pathsForPlugin[$plugin] = $paths;}return $this->_paths = $paths;}/*** Checks if an element is cached and returns the cached data if present** @param string $name Element name* @param string $data Data* @param array $options Element options* @return string|null*/protected function _elementCache($name, $data, $options) {$plugin = null;list($plugin, $name) = $this->pluginSplit($name);$underscored = null;if ($plugin) {$underscored = Inflector::underscore($plugin);}$keys = array_merge(array($underscored, $name), array_keys($options), array_keys($data));$this->elementCacheSettings = array('config' => $this->elementCache,'key' => implode('_', $keys));if (is_array($options['cache'])) {$defaults = array('config' => $this->elementCache,'key' => $this->elementCacheSettings['key']);$this->elementCacheSettings = array_merge($defaults, $options['cache']);}$this->elementCacheSettings['key'] = 'element_' . $this->elementCacheSettings['key'];return Cache::read($this->elementCacheSettings['key'], $this->elementCacheSettings['config']);}/*** Renders an element and fires the before and afterRender callbacks for it* and writes to the cache if a cache is used** @param string $file Element file path* @param array $data Data to render* @param array $options Element options* @return string* @triggers View.beforeRender $this, array($file)* @triggers View.afterRender $this, array($file, $element)*/protected function _renderElement($file, $data, $options) {$current = $this->_current;$restore = $this->_currentType;$this->_currentType = static::TYPE_ELEMENT;if ($options['callbacks']) {$this->getEventManager()->dispatch(new CakeEvent('View.beforeRender', $this, array($file)));}$element = $this->_render($file, array_merge($this->viewVars, $data));if ($options['callbacks']) {$this->getEventManager()->dispatch(new CakeEvent('View.afterRender', $this, array($file, $element)));}$this->_currentType = $restore;$this->_current = $current;if (isset($options['cache'])) {Cache::write($this->elementCacheSettings['key'], $element, $this->elementCacheSettings['config']);}return $element;}}