pictcode

<?php

/**

 * Html Helper class file.

 *

 * Simplifies the construction of HTML elements.

 *

 * 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.Helper

 * @since         CakePHP(tm) v 0.9.1

 * @license       http://www.opensource.org/licenses/mit-license.php MIT License

 */

App::uses('AppHelper', 'View/Helper');

App::uses('CakeResponse', 'Network');

/**

 * Html Helper class for easy use of HTML widgets.

 *

 * HtmlHelper encloses all methods needed while working with HTML pages.

 *

 * @package       Cake.View.Helper

 * @link http://book.cakephp.org/2.0/en/core-libraries/helpers/html.html

 */

class HtmlHelper extends AppHelper {

/**

 * Reference to the Response object

 *

 * @var CakeResponse

 */

        public $response;

/**

 * html tags used by this helper.

 *

 * @var array

 */

        protected $_tags = array(

                'meta' => '<meta%s/>',

                'metalink' => '<link href="%s"%s/>',

                'link' => '<a href="%s"%s>%s</a>',

                'mailto' => '<a href="mailto:%s"%s>%s</a>',

                'form' => '<form action="%s"%s>',

                'formend' => '</form>',

                'input' => '<input name="%s"%s/>',

                'textarea' => '<textarea name="%s"%s>%s</textarea>',

                'hidden' => '<input type="hidden" name="%s"%s/>',

                'checkbox' => '<input type="checkbox" name="%s"%s/>',

                'checkboxmultiple' => '<input type="checkbox" name="%s[]"%s />',

                'radio' => '<input type="radio" name="%s" id="%s"%s />%s',

                'selectstart' => '<select name="%s"%s>',

                'selectmultiplestart' => '<select name="%s[]"%s>',

                'selectempty' => '<option value=""%s>&nbsp;</option>',

                'selectoption' => '<option value="%s"%s>%s</option>',

                'selectend' => '</select>',

                'optiongroup' => '<optgroup label="%s"%s>',

                'optiongroupend' => '</optgroup>',

                'checkboxmultiplestart' => '',

                'checkboxmultipleend' => '',

                'password' => '<input type="password" name="%s"%s/>',

                'file' => '<input type="file" name="%s"%s/>',

                'file_no_model' => '<input type="file" name="%s"%s/>',

                'submit' => '<input%s/>',

                'submitimage' => '<input type="image" src="%s"%s/>',

                'button' => '<button%s>%s</button>',

                'image' => '<img src="%s"%s/>',

                'tableheader' => '<th%s>%s</th>',

                'tableheaderrow' => '<tr%s>%s</tr>',

                'tablecell' => '<td%s>%s</td>',

                'tablerow' => '<tr%s>%s</tr>',

                'block' => '<div%s>%s</div>',

                'blockstart' => '<div%s>',

                'blockend' => '</div>',

                'hiddenblock' => '<div style="display:none;">%s</div>',

                'tag' => '<%s%s>%s</%s>',

                'tagstart' => '<%s%s>',

                'tagend' => '</%s>',

                'tagselfclosing' => '<%s%s/>',

                'para' => '<p%s>%s</p>',

                'parastart' => '<p%s>',

                'label' => '<label for="%s"%s>%s</label>',

                'fieldset' => '<fieldset%s>%s</fieldset>',

                'fieldsetstart' => '<fieldset><legend>%s</legend>',

                'fieldsetend' => '</fieldset>',

                'legend' => '<legend>%s</legend>',

                'css' => '<link rel="%s" type="text/css" href="%s"%s/>',

                'style' => '<style type="text/css"%s>%s</style>',

                'charset' => '<meta http-equiv="Content-Type" content="text/html; charset=%s" />',

                'ul' => '<ul%s>%s</ul>',

                'ol' => '<ol%s>%s</ol>',

                'li' => '<li%s>%s</li>',

                'error' => '<div%s>%s</div>',

                'javascriptblock' => '<script%s>%s</script>',

                'javascriptstart' => '<script>',

                'javascriptlink' => '<script type="text/javascript" src="%s"%s></script>',

                'javascriptend' => '</script>'

        );

/**

 * Breadcrumbs.

 *

 * @var array

 */

