PageRenderTime 58ms CodeModel.GetById 22ms RepoModel.GetById 0ms app.codeStats 0ms

/lib/Cake/View/Helper/HtmlHelper.php

https://bitbucket.org/npitts/easyuat2.0
PHP | 1208 lines | 1030 code | 22 blank | 156 comment | 30 complexity | e73e4bd373cd9ac24f604a4ad416a2ad MD5 | raw file
    

  1. <?php
    2. 

  2. /**
    3. 

  3.  * Html Helper class file.
    4. 

  4.  *
    5. 

  5.  * Simplifies the construction of HTML elements.
    6. 

  6.  *
    7. 

  7.  * CakePHP(tm) : Rapid Development Framework (http://cakephp.org)
    8. 

  8.  * Copyright 2005-2012, Cake Software Foundation, Inc. (http://cakefoundation.org)
    9. 

  9.  *
    10. 

  10.  * Licensed under The MIT License
    11. 

  11.  * Redistributions of files must retain the above copyright notice.
    12. 

  12.  *
    13. 

  13.  * @copyright     Copyright 2005-2012, Cake Software Foundation, Inc. (http://cakefoundation.org)
    14. 

  14.  * @link          http://cakephp.org CakePHP(tm) Project
    15. 

  15.  * @package       Cake.View.Helper
    16. 

  16.  * @since         CakePHP(tm) v 0.9.1
    17. 

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

  18.  */
    19. 

  19. 

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

  21. App::uses('CakeResponse', 'Network');
    22. 

  22. 

  23. /**
    24. 

  24.  * Html Helper class for easy use of HTML widgets.
    25. 

  25.  *
    26. 

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

  27.  *
    28. 

  28.  * @package       Cake.View.Helper
    29. 

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

  30.  */
    31. 

  31. class HtmlHelper extends AppHelper {
    32. 

  32. 

  33. /**
    34. 

  34.  * Reference to the Response object
    35. 

  35.  *
    36. 

  36.  * @var CakeResponse
    37. 

  37.  */
    38. 

  38. 	public $response;
    39. 

  39. 

  40. /**
    41. 

  41.  * html tags used by this helper.
    42. 

  42.  *
    43. 

  43.  * @var array
    44. 

  44.  */
    45. 

  45. 	protected $_tags = array(
    46. 

  46. 		'meta' => '<meta%s/>',
    47. 

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

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

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

  50. 		'form' => '<form action="%s"%s>',
    51. 

  51. 		'formend' => '</form>',
    52. 

  52. 		'input' => '<input name="%s"%s/>',
    53. 

  53. 		'textarea' => '<textarea name="%s"%s>%s</textarea>',
    54. 

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

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

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

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

  58. 		'selectstart' => '<select name="%s"%s>',
    59. 

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

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

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

  62. 		'selectend' => '</select>',
    63. 

  63. 		'optiongroup' => '<optgroup label="%s"%s>',
    64. 

  64. 		'optiongroupend' => '</optgroup>',
    65. 

  65. 		'checkboxmultiplestart' => '',
    66. 

  66. 		'checkboxmultipleend' => '',
    67. 

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

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

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

  70. 		'submit' => '<input %s/>',
    71. 

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

  72. 		'button' => '<button%s>%s</button>',
    73. 

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

  74. 		'tableheader' => '<th%s>%s</th>',
    75. 

  75. 		'tableheaderrow' => '<tr%s>%s</tr>',
    76. 

  76. 		'tablecell' => '<td%s>%s</td>',
    77. 

  77. 		'tablerow' => '<tr%s>%s</tr>',
    78. 

  78. 		'block' => '<div%s>%s</div>',
    79. 

  79. 		'blockstart' => '<div%s>',
    80. 

  80. 		'blockend' => '</div>',
    81. 

  81. 		'tag' => '<%s%s>%s</%s>',
    82. 

  82. 		'tagstart' => '<%s%s>',
    83. 

  83. 		'tagend' => '</%s>',
    84. 

  84. 		'tagselfclosing' => '<%s%s/>',
    85. 

  85. 		'para' => '<p%s>%s</p>',
    86. 

  86. 		'parastart' => '<p%s>',
    87. 

  87. 		'label' => '<label for="%s"%s>%s</label>',
    88. 

  88. 		'fieldset' => '<fieldset%s>%s</fieldset>',
    89. 

  89. 		'fieldsetstart' => '<fieldset><legend>%s</legend>',
    90. 

  90. 		'fieldsetend' => '</fieldset>',
    91. 

  91. 		'legend' => '<legend>%s</legend>',
    92. 

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

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

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

  95. 		'ul' => '<ul%s>%s</ul>',
    96. 

  96. 		'ol' => '<ol%s>%s</ol>',
    97. 

  97. 		'li' => '<li%s>%s</li>',
    98. 

  98. 		'error' => '<div%s>%s</div>',
    99. 

  99. 		'javascriptblock' => '<script type="text/javascript"%s>%s</script>',
    100. 

  100. 		'javascriptstart' => '<script type="text/javascript">',
    101. 

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

  102. 		'javascriptend' => '</script>'
    103. 

  103. 	);
    104. 

  104. 

  105. /**
    106. 

  106.  * Breadcrumbs.
    107. 

  107.  *
    108. 

  108.  * @var array
    109. 

  109.  */
    110. 

  110. 	protected $_crumbs = array();
    111. 

  111. 

  112. /**
    113. 

  113.  * Names of script files that have been included once
    114. 

  114.  *
    115. 

  115.  * @var array
    116. 

  116.  */
    117. 

  117. 	protected $_includedScripts = array();
    118. 

  118. 

  119. /**
    120. 

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

  121.  *
    122. 

  122.  * @var array
    123. 

  123.  */
    124. 

  124. 	protected $_scriptBlockOptions = array();
    125. 

  125. 

  126. /**
    127. 

  127.  * Document type definitions
    128. 

  128.  *
    129. 

  129.  * @var array
    130. 

  130.  */
    131. 

  131. 	protected $_docTypes = array(
    132. 

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

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

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

  135. 		'html5' => '<!DOCTYPE html>',
    136. 

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

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

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

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

  140. 	);
    141. 

  141. 

  142. /**
    143. 

  143.  * Constructor
    144. 

  144.  *
    145. 

  145.  * ### Settings
    146. 

  146.  *
    147. 

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

  148.  *
    149. 

  149.  * ### Customizing tag sets
    150. 

  150.  *
    151. 

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

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

  153.  *
    154. 

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

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

  156.  */
    157. 

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

  158. 		parent::__construct($View, $settings);
    159. 

  159. 		if (is_object($this->_View->response)) {
    160. 

  160. 			$this->response = $this->_View->response;
    161. 

  161. 		} else {
    162. 

  162. 			$this->response = new CakeResponse(array('charset' => Configure::read('App.encoding')));
    163. 

  163. 		}
    164. 

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

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

  166. 		}
    167. 

  167. 	}
    168. 

  168. 

  169. /**
    170. 

  170.  * Adds a link to the breadcrumbs array.
    171. 

  171.  *
    172. 

  172.  * @param string $name Text for link
    173. 

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

  174.  * @param mixed $options Link attributes e.g. array('id' => 'selected')
    175. 

  175.  * @return void
    176. 

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

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

  178.  */
    179. 

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

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

  181. 	}
    182. 

  182. 

  183. /**
    184. 

  184.  * Returns a doctype string.
    185. 

  185.  *
    186. 

  186.  * Possible doctypes:
    187. 

  187.  *
    188. 

  188.  *  - html4-strict:  HTML4 Strict.
    189. 

  189.  *  - html4-trans:  HTML4 Transitional.
    190. 

  190.  *  - html4-frame:  HTML4 Frameset.
    191. 

  191.  *  - html5: HTML5. Default value.
    192. 

  192.  *  - xhtml-strict: XHTML1 Strict.
    193. 

  193.  *  - xhtml-trans: XHTML1 Transitional.
    194. 

  194.  *  - xhtml-frame: XHTML1 Frameset.
    195. 

  195.  *  - xhtml11: XHTML1.1.
    196. 

  196.  *
    197. 

  197.  * @param string $type Doctype to use.
    198. 

  198.  * @return string Doctype string
    199. 

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

  200.  */
    201. 

  201. 	public function docType($type = 'html5') {
    202. 

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

  203. 			return $this->_docTypes[$type];
    204. 

  204. 		}
    205. 

  205. 		return null;
    206. 

  206. 	}
    207. 

  207. 

  208. /**
    209. 

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

  210.  *
    211. 

  211.  * Create a meta tag that is output inline:
    212. 

  212.  *
    213. 

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

  214.  *
    215. 

  215.  * Append the meta tag to `$scripts_for_layout`:
    216. 

  216.  *
    217. 

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

  218.  *
    219. 

  219.  * Append the meta tag to custom view block:
    220. 

  220.  *
    221. 

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

  222.  *
    223. 

  223.  * ### Options
    224. 

  224.  *
    225. 

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

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

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

  228.  *   will override the inline option.
    229. 

  229.  *
    230. 

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

  231.  * @param mixed $url The address of the external resource or string for content attribute
    232. 

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

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

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

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

  236.  */
    237. 

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

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

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

  240. 			$options['block'] = __FUNCTION__;
    241. 

  241. 		}
    242. 

  242. 		unset($options['inline']);
    243. 

  243. 

  244. 		if (!is_array($type)) {
    245. 

  245. 			$types = array(
    246. 

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

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

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

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

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

  251. 			);
    252. 

  252. 

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

  254. 				$types['icon']['link'] = $this->webroot('favicon.ico');
    255. 

  255. 			}
    256. 

  256. 

  257. 			if (isset($types[$type])) {
    258. 

  258. 				$type = $types[$type];
    259. 

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

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

  261. 					$type = $types[$url['ext']];
    262. 

  262. 				} else {
    263. 

  263. 					$type = $types['rss'];
    264. 

  264. 				}
    265. 

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

  266. 				$type = $types[$options['type']];
    267. 

  267. 				unset($options['type']);
    268. 

  268. 			} else {
    269. 

  269. 				$type = array();
    270. 

  270. 			}
    271. 

  271. 		} elseif ($url !== null) {
    272. 

  272. 			$inline = $url;
    273. 

  273. 		}
    274. 

  274. 		$options = array_merge($type, $options);
    275. 

  275. 		$out = null;
    276. 

  276. 

  277. 		if (isset($options['link'])) {
    278. 

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

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

  280. 				$options['rel'] = 'shortcut icon';
    281. 

  281. 			} else {
    282. 

  282. 				$options['link'] = $this->url($options['link'], true);
    283. 

  283. 			}
    284. 

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

  285. 		} else {
    286. 

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

  287. 		}
    288. 

  288. 

  289. 		if (empty($options['block'])) {
    290. 

  290. 			return $out;
    291. 

  291. 		} else {
    292. 

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

  293. 		}
    294. 

  294. 	}
    295. 

  295. 

  296. /**
    297. 

  297.  * Returns a charset META-tag.
    298. 

  298.  *
    299. 

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

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

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

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

  303.  */
    304. 

  304. 	public function charset($charset = null) {
    305. 

  305. 		if (empty($charset)) {
    306. 

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

  307. 		}
    308. 

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

  309. 	}
    310. 

  310. 

  311. /**
    312. 

  312.  * Creates an HTML link.
    313. 

  313.  *
    314. 

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

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

  316.  * HtmlHelper::url() method.
    317. 

  317.  *
    318. 

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

  319.  *
    320. 

  320.  * ### Options
    321. 

  321.  *
    322. 

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

  323.  * - `confirm` JavaScript confirmation message.
    324. 

  324.  *
    325. 

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

  326.  * @param mixed $url Cake-relative URL or array of URL parameters, or external URL (starts with http://)
    327. 

  327.  * @param array $options Array of HTML attributes.
    328. 

  328.  * @param string $confirmMessage JavaScript confirmation message.
    329. 

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

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

  331.  */
    332. 

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

  333. 		$escapeTitle = true;
    334. 

  334. 		if ($url !== null) {
    335. 

  335. 			$url = $this->url($url);
    336. 

  336. 		} else {
    337. 

  337. 			$url = $this->url($title);
    338. 

  338. 			$title = h(urldecode($url));
    339. 

  339. 			$escapeTitle = false;
    340. 

  340. 		}
    341. 

  341. 

  342. 		if (isset($options['escape'])) {
    343. 

  343. 			$escapeTitle = $options['escape'];
    344. 

  344. 		}
    345. 

  345. 

  346. 		if ($escapeTitle === true) {
    347. 

  347. 			$title = h($title);
    348. 

  348. 		} elseif (is_string($escapeTitle)) {
    349. 

  349. 			$title = htmlentities($title, ENT_QUOTES, $escapeTitle);
    350. 

  350. 		}
    351. 

  351. 

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

  353. 			$confirmMessage = $options['confirm'];
    354. 

  354. 			unset($options['confirm']);
    355. 

  355. 		}
    356. 

  356. 		if ($confirmMessage) {
    357. 

  357. 			$confirmMessage = str_replace("'", "\'", $confirmMessage);
    358. 

  358. 			$confirmMessage = str_replace('"', '\"', $confirmMessage);
    359. 

  359. 			$options['onclick'] = "return confirm('{$confirmMessage}');";
    360. 

  360. 		} elseif (isset($options['default']) && $options['default'] == false) {
    361. 

  361. 			if (isset($options['onclick'])) {
    362. 

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

  363. 			} else {
    364. 

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

  365. 			}
    366. 

  366. 			unset($options['default']);
    367. 

  367. 		}
    368. 

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

  369. 	}
    370. 

  370. 

  371. /**
    372. 

  372.  * Creates a link element for CSS stylesheets.
    373. 

  373.  *
    374. 

  374.  * ### Usage
    375. 

  375.  *
    376. 

  376.  * Include one CSS file:
    377. 

  377.  *
    378. 

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

  379.  *
    380. 

  380.  * Include multiple CSS files:
    381. 

  381.  *
    382. 

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

  383.  *
    384. 

  384.  * Add the stylesheet to the `$scripts_for_layout` layout var:
    385. 

  385.  *
    386. 

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

  387.  *
    388. 

  388.  * Add the stylesheet to a custom block:
    389. 

  389.  *
    390. 

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

  391.  *
    392. 

  392.  * ### Options
    393. 

  393.  *
    394. 

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

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

  396.  * - `block` Set the name of the block link/style tag will be appended to.  This overrides the `inline`
    397. 

  397.  *   option.
    398. 

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

  399.  *
    400. 

  400.  * @param mixed $path The name of a CSS style sheet or an array containing names of
    401. 

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

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

  403.  * @param string $rel Rel attribute. Defaults to "stylesheet". If equal to 'import' the stylesheet will be imported.
    404. 

  404.  * @param array $options Array of HTML attributes.
    405. 

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

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

  407.  */
    408. 

  408. 	public function css($path, $rel = null, $options = array()) {
    409. 

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

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

  411. 			$options['block'] = __FUNCTION__;
    412. 

  412. 		}
    413. 

  413. 		unset($options['inline']);
    414. 

  414. 

  415. 		if (is_array($path)) {
    416. 

  416. 			$out = '';
    417. 

  417. 			foreach ($path as $i) {
    418. 

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

  419. 			}
    420. 

  420. 			if (empty($options['block'])) {
    421. 

  421. 				return $out . "\n";
    422. 

  422. 			}
    423. 

  423. 			return;
    424. 

  424. 		}
    425. 

  425. 

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

  427. 			$url = $path;
    428. 

  428. 		} else {
    429. 

  429. 			$url = $this->assetUrl($path, $options + array('pathPrefix' => CSS_URL, 'ext' => '.css'));
    430. 

  430. 

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

  432. 				$pos = strpos($url, CSS_URL);
    433. 

  433. 				if ($pos !== false) {
    434. 

  434. 					$url = substr($url, 0, $pos) . 'ccss/' . substr($url, $pos + strlen(CSS_URL));
    435. 

  435. 				}
    436. 

  436. 			}
    437. 

  437. 		}
    438. 

  438. 

  439. 		if ($rel == 'import') {
    440. 

  440. 			$out = sprintf($this->_tags['style'], $this->_parseAttributes($options, array('inline', 'block'), '', ' '), '@import url(' . $url . ');');
    441. 

  441. 		} else {
    442. 

  442. 			if ($rel == null) {
    443. 

  443. 				$rel = 'stylesheet';
    444. 

  444. 			}
    445. 

  445. 			$out = sprintf($this->_tags['css'], $rel, $url, $this->_parseAttributes($options, array('inline', 'block'), '', ' '));
    446. 

  446. 		}
    447. 

  447. 

  448. 		if (empty($options['block'])) {
    449. 

  449. 			return $out;
    450. 

  450. 		} else {
    451. 

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

  452. 		}
    453. 

  453. 	}
    454. 

  454. 

  455. /**
    456. 

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

  457.  *
    458. 

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

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

  460.  *
    461. 

  461.  *
    462. 

  462.  * ### Usage
    463. 

  463.  *
    464. 

  464.  * Include one script file:
    465. 

  465.  *
    466. 

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

  467.  *
    468. 

  468.  * Include multiple script files:
    469. 

  469.  *
    470. 

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

  471.  *
    472. 

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

  473.  *
    474. 

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

  475.  *
    476. 

  476.  * Add the script file to a custom block:
    477. 

  477.  *
    478. 

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

  479.  *
    480. 

  480.  * ### Options
    481. 

  481.  *
    482. 

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

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

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

  485.  *   Using this option will override the inline option.
    486. 

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

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

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

  489.  *
    490. 

  490.  * @param mixed $url String or array of javascript files to include
    491. 

  491.  * @param mixed $options Array of options, and html attributes see above. If boolean sets $options['inline'] = value
    492. 

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

  493.  *   included before.
    494. 

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

  495.  */
    496. 

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

  497. 		if (is_bool($options)) {
    498. 

  498. 			list($inline, $options) = array($options, array());
    499. 

  499. 			$options['inline'] = $inline;
    500. 

  500. 		}
    501. 

  501. 		$options = array_merge(array('block' => null, 'inline' => true, 'once' => true), $options);
    502. 

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

  503. 			$options['block'] = __FUNCTION__;
    504. 

  504. 		}
    505. 

  505. 		unset($options['inline']);
    506. 

  506. 

  507. 		if (is_array($url)) {
    508. 

  508. 			$out = '';
    509. 

  509. 			foreach ($url as $i) {
    510. 

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

  511. 			}
    512. 

  512. 			if (empty($options['block'])) {
    513. 

  513. 				return $out . "\n";
    514. 

  514. 			}
    515. 

  515. 			return null;
    516. 

  516. 		}
    517. 

  517. 		if ($options['once'] && isset($this->_includedScripts[$url])) {
    518. 

  518. 			return null;
    519. 

  519. 		}
    520. 

  520. 		$this->_includedScripts[$url] = true;
    521. 

  521. 

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

  523. 			$url = $this->assetUrl($url, $options + array('pathPrefix' => JS_URL, 'ext' => '.js'));
    524. 

  524. 

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

  526. 				$url = str_replace(JS_URL, 'cjs/', $url);
    527. 

  527. 			}
    528. 

  528. 		}
    529. 

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

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

  531. 

  532. 		if (empty($options['block'])) {
    533. 

  533. 			return $out;
    534. 

  534. 		} else {
    535. 

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

  536. 		}
    537. 

  537. 	}
    538. 

  538. 

  539. /**
    540. 

  540.  * Wrap $script in a script tag.
    541. 

  541.  *
    542. 

  542.  * ### Options
    543. 

  543.  *
    544. 

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

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

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

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

  548.  *   Defaults to `script`.
    549. 

  549.  *
    550. 

  550.  * @param string $script The script to wrap
    551. 

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

  552.  *    treated as HTML attributes.
    553. 

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

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

  555.  */
    556. 

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

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

  558. 		if ($options['safe']) {
    559. 

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

  560. 		}
    561. 

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

  562. 			$options['block'] = 'script';
    563. 

  563. 		}
    564. 

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

  565. 

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

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

  568. 

  569. 		if (empty($options['block'])) {
    570. 

  570. 			return $out;
    571. 

  571. 		} else {
    572. 

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

  573. 		}
    574. 

  574. 	}
    575. 

  575. 

  576. /**
    577. 

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

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

  579.  * and create a scriptBlock from it.
    580. 

  580.  *
    581. 

  581.  * ### Options
    582. 

  582.  *
    583. 

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

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

  585.  *
    586. 

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

  587.  * @return void
    588. 

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

  589.  */
    590. 

  590. 	public function scriptStart($options = array()) {
    591. 

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

  592. 		$this->_scriptBlockOptions = $options;
    593. 

  593. 		ob_start();
    594. 

  594. 		return null;
    595. 

  595. 	}
    596. 

  596. 

  597. /**
    598. 

  598.  * End a Buffered section of Javascript capturing.
    599. 

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

  600.  * used when the scriptBlock was started
    601. 

  601.  *
    602. 

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

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

  604.  */
    605. 

  605. 	public function scriptEnd() {
    606. 

  606. 		$buffer = ob_get_clean();
    607. 

  607. 		$options = $this->_scriptBlockOptions;
    608. 

  608. 		$this->_scriptBlockOptions = array();
    609. 

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

  610. 	}
    611. 

  611. 

  612. /**
    613. 

  613.  * Builds CSS style data from an array of CSS properties
    614. 

  614.  *
    615. 

  615.  * ### Usage:
    616. 

  616.  *
    617. 

  617.  * {{{
    618. 

  618.  * echo $html->style(array('margin' => '10px', 'padding' => '10px'), true);
    619. 

  619.  *
    620. 

  620.  * // creates
    621. 

  621.  * 'margin:10px;padding:10px;'
    622. 

  622.  * }}}
    623. 

  623.  *
    624. 

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

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

  626.  * @return string CSS styling data
    627. 

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

  628.  */
    629. 

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

  630. 		if (!is_array($data)) {
    631. 

  631. 			return $data;
    632. 

  632. 		}
    633. 

  633. 		$out = array();
    634. 

  634. 		foreach ($data as $key => $value) {
    635. 

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

  636. 		}
    637. 

  637. 		if ($oneline) {
    638. 

  638. 			return join(' ', $out);
    639. 

  639. 		}
    640. 

  640. 		return implode("\n", $out);
    641. 

  641. 	}
    642. 

  642. 

  643. /**
    644. 

  644.  * Returns the breadcrumb trail as a sequence of &raquo;-separated links.
    645. 

  645.  *
    646. 

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

  647.  *
    648. 

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

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

  650.  *
    651. 

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

  652.  *
    653. 

  653.  * @param string $separator Text to separate crumbs.
    654. 

  654.  * @param mixed $startText This will be the first crumb, if false it defaults to first crumb in array. Can
    655. 

  655.  *   also be an array, see above for details.
    656. 

  656.  * @return string Composed bread crumbs
    657. 

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

  658.  */
    659. 

  659. 	public function getCrumbs($separator = '&raquo;', $startText = false) {
    660. 

  660. 		$crumbs = $this->_prepareCrumbs($startText);
    661. 

  661. 		if (!empty($crumbs)) {
    662. 

  662. 			$out = array();
    663. 

  663. 			foreach ($crumbs as $crumb) {
    664. 

  664. 				if (!empty($crumb[1])) {
    665. 

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

  666. 				} else {
    667. 

  667. 					$out[] = $crumb[0];
    668. 

  668. 				}
    669. 

  669. 			}
    670. 

  670. 			return join($separator, $out);
    671. 

  671. 		} else {
    672. 

  672. 			return null;
    673. 

  673. 		}
    674. 

  674. 	}
    675. 

  675. 

  676. /**
    677. 

  677.  * Returns breadcrumbs as a (x)html list
    678. 

  678.  *
    679. 

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

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

  681.  * crumb was added with.
    682. 

  682.  *
    683. 

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

  684.  * @param mixed $startText This will be the first crumb, if false it defaults to first crumb in array. Can
    685. 

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

  686.  * @return string breadcrumbs html list
    687. 

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

  688.  */
    689. 

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

  690. 		$crumbs = $this->_prepareCrumbs($startText);
    691. 

  691. 		if (!empty($crumbs)) {
    692. 

  692. 			$result = '';
    693. 

  693. 			$crumbCount = count($crumbs);
    694. 

  694. 			$ulOptions = $options;
    695. 

  695. 			foreach ($crumbs as $which => $crumb) {
    696. 

  696. 				$options = array();
    697. 

  697. 				if (empty($crumb[1])) {
    698. 

  698. 					$elementContent = $crumb[0];
    699. 

  699. 				} else {
    700. 

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

  701. 				}
    702. 

  702. 				if ($which == 0) {
    703. 

  703. 					$options['class'] = 'first';
    704. 

  704. 				} elseif ($which == $crumbCount - 1) {
    705. 

  705. 					$options['class'] = 'last';
    706. 

  706. 				}
    707. 

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

  708. 			}
    709. 

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

  710. 		} else {
    711. 

  711. 			return null;
    712. 

  712. 		}
    713. 

  713. 	}
    714. 

  714. 

  715. /**
    716. 

  716.  * Prepends startText to crumbs array if set
    717. 

  717.  *
    718. 

  718.  * @param $startText
    719. 

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

  720.  */
    721. 

  721. 	protected function _prepareCrumbs($startText) {
    722. 

  722. 		$crumbs = $this->_crumbs;
    723. 

  723. 		if ($startText) {
    724. 

  724. 			if (!is_array($startText)) {
    725. 

  725. 				$startText = array(
    726. 

  726. 					'url' => '/',
    727. 

  727. 					'text' => $startText
    728. 

  728. 				);
    729. 

  729. 			}
    730. 

  730. 			$startText += array('url' => '/', 'text' => __('Home'));
    731. 

  731. 			list($url, $text) = array($startText['url'], $startText['text']);
    732. 

  732. 			unset($startText['url'], $startText['text']);
    733. 

  733. 			array_unshift($crumbs, array($text, $url, $startText));
    734. 

  734. 		}
    735. 

  735. 		return $crumbs;
    736. 

  736. 	}
    737. 

  737. 

  738. /**
    739. 

  739.  * Creates a formatted IMG element.
    740. 

  740.  *
    741. 

  741.  * This method will set an empty alt attribute if one is not supplied.
    742. 

  742.  *
    743. 

  743.  * ### Usage:
    744. 

  744.  *
    745. 

  745.  * Create a regular image:
    746. 

  746.  *
    747. 

  747.  * `echo $html->image('cake_icon.png', array('alt' => 'CakePHP'));`
    748. 

  748.  *
    749. 

  749.  * Create an image link:
    750. 

  750.  *
    751. 

  751.  * `echo $html->image('cake_icon.png', array('alt' => 'CakePHP', 'url' => 'http://cakephp.org'));`
    752. 

  752.  *
    753. 

  753.  * ### Options:
    754. 

  754.  *
    755. 

  755.  * - `url` If provided an image link will be generated and the link will point at
    756. 

  756.  *   `$options['url']`.
    757. 

  757.  * - `fullBase` If true the src attribute will get a full address for the image file.
    758. 

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

  759.  *
    760. 

  760.  * @param string $path Path to the image file, relative to the app/webroot/img/ directory.
    761. 

  761.  * @param array $options Array of HTML attributes.  See above for special options.
    762. 

  762.  * @return string completed img tag
    763. 

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

  764.  */
    765. 

  765. 	public function image($path, $options = array()) {
    766. 

  766. 		$path = $this->assetUrl($path, $options + array('pathPrefix' => IMAGES_URL));
    767. 

  767. 		$options = array_diff_key($options, array('fullBase' => '', 'pathPrefix' => ''));
    768. 

  768. 

  769. 		if (!isset($options['alt'])) {
    770. 

  770. 			$options['alt'] = '';
    771. 

  771. 		}
    772. 

  772. 

  773. 		$url = false;
    774. 

  774. 		if (!empty($options['url'])) {
    775. 

  775. 			$url = $options['url'];
    776. 

  776. 			unset($options['url']);
    777. 

  777. 		}
    778. 

  778. 

  779. 		$image = sprintf($this->_tags['image'], $path, $this->_parseAttributes($options, null, '', ' '));
    780. 

  780. 

  781. 		if ($url) {
    782. 

  782. 			return sprintf($this->_tags['link'], $this->url($url), null, $image);
    783. 

  783. 		}
    784. 

  784. 		return $image;
    785. 

  785. 	}
    786. 

  786. 

  787. /**
    788. 

  788.  * Returns a row of formatted and named TABLE headers.
    789. 

  789.  *
    790. 

  790.  * @param array $names Array of tablenames.
    791. 

  791.  * @param array $trOptions HTML options for TR elements.
    792. 

  792.  * @param array $thOptions HTML options for TH elements.
    793. 

  793.  * @return string Completed table headers
    794. 

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

  795.  */
    796. 

  796. 	public function tableHeaders($names, $trOptions = null, $thOptions = null) {
    797. 

  797. 		$out = array();
    798. 

  798. 		foreach ($names as $arg) {
    799. 

  799. 			$out[] = sprintf($this->_tags['tableheader'], $this->_parseAttributes($thOptions), $arg);
    800. 

  800. 		}
    801. 

  801. 		return sprintf($this->_tags['tablerow'], $this->_parseAttributes($trOptions), join(' ', $out));
    802. 

  802. 	}
    803. 

  803. 

  804. /**
    805. 

  805.  * Returns a formatted string of table rows (TR's with TD's in them).
    806. 

  806.  *
    807. 

  807.  * @param array $data Array of table data
    808. 

  808.  * @param array $oddTrOptions HTML options for odd TR elements if true useCount is used
    809. 

  809.  * @param array $evenTrOptions HTML options for even TR elements
    810. 

  810.  * @param boolean $useCount adds class "column-$i"
    811. 

  811.  * @param boolean $continueOddEven If false, will use a non-static $count variable,
    812. 

  812.  *    so that the odd/even count is reset to zero just for that call.
    813. 

  813.  * @return string Formatted HTML
    814. 

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

  815.  */
    816. 

  816. 	public function tableCells($data, $oddTrOptions = null, $evenTrOptions = null, $useCount = false, $continueOddEven = true) {
    817. 

  817. 		if (empty($data[0]) || !is_array($data[0])) {
    818. 

  818. 			$data = array($data);
    819. 

  819. 		}
    820. 

  820. 

  821. 		if ($oddTrOptions === true) {
    822. 

  822. 			$useCount = true;
    823. 

  823. 			$oddTrOptions = null;
    824. 

  824. 		}
    825. 

  825. 

  826. 		if ($evenTrOptions === false) {
    827. 

  827. 			$continueOddEven = false;
    828. 

  828. 			$evenTrOptions = null;
    829. 

  829. 		}
    830. 

  830. 

  831. 		if ($continueOddEven) {
    832. 

  832. 			static $count = 0;
    833. 

  833. 		} else {
    834. 

  834. 			$count = 0;
    835. 

  835. 		}
    836. 

  836. 

  837. 		foreach ($data as $line) {
    838. 

  838. 			$count++;
    839. 

  839. 			$cellsOut = array();
    840. 

  840. 			$i = 0;
    841. 

  841. 			foreach ($line as $cell) {
    842. 

  842. 				$cellOptions = array();
    843. 

  843. 

  844. 				if (is_array($cell)) {
    845. 

  845. 					$cellOptions = $cell[1];
    846. 

  846. 					$cell = $cell[0];
    847. 

  847. 				} elseif ($useCount) {
    848. 

  848. 					$cellOptions['class'] = 'column-' . ++$i;
    849. 

  849. 				}
    850. 

  850. 				$cellsOut[] = sprintf($this->_tags['tablecell'], $this->_parseAttributes($cellOptions), $cell);
    851. 

  851. 			}
    852. 

  852. 			$options = $this->_parseAttributes($count % 2 ? $oddTrOptions : $evenTrOptions);
    853. 

  853. 			$out[] = sprintf($this->_tags['tablerow'], $options, implode(' ', $cellsOut));
    854. 

  854. 		}
    855. 

  855. 		return implode("\n", $out);
    856. 

  856. 	}
    857. 

  857. 

  858. /**
    859. 

  859.  * Returns a formatted block tag, i.e DIV, SPAN, P.
    860. 

  860.  *
    861. 

  861.  * ### Options
    862. 

  862.  *
    863. 

  863.  * - `escape` Whether or not the contents should be html_entity escaped.
    864. 

  864.  *
    865. 

  865.  * @param string $name Tag name.
    866. 

  866.  * @param string $text String content that will appear inside the div element.
    867. 

  867.  *   If null, only a start tag will be printed
    868. 

  868.  * @param array $options Additional HTML attributes of the DIV tag, see above.
    869. 

  869.  * @return string The formatted tag element
    870. 

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

  871.  */
    872. 

  872. 	public function tag($name, $text = null, $options = array()) {
    873. 

  873. 		if (is_array($options) && isset($options['escape']) && $options['escape']) {
    874. 

  874. 			$text = h($text);
    875. 

  875. 			unset($options['escape']);
    876. 

  876. 		}
    877. 

  877. 		if (!is_array($options)) {
    878. 

  878. 			$options = array('class' => $options);
    879. 

  879. 		}
    880. 

  880. 		if ($text === null) {
    881. 

  881. 			$tag = 'tagstart';
    882. 

  882. 		} else {
    883. 

  883. 			$tag = 'tag';
    884. 

  884. 		}
    885. 

  885. 		return sprintf($this->_tags[$tag], $name, $this->_parseAttributes($options, null, ' ', ''), $text, $name);
    886. 

  886. 	}
    887. 

  887. 

  888. /**
    889. 

  889.  * Returns a formatted existent block of $tags
    890. 

  890.  *
    891. 

  891.  * @param string $tag Tag name
    892. 

  892.  * @return string Formatted block
    893. 

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

  894.  */
    895. 

  895. 	public function useTag($tag) {
    896. 

  896. 		if (!isset($this->_tags[$tag])) {
    897. 

  897. 			return '';
    898. 

  898. 		}
    899. 

  899. 		$args = func_get_args();
    900. 

  900. 		array_shift($args);
    901. 

  901. 		foreach ($args as &$arg) {
    902. 

  902. 			if (is_array($arg)) {
    903. 

  903. 				$arg = $this->_parseAttributes($arg, null, ' ', '');
    904. 

  904. 			}
    905. 

  905. 		}
    906. 

  906. 		return vsprintf($this->_tags[$tag], $args);
    907. 

  907. 	}
    908. 

  908. 

  909. /**
    910. 

  910.  * Returns a formatted DIV tag for HTML FORMs.
    911. 

  911.  *
    912. 

  912.  * ### Options
    913. 

  913.  *
    914. 

  914.  * - `escape` Whether or not the contents should be html_entity escaped.
    915. 

  915.  *
    916. 

  916.  * @param string $class CSS class name of the div element.
    917. 

  917.  * @param string $text String content that will appear inside the div element.
    918. 

  918.  *   If null, only a start tag will be printed
    919. 

  919.  * @param array $options Additional HTML attributes of the DIV tag
    920. 

  920.  * @return string The formatted DIV element
    921. 

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

  922.  */
    923. 

  923. 	public function div($class = null, $text = null, $options = array()) {
    924. 

  924. 		if (!empty($class)) {
    925. 

  925. 			$options['class'] = $class;
    926. 

  926. 		}
    927. 

  927. 		return $this->tag('div', $text, $options);
    928. 

  928. 	}
    929. 

  929. 

  930. /**
    931. 

  931.  * Returns a formatted P tag.
    932. 

  932.  *
    933. 

  933.  * ### Options
    934. 

  934.  *
    935. 

  935.  * - `escape` Whether or not the contents should be html_entity escaped.
    936. 

  936.  *
    937. 

  937.  * @param string $class CSS class name of the p element.
    938. 

  938.  * @param string $text String content that will appear inside the p element.
    939. 

  939.  * @param array $options Additional HTML attributes of the P tag
    940. 

  940.  * @return string The formatted P element
    941. 

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

  942.  */
    943. 

  943. 	public function para($class, $text, $options = array()) {
    944. 

  944. 		if (isset($options['escape'])) {
    945. 

  945. 			$text = h($text);
    946. 

  946. 		}
    947. 

  947. 		if ($class != null && !empty($class)) {
    948. 

  948. 			$options['class'] = $class;
    949. 

  949. 		}
    950. 

  950. 		if ($text === null) {
    951. 

  951. 			$tag = 'parastart';
    952. 

  952. 		} else {
    953. 

  953. 			$tag = 'para';
    954. 

  954. 		}
    955. 

  955. 		return sprintf($this->_tags[$tag], $this->_parseAttributes($options, null, ' ', ''), $text);
    956. 

  956. 	}
    957. 

  957. 

  958. /**
    959. 

  959.  * Returns an audio/video element
    960. 

  960.  *
    961. 

  961.  * ### Usage
    962. 

  962.  *
    963. 

  963.  * Using an audio file:
    964. 

  964.  *
    965. 

  965.  * `echo $this->Html->media('audio.mp3', array('fullBase' => true));`
    966. 

  966.  *
    967. 

  967.  * Outputs:
    968. 

  968.  *
    969. 

  969.  * `<video src="http://www.somehost.com/files/audio.mp3">Fallback text</video>`
    970. 

  970.  *
    971. 

  971.  * Using a video file:
    972. 

  972.  *
    973. 

  973.  * `echo $this->Html->media('video.mp4', array('text' => 'Fallback text'));`
    974. 

  974.  *
    975. 

  975.  * Outputs:
    976. 

  976.  *
    977. 

  977.  * `<video src="/files/video.mp4">Fallback text</video>`
    978. 

  978.  *
    979. 

  979.  * Using multiple video files:
    980. 

  980.  *
    981. 

  981.  * {{{
    982. 

  982.  * echo $this->Html->media(
    983. 

  983.  * 		array('video.mp4', array('src' => 'video.ogv', 'type' => "video/ogg; codecs='theora, vorbis'")),
    984. 

  984.  * 		array('tag' => 'video', 'autoplay')
    985. 

  985.  * );
    986. 

  986.  * }}}
    987. 

  987.  *
    988. 

  988.  * Outputs:
    989. 

  989.  *
    990. 

  990.  * {{{
    991. 

  991.  * <video autoplay="autoplay">
    992. 

  992.  * 		<source src="/files/video.mp4" type="video/mp4"/>
    993. 

  993.  * 		<source src="/files/video.ogv" type="video/ogv; codecs='theora, vorbis'"/>
    994. 

  994.  * </video>
    995. 

  995.  * }}}
    996. 

  996.  *
    997. 

  997.  * ### Options
    998. 

  998.  *
    999. 

  999.  * - `tag` Type of media element to generate, either "audio" or "video".
    1000. 

  1000.  * 	If tag is not provided it's guessed based on file's mime type.
    1001. 

  1001.  * - `text` Text to include inside the audio/video tag
    1002. 

  1002.  * - `pathPrefix` Path prefix to use for relative urls, defaults to 'files/'
    1003. 

  1003.  * - `fullBase` If provided the src attribute will get a full address including domain name
    1004. 

  1004.  *
    1005. 

  1005.  * @param string|array $path Path to the video file, relative to the webroot/{$options['pathPrefix']} directory.
    1006. 

  1006.  *  Or an array where each item itself can be a path string or an associate array containing keys `src` and `type`
    1007. 

  1007.  * @param array $options Array of HTML attributes, and special options above.
    1008. 

  1008.  * @return string Generated media element
    1009. 

  1009.  */
    1010. 

  1010. 	public function media($path, $options = array()) {
    1011. 

  1011. 		$options += array(
    1012. 

  1012. 			'tag' => null,
    1013. 

  1013. 			'pathPrefix' => 'files/',
    1014. 

  1014. 			'text' => ''
    1015. 

  1015. 		);
    1016. 

  1016. 

  1017. 		if (!empty($options['tag'])) {
    1018. 

  1018. 			$tag = $options['tag'];
    1019. 

  1019. 		} else {
    1020. 

  1020. 			$tag = null;
    1021. 

  1021. 		}
    1022. 

  1022. 

  1023. 		if (is_array($path)) {
    1024. 

  1024. 			$sourceTags = '';
    1025. 

  1025. 			foreach ($path as &$source) {
    1026. 

  1026. 				if (is_string($source)) {
    1027. 

  1027. 					$source = array(
    1028. 

  1028. 						'src' => $source,
    1029. 

  1029. 					);
    1030. 

  1030. 				}
    1031. 

  1031. 				if (!isset($source['type'])) {
    1032. 

  1032. 					$ext = pathinfo($source['src'], PATHINFO_EXTENSION);
    1033. 

  1033. 					$source['type'] = $this->response->getMimeType($ext);
    1034. 

  1034. 				}
    1035. 

  1035. 				$source['src'] = $this->assetUrl($source['src'], $options);
    1036. 

  1036. 				$sourceTags .= $this->useTag('tagselfclosing', 'source', $source);
    1037. 

  1037. 			}
    1038. 

  1038. 			unset($source);
    1039. 

  1039. 			$options['text'] = $sourceTags . $options['text'];
    1040. 

  1040. 			unset($options['fullBase']);
    1041. 

  1041. 		} else {
    1042. 

  1042. 			if (empty($path) && !empty($options['src'])) {
    1043. 

  1043. 				$path = $options['src'];
    1044. 

  1044. 			}
    1045. 

  1045. 			$options['src'] = $this->assetUrl($path, $options);
    1046. 

  1046. 		}
    1047. 

  1047. 

  1048. 		if ($tag === null) {
    1049. 

  1049. 			if (is_array($path)) {
    1050. 

  1050. 				$mimeType = $path[0]['type'];
    1051. 

  1051. 			} else {
    1052. 

  1052. 				$mimeType = $this->response->getMimeType(pathinfo($path, PATHINFO_EXTENSION));
    1053. 

  1053. 			}
    1054. 

  1054. 			if (preg_match('#^video/#', $mimeType)) {
    1055. 

  1055. 				$tag = 'video';
    1056. 

  1056. 			} else {
    1057. 

  1057. 				$tag = 'audio';
    1058. 

  1058. 			}
    1059. 

  1059. 		}
    1060. 

  1060. 

  1061. 		if (isset($options['poster'])) {
    1062. 

  1062. 			$options['poster'] = $this->assetUrl($options['poster'], array('pathPrefix' => IMAGES_URL) + $options);
    1063. 

  1063. 		}
    1064. 

  1064. 		$text = $options['text'];
    1065. 

  1065. 

  1066. 		$options = array_diff_key($options, array(
    1067. 

  1067. 			'tag' => '',
    1068. 

  1068. 			'fullBase' => '',
    1069. 

  1069. 			'pathPrefix' => '',
    1070. 

  1070. 			'text' => ''
    1071. 

  1071. 		));
    1072. 

  1072. 		return $this->tag($tag, $text, $options);
    1073. 

  1073. 	}
    1074. 

  1074. 

  1075. /**
    1076. 

  1076.  * Build a nested list (UL/OL) out of an associative array.
    1077. 

  1077.  *
    1078. 

  1078.  * @param array $list Set of elements to list
    1079. 

  1079.  * @param array $options Additional HTML attributes of the list (ol/ul) tag or if ul/ol use that as tag
    1080. 

  1080.  * @param array $itemOptions Additional HTML attributes of the list item (LI) tag
    1081. 

  1081.  * @param string $tag Type of list tag to use (ol/ul)
    1082. 

  1082.  * @return string The nested list
    1083. 

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

  1084.  */
    1085. 

  1085. 	public function nestedList($list, $options = array(), $itemOptions = array(), $tag = 'ul') {
    1086. 

  1086. 		if (is_string($options)) {
    1087. 

  1087. 			$tag = $options;
    1088. 

  1088. 			$options = array();
    1089. 

  1089. 		}
    1090. 

  1090. 		$items = $this->_nestedListItem($list, $options, $itemOptions, $tag);
    1091. 

  1091. 		return sprintf($this->_tags[$tag], $this->_parseAttributes($options, null, ' ', ''), $items);
    1092. 

  1092. 	}
    1093. 

  1093. 

  1094. /**
    1095. 

  1095.  * Internal function to build a nested list (UL/OL) out of an associative array.
    1096. 

  1096.  *
    1097. 

  1097.  * @param array $items Set of elements to list
    1098. 

  1098.  * @param array $options Additional HTML attributes of the list (ol/ul) tag
    1099. 

  1099.  * @param array $itemOptions Additional HTML attributes of the list item (LI) tag
    1100. 

  1100.  * @param string $tag Type of list tag to use (ol/ul)
    1101. 

  1101.  * @return string The nested list element
    1102. 

  1102.  * @see HtmlHelper::nestedList()
    1103. 

  1103.  */
    1104. 

  1104. 	protected function _nestedListItem($items, $options, $itemOptions, $tag) {
    1105. 

  1105. 		$out = '';
    1106. 

  1106. 

  1107. 		$index = 1;
    1108. 

  1108. 		foreach ($items as $key => $item) {
    1109. 

  1109. 			if (is_array($item)) {
    1110. 

  1110. 				$item = $key . $this->nestedList($item, $options, $itemOptions, $tag);
    1111. 

  1111. 			}
    1112. 

  1112. 			if (isset($itemOptions['even']) && $index % 2 == 0) {
    1113. 

  1113. 				$itemOptions['class'] = $itemOptions['even'];
    1114. 

  1114. 			} elseif (isset($itemOptions['odd']) && $index % 2 != 0) {
    1115. 

  1115. 				$itemOptions['class'] = $itemOptions['odd'];
    1116. 

  1116. 			}
    1117. 

  1117. 			$out .= sprintf($this->_tags['li'], $this->_parseAttributes($itemOptions, array('even', 'odd'), ' ', ''), $item);
    1118. 

  1118. 			$index++;
    1119. 

  1119. 		}
    1120. 

  1120. 		return $out;
    1121. 

  1121. 	}
    1122. 

  1122. 

  1123. /**
    1124. 

  1124.  * Load Html tag configuration.
    1125. 

  1125.  *
    1126. 

  1126.  * Loads a file from APP/Config that contains tag data.  By default the file is expected
    1127. 

  1127.  * to be compatible with PhpReader:
    1128. 

  1128.  *
    1129. 

  1129.  * `$this->Html->loadConfig('tags.php');`
    1130. 

  1130.  *
    1131. 

  1131.  * tags.php could look like:
    1132. 

  1132.  *
    1133. 

  1133.  * {{{
    1134. 

  1134.  * $tags = array(
    1135. 

  1135.  *		'meta' => '<meta %s>'
    1136. 

  1136.  * );
    1137. 

  1137.  * }}}
    1138. 

  1138.  *
    1139. 

  1139.  * If you wish to store tag definitions in another format you can give an array
    1140. 

  1140.  * containing the file name, and reader class name:
    1141. 

  1141.  *
    1142. 

  1142.  * `$this->Html->loadConfig(array('tags.ini', 'ini'));`
    1143. 

  1143.  *
    1144. 

  1144.  * Its expected that the `tags` index will exist from any configuration file that is read.
    1145. 

  1145.  * You can also specify the path to read the configuration file from, if APP/Config is not
    1146. 

  1146.  * where the file is.
    1147. 

  1147.  *
    1148. 

  1148.  * `$this->Html->loadConfig('tags.php', APP . 'Lib' . DS);`
    1149. 

  1149.  *
    1150. 

  1150.  * Configuration files can define the following sections:
    1151. 

  1151.  *
    1152. 

  1152.  * - `tags` The tags to replace.
    1153. 

  1153.  * - `minimizedAttributes` The attributes that are represented like `disabled="disabled"`
    1154. 

  1154.  * - `docTypes` Additional doctypes to use.
    1155. 

  1155.  * - `attributeFormat` Format for long attributes e.g. `'%s="%s"'`
    1156. 

  1156.  * - `minimizedAttributeFormat` Format for minimized attributes e.g. `'%s="%s"'`
    1157. 

  1157.  *
    1158. 

  1158.  * @param mixed $configFile String with the config file (load using PhpReader) or an array with file and reader name
    1159. 

  1159.  * @param string $path Path with config file
    1160. 

  1160.  * @return mixed False to error or loaded configs
    1161. 

  1161.  * @throws ConfigureException
    1162. 

  1162.  * @link http://book.cakephp.org/2.0/en/core-libraries/helpers/html.html#changing-the-tags-output-by-htmlhelper
    1163. 

  1163.  */
    1164. 

  1164. 	public function loadConfig($configFile, $path = null) {
    1165. 

  1165. 		if (!$path) {
    1166. 

  1166. 			$path = APP . 'Config' . DS;
    1167. 

  1167. 		}
    1168. 

  1168. 		$file = null;
    1169. 

  1169. 		$reader = 'php';
    1170. 

  1170. 

  1171. 		if (!is_array($configFile)) {
    1172. 

  1172. 			$file = $configFile;
    1173. 

  1173. 		} elseif (isset($configFile[0])) {
    1174. 

  1174. 			$file = $configFile[0];
    1175. 

  1175. 			if (isset($configFile[1])) {
    1176. 

  1176. 				$reader = $configFile[1];
    1177. 

  1177. 			}
    1178. 

  1178. 		} else {
    1179. 

  1179. 			throw new ConfigureException(__d('cake_dev', 'Cannot load the configuration file. Wrong "configFile" configuration.'));
    1180. 

  1180. 		}
    1181. 

  1181. 

  1182. 		$readerClass = Inflector::camelize($reader) . 'Reader';
    1183. 

  1183. 		App::uses($readerClass, 'Configure');
    1184. 

  1184. 		if (!class_exists($readerClass)) {
    1185. 

  1185. 			throw new ConfigureException(__d('cake_dev', 'Cannot load the configuration file. Unknown reader.'));
    1186. 

  1186. 		}
    1187. 

  1187. 

  1188. 		$readerObj = new $readerClass($path);
    1189. 

  1189. 		$configs = $readerObj->read($file);
    1190. 

  1190. 		if (isset($configs['tags']) && is_array($configs['tags'])) {
    1191. 

  1191. 			$this->_tags = array_merge($this->_tags, $configs['tags']);
    1192. 

  1192. 		}
    1193. 

  1193. 		if (isset($configs['minimizedAttributes']) && is_array($configs['minimizedAttributes'])) {
    1194. 

  1194. 			$this->_minimizedAttributes = array_merge($this->_minimizedAttributes, $configs['minimizedAttributes']);
    1195. 

  1195. 		}
    1196. 

  1196. 		if (isset($configs['docTypes']) && is_array($configs['docTypes'])) {
    1197. 

  1197. 			$this->_docTypes = array_merge($this->_docTypes, $configs['docTypes']);
    1198. 

  1198. 		}
    1199. 

  1199. 		if (isset($configs['attributeFormat'])) {
    1200. 

  1200. 			$this->_attributeFormat = $configs['attributeFormat'];
    1201. 

  1201. 		}
    1202. 

  1202. 		if (isset($configs['minimizedAttributeFormat'])) {
    1203. 

  1203. 			$this->_minimizedAttributeFormat = $configs['minimizedAttributeFormat'];
    1204. 

  1204. 		}
    1205. 

  1205. 		return $configs;
    1206. 

  1206. 	}
    1207. 

  1207. 

  1208. }
    1209. 

  1209.