        protected $_crumbs = array();

/**

 * Names of script & css files that have been included once

 *

 * @var array

 */

        protected $_includedAssets = array();

/**

 * Options for the currently opened script block buffer if any.

 *

 * @var array

 */

        protected $_scriptBlockOptions = array();

/**

 * Document type definitions

 *

 * @var array

 */

        protected $_docTypes = array(

                'html4-strict' => '<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">',

                'html4-trans' => '<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">',

                'html4-frame' => '<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Frameset//EN" "http://www.w3.org/TR/html4/frameset.dtd">',

                'html5' => '<!DOCTYPE html>',

                'xhtml-strict' => '<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">',

                'xhtml-trans' => '<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">',

                'xhtml-frame' => '<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Frameset//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-frameset.dtd">',

                'xhtml11' => '<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">'

        );

/**

 * Constructor

 *

 * ### Settings

 *

 * - `configFile` A file containing an array of tags you wish to redefine.

 *

 * ### Customizing tag sets

 *

 * Using the `configFile` option you can redefine the tag HtmlHelper will use.

 * The file named should be compatible with HtmlHelper::loadConfig().

 *

 * @param View $View The View this helper is being attached to.

 * @param array $settings Configuration settings for the helper.

 */

        public function __construct(View $View, $settings = array()) {

                parent::__construct($View, $settings);

                if (is_object($this->_View->response)) {

                        $this->response = $this->_View->response;

                } else {

                        $this->response = new CakeResponse();

                }

                if (!empty($settings['configFile'])) {

                        $this->loadConfig($settings['configFile']);

                }

        }

/**

 * Adds a link to the breadcrumbs array.

 *

 * @param string $name Text for link

 * @param string $link URL for link (if empty it won't be a link)

 * @param string|array $options Link attributes e.g. array('id' => 'selected')

 * @return $this

 * @see HtmlHelper::link() for details on $options that can be used.

 * @link http://book.cakephp.org/2.0/en/core-libraries/helpers/html.html#creating-breadcrumb-trails-with-htmlhelper

 */

        public function addCrumb($name, $link = null, $options = null) {

                $this->_crumbs[] = array($name, $link, $options);

                return $this;

        }

/**

 * Returns a doctype string.

 *

 * Possible doctypes:

 *

 *  - html4-strict:  HTML4 Strict.

 *  - html4-trans:  HTML4 Transitional.

 *  - html4-frame:  HTML4 Frameset.

 *  - html5: HTML5. Default value.

 *  - xhtml-strict: XHTML1 Strict.

 *  - xhtml-trans: XHTML1 Transitional.

 *  - xhtml-frame: XHTML1 Frameset.

 *  - xhtml11: XHTML1.1.

 *

 * @param string $type Doctype to use.

 * @return string|null Doctype string

 * @link http://book.cakephp.org/2.0/en/core-libraries/helpers/html.html#HtmlHelper::docType

 */

        public function docType($type = 'html5') {

                if (isset($this->_docTypes[$type])) {

                        return $this->_docTypes[$type];

                }

                return null;

        }

/**

 * Creates a link to an external resource and handles basic meta tags

 *

 * Create a meta tag that is output inline:

 *

 * `$this->Html->meta('icon', 'favicon.ico');

 *

 * Append the meta tag to `$scripts_for_layout`:

 *

 * `$this->Html->meta('description', 'A great page', array('inline' => false));`

 *

 * Append the meta tag to custom view block:

 *

 * `$this->Html->meta('description', 'A great page', array('block' => 'metaTags'));`

 *

 * ### Options

 *

 * - `inline` Whether or not the link element should be output inline. Set to false to

 *   have the meta tag included in `$scripts_for_layout`, and appended to the 'meta' view block.

 * - `block` Choose a custom block to append the meta tag to. Using this option

 *   will override the inline option.

 *

 * @param string $type The title of the external resource

 * @param string|array $url The address of the external resource or string for content attribute

 * @param array $options Other attributes for the generated tag. If the type attribute is html,

 *    rss, atom, or icon, the mime-type is returned.

 * @return string A completed `<link />` element.

 * @link http://book.cakephp.org/2.0/en/core-libraries/helpers/html.html#HtmlHelper::meta

 */

        public function meta($type, $url = null, $options = array()) {

                $options += array('inline' => true, 'block' => null);

                if (!$options['inline'] && empty($options['block'])) {

                        $options['block'] = __FUNCTION__;

                }

                unset($options['inline']);

                if (!is_array($type)) {

                        $types = array(

                                'rss' => array('type' => 'application/rss+xml', 'rel' => 'alternate', 'title' => $type, 'link' => $url),

                                'atom' => array('type' => 'application/atom+xml', 'title' => $type, 'link' => $url),

                                'icon' => array('type' => 'image/x-icon', 'rel' => 'icon', 'link' => $url),

                                'keywords' => array('name' => 'keywords', 'content' => $url),

                                'description' => array('name' => 'description', 'content' => $url),

                        );

                        if ($type === 'icon' && $url === null) {

                                $types['icon']['link'] = 'favicon.ico';

                        }

                        if (isset($types[$type])) {

                                $type = $types[$type];

                        } elseif (!isset($options['type']) && $url !== null) {

                                if (is_array($url) && isset($url['ext'])) {

                                        $type = $types[$url['ext']];

                                } else {

                                        $type = $types['rss'];

                                }

                        } elseif (isset($options['type']) && isset($types[$options['type']])) {

                                $type = $types[$options['type']];

                                unset($options['type']);

                        } else {

                                $type = array();

                        }

                }

                $options += $type;

                $out = null;

                if (isset($options['link'])) {

                        $options['link'] = $this->assetUrl($options['link']);

                        if (isset($options['rel']) && $options['rel'] === 'icon') {

                                $out = sprintf($this->_tags['metalink'], $options['link'], $this->_parseAttributes($options, array('block', 'link')));

                                $options['rel'] = 'shortcut icon';

                        }

                        $out .= sprintf($this->_tags['metalink'], $options['link'], $this->_parseAttributes($options, array('block', 'link')));

                } else {

                        $out = sprintf($this->_tags['meta'], $this->_parseAttributes($options, array('block', 'type')));

                }

                if (empty($options['block'])) {

                        return $out;

                }

                $this->_View->append($options['block'], $out);

        }

/**

 * Returns a charset META-tag.

 *

 * @param string $charset The character set to be used in the meta tag. If empty,

 *  The App.encoding value will be used. Example: "utf-8".

 * @return string A meta tag containing the specified character set.

 * @link http://book.cakephp.org/2.0/en/core-libraries/helpers/html.html#HtmlHelper::charset

 */

        public function charset($charset = null) {

                if (empty($charset)) {

                        $charset = strtolower(Configure::read('App.encoding'));

                }

                return sprintf($this->_tags['charset'], (!empty($charset) ? $charset : 'utf-8'));

        }

/**

 * Creates an HTML link.

 *

 * If $url starts with "http://" this is treated as an external link. Else,

 * it is treated as a path to controller/action and parsed with the

 * HtmlHelper::url() method.

 *

 * If the $url is empty, $title is used instead.

 *

 * ### Options

 *

 * - `escape` Set to false to disable escaping of title and attributes.

 * - `escapeTitle` Set to false to disable escaping of title. (Takes precedence over value of `escape`)

 * - `confirm` JavaScript confirmation message.

 *

 * @param string $title The content to be wrapped by <a> tags.

 * @param string|array $url Cake-relative URL or array of URL parameters, or external URL (starts with http://)

 * @param array $options Array of options and HTML attributes.

 * @param string $confirmMessage JavaScript confirmation message. This

 *   argument is deprecated as of 2.6. Use `confirm` key in $options instead.

 * @return string An `<a />` element.

 * @link http://book.cakephp.org/2.0/en/core-libraries/helpers/html.html#HtmlHelper::link

 */

        public function link($title, $url = null, $options = array(), $confirmMessage = false) {

                $escapeTitle = true;

                if ($url !== null) {

                        $url = $this->url($url);

                } else {

                        $url = $this->url($title);

                        $title = htmlspecialchars_decode($url, ENT_QUOTES);

                        $title = h(urldecode($title));

                        $escapeTitle = false;

                }

                if (isset($options['escapeTitle'])) {

                        $escapeTitle = $options['escapeTitle'];

                        unset($options['escapeTitle']);

                } elseif (isset($options['escape'])) {

                        $escapeTitle = $options['escape'];

                }

                if ($escapeTitle === true) {

                        $title = h($title);

                } elseif (is_string($escapeTitle)) {

                        $title = htmlentities($title, ENT_QUOTES, $escapeTitle);

                }

                if (!empty($options['confirm'])) {

                        $confirmMessage = $options['confirm'];

                        unset($options['confirm']);

                }

                if ($confirmMessage) {

                        $options['onclick'] = $this->_confirm($confirmMessage, 'return true;', 'return false;', $options);

                } elseif (isset($options['default']) && !$options['default']) {

                        if (isset($options['onclick'])) {

                                $options['onclick'] .= ' ';

                        } else {

                                $options['onclick'] = '';

                        }

                        $options['onclick'] .= 'event.returnValue = false; return false;';

                        unset($options['default']);

                }

                return sprintf($this->_tags['link'], $url, $this->_parseAttributes($options), $title);

        }

/**

 * Creates a link element for CSS stylesheets.

 *

 * ### Usage

 *

 * Include one CSS file:

 *

 * `echo $this->Html->css('styles.css');`

 *

 * Include multiple CSS files:

 *

 * `echo $this->Html->css(array('one.css', 'two.css'));`

 *

 * Add the stylesheet to the `$scripts_for_layout` layout var:

 *

 * `$this->Html->css('styles.css', array('inline' => false));`

 *

 * Add the stylesheet to a custom block:

 *

 * `$this->Html->css('styles.css', array('block' => 'layoutCss'));`

 *

 * ### Options

 *

 * - `inline` If set to false, the generated tag will be appended to the 'css' block,

 *   and included in the `$scripts_for_layout` layout variable. Defaults to true.

 * - `once` Whether or not the css file should be checked for uniqueness. If true css

 *   files  will only be included once, use false to allow the same

 *   css to be included more than once per request.

 * - `block` Set the name of the block link/style tag will be appended to.

 *   This overrides the `inline` option.

 * - `plugin` False value will prevent parsing path as a plugin

 * - `rel` Defaults to 'stylesheet'. If equal to 'import' the stylesheet will be imported.

 * - `fullBase` If true the URL will get a full address for the css file.

 *

 * @param string|array $path The name of a CSS style sheet or an array containing names of

 *   CSS stylesheets. If `$path` is prefixed with '/', the path will be relative to the webroot

 *   of your application. Otherwise, the path will be relative to your CSS path, usually webroot/css.

 * @param array $options Array of options and HTML arguments.

 * @return string CSS <link /> or <style /> tag, depending on the type of link.

 * @link http://book.cakephp.org/2.0/en/core-libraries/helpers/html.html#HtmlHelper::css

 */

        public function css($path, $options = array()) {

                if (!is_array($options)) {

                        $rel = $options;

                        $options = array();

                        if ($rel) {

                                $options['rel'] = $rel;

                        }

                        if (func_num_args() > 2) {

                                $options = func_get_arg(2) + $options;

                        }

                        unset($rel);

                }

                $options += array(

                        'block' => null,

                        'inline' => true,

                        'once' => false,

                        'rel' => 'stylesheet'

                );

                if (!$options['inline'] && empty($options['block'])) {

                        $options['block'] = __FUNCTION__;

                }

                unset($options['inline']);

                if (is_array($path)) {

                        $out = '';

                        foreach ($path as $i) {

                                $out .= "\n\t" . $this->css($i, $options);

                        }

                        if (empty($options['block'])) {

                                return $out . "\n";

                        }

                        return '';

                }

                if ($options['once'] && isset($this->_includedAssets[__METHOD__][$path])) {

                        return '';

                }

                unset($options['once']);

                $this->_includedAssets[__METHOD__][$path] = true;

                if (strpos($path, '//') !== false) {

                        $url = $path;

                } else {

                        $url = $this->assetUrl($path, $options + array('pathPrefix' => Configure::read('App.cssBaseUrl'), 'ext' => '.css'));

                        $options = array_diff_key($options, array('fullBase' => null, 'pathPrefix' => null));

                        if (Configure::read('Asset.filter.css')) {

                                $pos = strpos($url, Configure::read('App.cssBaseUrl'));

                                if ($pos !== false) {

                                        $url = substr($url, 0, $pos) . 'ccss/' . substr($url, $pos + strlen(Configure::read('App.cssBaseUrl')));

                                }

                        }

                }

                if ($options['rel'] === 'import') {

                        $out = sprintf(

                                $this->_tags['style'],

                                $this->_parseAttributes($options, array('rel', 'block')),

                                '@import url(' . $url . ');'

                        );

                } else {

                        $out = sprintf(

                                $this->_tags['css'],

                                $options['rel'],

                                $url,

                                $this->_parseAttributes($options, array('rel', 'block'))

                        );

                }

                if (empty($options['block'])) {

                        return $out;

                }

                $this->_View->append($options['block'], $out);

        }

/**

 * Returns one or many `<script>` tags depending on the number of scripts given.

 *

 * If the filename is prefixed with "/", the path will be relative to the base path of your

 * application. Otherwise, the path will be relative to your JavaScript path, usually webroot/js.

 *

 * ### Usage

 *

 * Include one script file:

 *

 * `echo $this->Html->script('styles.js');`

 *

 * Include multiple script files:

 *

 * `echo $this->Html->script(array('one.js', 'two.js'));`

 *

 * Add the script file to the `$scripts_for_layout` layout var:

 *

 * `$this->Html->script('styles.js', array('inline' => false));`

 *

 * Add the script file to a custom block:

 *

 * `$this->Html->script('styles.js', array('block' => 'bodyScript'));`

 *

 * ### Options

 *

 * - `inline` Whether script should be output inline or into `$scripts_for_layout`. When set to false,

 *   the script tag will be appended to the 'script' view block as well as `$scripts_for_layout`.

 * - `block` The name of the block you want the script appended to. Leave undefined to output inline.

 *   Using this option will override the inline option.

 * - `once` Whether or not the script should be checked for uniqueness. If true scripts will only be

 *   included once, use false to allow the same script to be included more than once per request.

 * - `plugin` False value will prevent parsing path as a plugin

 * - `fullBase` If true the url will get a full address for the script file.

 *

 * @param string|array $url String or array of javascript files to include

 * @param array|bool $options Array of options, and html attributes see above. If boolean sets $options['inline'] = value

 * @return mixed String of `<script />` tags or null if $inline is false or if $once is true and the file has been

 *   included before.

 * @link http://book.cakephp.org/2.0/en/core-libraries/helpers/html.html#HtmlHelper::script

 */

        public function script($url, $options = array()) {

                if (is_bool($options)) {

                        list($inline, $options) = array($options, array());

                        $options['inline'] = $inline;

                }

                $options += array('block' => null, 'inline' => true, 'once' => true);

                if (!$options['inline'] && empty($options['block'])) {

                        $options['block'] = __FUNCTION__;

                }

                unset($options['inline']);

                if (is_array($url)) {

                        $out = '';

                        foreach ($url as $i) {

                                $out .= "\n\t" . $this->script($i, $options);

                        }

                        if (empty($options['block'])) {

                                return $out . "\n";

                        }

                        return null;

                }

                if ($options['once'] && isset($this->_includedAssets[__METHOD__][$url])) {

                        return null;

                }

                $this->_includedAssets[__METHOD__][$url] = true;

                if (strpos($url, '//') === false) {

                        $url = $this->assetUrl($url, $options + array('pathPrefix' => Configure::read('App.jsBaseUrl'), 'ext' => '.js'));

                        $options = array_diff_key($options, array('fullBase' => null, 'pathPrefix' => null));

                        if (Configure::read('Asset.filter.js')) {

                                $url = str_replace(Configure::read('App.jsBaseUrl'), 'cjs/', $url);

                        }

                }

                $attributes = $this->_parseAttributes($options, array('block', 'once'));

                $out = sprintf($this->_tags['javascriptlink'], $url, $attributes);

                if (empty($options['block'])) {

                        return $out;

                }

                $this->_View->append($options['block'], $out);

        }

/**

 * Wrap $script in a script tag.

 *

 * ### Options

 *

 * - `safe` (boolean) Whether or not the $script should be wrapped in <![CDATA[ ]]>

 * - `inline` (boolean) Whether or not the $script should be added to

 *   `$scripts_for_layout` / `script` block, or output inline. (Deprecated, use `block` instead)

 * - `block` Which block you want this script block appended to.

 *   Defaults to `script`.

 *

 * @param string $script The script to wrap

 * @param array $options The options to use. Options not listed above will be

 *    treated as HTML attributes.

 * @return mixed string or null depending on the value of `$options['block']`

 * @link http://book.cakephp.org/2.0/en/core-libraries/helpers/html.html#HtmlHelper::scriptBlock

 */

        public function scriptBlock($script, $options = array()) {

                $options += array('type' => 'text/javascript', 'safe' => true, 'inline' => true);

                if ($options['safe']) {

                        $script = "\n" . '//<![CDATA[' . "\n" . $script . "\n" . '//]]>' . "\n";

                }

                if (!$options['inline'] && empty($options['block'])) {

                        $options['block'] = 'script';

                }

                unset($options['inline'], $options['safe']);

                $attributes = $this->_parseAttributes($options, array('block'));

                $out = sprintf($this->_tags['javascriptblock'], $attributes, $script);

                if (empty($options['block'])) {

                        return $out;

                }

                $this->_View->append($options['block'], $out);

        }

/**

 * Begin a script block that captures output until HtmlHelper::scriptEnd()

 * is called. This capturing block will capture all output between the methods

 * and create a scriptBlock from it.

 *

 * ### Options

 *

 * - `safe` Whether the code block should contain a CDATA

 * - `inline` Should the generated script tag be output inline or in `$scripts_for_layout`

 *

 * @param array $options Options for the code block.

 * @return void

 * @link http://book.cakephp.org/2.0/en/core-libraries/helpers/html.html#HtmlHelper::scriptStart

 */

        public function scriptStart($options = array()) {

                $options += array('safe' => true, 'inline' => true);

                $this->_scriptBlockOptions = $options;

                ob_start();

        }

/**

 * End a Buffered section of JavaScript capturing.

 * Generates a script tag inline or in `$scripts_for_layout` depending on the settings

 * used when the scriptBlock was started

 *

 * @return mixed depending on the settings of scriptStart() either a script tag or null

 * @link http://book.cakephp.org/2.0/en/core-libraries/helpers/html.html#HtmlHelper::scriptEnd

 */

        public function scriptEnd() {

                $buffer = ob_get_clean();

                $options = $this->_scriptBlockOptions;

                $this->_scriptBlockOptions = array();

                return $this->scriptBlock($buffer, $options);

        }

/**

 * Builds CSS style data from an array of CSS properties

 *

 * ### Usage:

 *

 * ```

 * echo $this->Html->style(array('margin' => '10px', 'padding' => '10px'), true);

 *

 * // creates

 * 'margin:10px;padding:10px;'

 * ```

 *

 * @param array $data Style data array, keys will be used as property names, values as property values.

 * @param bool $oneline Whether or not the style block should be displayed on one line.

 * @return string CSS styling data

 * @link http://book.cakephp.org/2.0/en/core-libraries/helpers/html.html#HtmlHelper::style

 */

        public function style($data, $oneline = true) {

                if (!is_array($data)) {

                        return $data;

                }

                $out = array();

                foreach ($data as $key => $value) {

                        $out[] = $key . ':' . $value . ';';

                }

                if ($oneline) {

                        return implode(' ', $out);

                }

                return implode("\n", $out);

        }

/**

 * Returns the breadcrumb trail as a sequence of »-separated links.

 *

 * If `$startText` is an array, the accepted keys are:

 *

 * - `text` Define the text/content for the link.

 * - `url` Define the target of the created link.

 *

 * All other keys will be passed to HtmlHelper::link() as the `$options` parameter.

 *

 * @param string $separator Text to separate crumbs.

 * @param string|array|bool $startText This will be the first crumb, if false it defaults to first crumb in array. Can

 *   also be an array, see above for details.

 * @return string|null Composed bread crumbs

 * @link http://book.cakephp.org/2.0/en/core-libraries/helpers/html.html#creating-breadcrumb-trails-with-htmlhelper

 */

        public function getCrumbs($separator = '»', $startText = false) {

                $crumbs = $this->_prepareCrumbs($startText);

                if (!empty($crumbs)) {

                        $out = array();

                        foreach ($crumbs as $crumb) {

                                if (!empty($crumb[1])) {

                                        $out[] = $this->link($crumb[0], $crumb[1], $crumb[2]);

                                } else {

                                        $out[] = $crumb[0];

                                }

                        }

                        return implode($separator, $out);

                }

                return null;

        }

/**

 * Returns breadcrumbs as a (x)html list

 *

 * This method uses HtmlHelper::tag() to generate list and its elements. Works

 * similar to HtmlHelper::getCrumbs(), so it uses options which every

 * crumb was added with.

 *

 * ### Options

 * - `separator` Separator content to insert in between breadcrumbs, defaults to ''

 * - `firstClass` Class for wrapper tag on the first breadcrumb, defaults to 'first'

 * - `lastClass` Class for wrapper tag on current active page, defaults to 'last'

 *

 * @param array $options Array of html attributes to apply to the generated list elements.

 * @param string|array|bool $startText This will be the first crumb, if false it defaults to first crumb in array. Can

 *   also be an array, see `HtmlHelper::getCrumbs` for details.

 * @return string|null breadcrumbs html list

 * @link http://book.cakephp.org/2.0/en/core-libraries/helpers/html.html#creating-breadcrumb-trails-with-htmlhelper

 */

        public function getCrumbList($options = array(), $startText = false) {

                $defaults = array('firstClass' => 'first', 'lastClass' => 'last', 'separator' => '', 'escape' => true);

                $options = (array)$options + $defaults;

                $firstClass = $options['firstClass'];

                $lastClass = $options['lastClass'];

                $separator = $options['separator'];

                $escape = $options['escape'];

                unset($options['firstClass'], $options['lastClass'], $options['separator'], $options['escape']);

                $crumbs = $this->_prepareCrumbs($startText, $escape);

                if (empty($crumbs)) {

                        return null;

                }

                $result = '';

                $crumbCount = count($crumbs);

                $ulOptions = $options;

                foreach ($crumbs as $which => $crumb) {

                        $options = array();

                        if (empty($crumb[1])) {

                                $elementContent = $crumb[0];

                        } else {

                                $elementContent = $this->link($crumb[0], $crumb[1], $crumb[2]);

                        }

                        if (!$which && $firstClass !== false) {

                                $options['class'] = $firstClass;

                        } elseif ($which == $crumbCount - 1 && $lastClass !== false) {

                                $options['class'] = $lastClass;

                        }

                        if (!empty($separator) && ($crumbCount - $which >= 2)) {

                                $elementContent .= $separator;

                        }

                        $result .= $this->tag('li', $elementContent, $options);

                }

                return $this->tag('ul', $result, $ulOptions);

        }

/**

 * Prepends startText to crumbs array if set

 *

 * @param string $startText Text to prepend

 * @param bool $escape If the output should be escaped or not

 * @return array Crumb list including startText (if provided)

 */

        protected function _prepareCrumbs($startText, $escape = true) {

                $crumbs = $this->_crumbs;

                if ($startText) {