adulau/cakephp2-php8
1
0
Fork 0
mirror of https://github.com/kamilwylegala/cakephp2-php8.git synced 2024-11-15 19:38:26 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
cakephp2-php8/cake/libs/view/helpers/html.php
phpnut d62b9ec65e Merging from sandboxes 
[1079]
Merged [1005] committed by nate but not added to core prior to release.
Merged [1078] prior to modifying all developers sandboxes.

[1081]
adding view and template directories

[1082]
adding base files for view generator 

[1083]
correcting all package and sub package tags for in doc blocks.
Making sure every file in the core has doc block in them

[1084]
renaming working copy of latest release

[1093]
Added fix for associations using underscores if var $useTable is set in the associated models.
This closes ticket #11.

[1094]
Fix for Ticket #24.
The problem was tracked to a variable in View::_render();
$loadedHelpers was being assigned a reference when it when it should not have been.

[1096]
Initial work on controller components needs testing.
Also added a work around for the basics.php uses().
Using the define DS where the files from the original version are now located in deeper libs directories.

[1097]
committing a few typos in the code I added

[1098]
reformatting code in component.php

[1104]
changed the test route and corrected a regex in inflector.

[1111]
removing the contructor from dispatcher, it is not needed

[1112]
Changes made for errors when a file is not present in webroot.
Fixed the regex used in Router::parse().
Change the error layout template.

[1113]
Changes to Folder class to allow setting the permissions mode when constructing.
This class needs to be refactored and move everything that is in the contructor out.
The constructor should set the vars for use in other Folder::"methods"().
Will work on this at a later time.

git-svn-id: https://svn.cakephp.org/repo/trunk/cake@1114 3807eeeb-6ff5-0310-8944-8be069107fe0
2005-10-09 01:56:21 +00:00

1397 lines
No EOL
45 KiB
PHP
Raw Blame History

<?php
/* SVN FILE: $Id$ */
/**
* Html Helper class file.
*
* PHP versions 4 and 5
*
* CakePHP : Rapid Development Framework <http://www.cakephp.org/>
* Copyright (c) 2005, CakePHP Authors/Developers
*
* Author(s): Michal Tatarynowicz aka Pies <tatarynowicz@gmail.com>
* Larry E. Masters aka PhpNut <nut@phpnut.com>
* Kamil Dzielinski aka Brego <brego.dk@gmail.com>
*
* Licensed under The MIT License
* Redistributions of files must retain the above copyright notice.
*
* @filesource
* @author CakePHP Authors/Developers
* @copyright Copyright (c) 2005, CakePHP Authors/Developers
* @link https://trac.cakephp.org/wiki/Authors Authors/Developers
* @package cake
* @subpackage cake.cake.libs.view.helpers
* @since CakePHP v 0.9.1
* @version $Revision$
* @modifiedby $LastChangedBy$
* @lastmodified $Date$
* @license http://www.opensource.org/licenses/mit-license.php The MIT License
*/
/**
* Html Helper class for easy use of HTML widgets.
*
* HtmlHelper encloses all methods needed while working with HTML pages.
*
* @package cake
* @subpackage cake.cake.libs.view.helpers
* @since CakePHP v 0.9.1
*/
class HtmlHelper extends Helper
{
/*************************************************************************
* Public variables
*************************************************************************/
/**#@+
* @access public
*/
/**
* Enter description here...
*
* @var unknown_type
*/
var $base = null;
/**
* Enter description here...
*
* @var unknown_type
*/
var $here = null;
/**
* Enter description here...
*
* @var array
*/
var $params = array();
/**
* Enter description here...
*
* @var string
*/
var $action = null;
/**
* Enter description here...
*
* @var unknown_type
*/
var $data = null;
/**
* Name of model this helper is attached to.
*
* @var string
*/
var $model = null;
/**
* Enter description here...
*
* @var string
*/
var $field = null;
/**#@-*/
/*************************************************************************
* Private variables
*************************************************************************/
/**#@+
* @access private
*/
/**
* Breadcrumbs.
*
* @var array
* @access private
*/
var $_crumbs = array();
/**
* Adds a link to the breadcrumbs array.
*
* @param string $name Text for link
* @param string $link URL for link
*/
function addCrumb($name, $link)
{
$this->_crumbs[] = array($name, $link);
}
/**
* Returns a charset META-tag.
*
* @param string $charset
* @param boolean $return Wheter this method should return a value or
* output it. This overrides AUTO_OUTPUT.
* @return mixed Either string or boolean value, depends on AUTO_OUTPUT
* and $return.
*/
function charset($charset, $return)
{
return $this->output(sprintf($this->tags['charset'], $charset), $return);
}
/**
* Finds URL for specified action.
*
* Returns an URL pointing to a combination of controller and action. Param
* $url can be:
* + Empty - the method will find adress to actuall controller/action.
* + '/' - the method will find base URL of application.
* + A combination of controller/action - the method will find url for it.
*
* @param string $url
* @param boolean $return Wheter this method should return a value or
* output it. This overrides AUTO_OUTPUT.
* @return mixed Either string or boolean value, depends on AUTO_OUTPUT
* and $return.
*/
function url($url = null, $return = false)
{
if (empty($url))
{
return $this->here;
}
elseif ($url{0} == '/')
{
$output = $this->base . $url;
}
else
{
$output = $this->base.'/'.strtolower($this->params['controller']).'/'.$url;
}
return $this->output(preg_replace('/&([^a])/', '&amp;\1', $output), $return);
}
/**
* 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.
*
* @param string $title The content of the A tag.
* @param string $url
* @param array $htmlAttributes Array of HTML attributes.
* @param string $confirmMessage Confirmation message.
* @param boolean $escapeTitle Whether or not the text in the $title variable should be HTML escaped.
* @param boolean $return Wheter this method should return a value
* or output it. This overrides AUTO_OUTPUT.
* @return mixed Either string or boolean value, depends on AUTO_OUTPUT
* and $return.
*/
function link($title, $url = null, $htmlAttributes = null, $confirmMessage = false, $escapeTitle = true, $return = false)
{
// prepare title for html display
if( $escapeTitle )
{
$title = htmlspecialchars($title, ENT_QUOTES);
}
$url = $url? $url: $title;
if ($confirmMessage)
{
// prepare for HTML display (fix everything except quotes)
$confirmMessage = htmlspecialchars($confirmMessage, ENT_NOQUOTES);
// fix single quotes
$confirmMessage = str_replace("'", "\'", $confirmMessage);
// fix double quotes
$confirmMessage = str_replace('"', '&quot;', $confirmMessage);
$htmlAttributes['onclick'] = "return confirm('{$confirmMessage}');";
}
if (strpos($url, '://'))
{
$output = sprintf($this->tags['link'], $url,
$this->_parseAttributes($htmlAttributes), $title);
}
else
{
$output = sprintf($this->tags['link'], $this->url($url, true),
$this->_parseAttributes($htmlAttributes), $title);
}
return $this->output($output, $return);
}
/**
* Creates a submit widget.
*
* @param string $caption Text on submit button
* @param array $htmlAttributes Array of HTML attributes.
* @param boolean $return Wheter this method should return a value
* or output it. This overrides AUTO_OUTPUT.
* @return mixed Either string or boolean value, depends on AUTO_OUTPUT
* and $return.
*/
function submit($caption = 'Submit', $htmlAttributes = null, $return = false)
{
$htmlAttributes['value'] = $caption;
return $this->output(sprintf($this->tags['submit'],
$this->_parseAttributes($htmlAttributes, null, '', ' ')), $return);
}
/**
* Creates a password input widget.
*
* @param string $fieldName If field is to be used for CRUD, this
* should be modelName/fieldName.
* @param array $htmlAttributes Array of HTML attributes.
* @param boolean $return Wheter this method should return a value
* or output it. This overrides AUTO_OUTPUT.
* @return mixed Either string or boolean value, depends on AUTO_OUTPUT
* and $return.
*/
function password($fieldName, $htmlAttributes = null, $return = false)
{
$this->setFormTag($fieldName);
if (empty($htmlAttributes['value']))
{
$htmlAttributes['value'] = $this->tagValue($fieldName);
}
return $this->output(sprintf($this->tags['password'], $this->model, $this->field,
$this->_parseAttributes($htmlAttributes, null, ' ', ' ')), $return);
}
/**
* Creates a textarea widget.
*
* @param string $fieldName If field is to be used for CRUD, this
* should be modelName/fieldName.
* @param array $htmlAttributes Array of HTML attributes.
* @param boolean $return Wheter this method should return a value
* or output it. This overrides AUTO_OUTPUT.
* @return mixed Either string or boolean value, depends on AUTO_OUTPUT
* and $return.
*/
function textarea($fieldName, $htmlAttributes = null, $return = false)
{
$this->setFormTag($fieldName);
$value = $this->tagValue($fieldName);
if(!empty($htmlAttributes['value']) && !$value)
{
$value = $htmlAttributes['value'];
}
if ($this->tagIsInvalid($this->model, $this->field))
{
$htmlAttributes['class'] = 'form_error';
}
return $this->output(sprintf($this->tags['textarea'], $this->model,$this->field,
$this->_parseAttributes($htmlAttributes, null, ' '), $value), $return);
}
/**
* Creates a checkbox widget.
*
* @param string $fieldName If field is to be used for CRUD, this
* should be modelName/fieldName.
* @param string $title
* @param array $htmlAttributes Array of HTML attributes.
* @param boolean $return Wheter this method should return a value
* or output it. This overrides AUTO_OUTPUT.
* @return mixed Either string or boolean value, depends on AUTO_OUTPUT
* and $return.
*/
function checkbox($fieldName, $title = null, $htmlAttributes = null,
$return = false)
{
$this->setFormTag($fieldName);
$this->tagValue($fieldName)? $htmlAttributes['checked'] = 'checked': null;
$title = $title? $title: ucfirst($fieldName);
return $this->output(sprintf($this->tags['checkbox'], $this->model, $this->field,
$this->field,
$this->_parseAttributes($htmlAttributes, null, '', ' '), $title), $return);
}
/**
* Creates a link element for CSS stylesheets.
*
* @param string $path Path to CSS file
* @param string $rel Rel attribute. Defaults to "stylesheet".
* @param array $htmlAttributes Array of HTML attributes.
* @param boolean $return Wheter this method should return a value
* or output it. This overrides AUTO_OUTPUT.
* @return mixed Either string or boolean value, depends on AUTO_OUTPUT
* and $return.
*/
function css($path, $rel = 'stylesheet', $htmlAttributes = null, $return = false)
{
$url = "{$this->webroot}".(COMPRESS_CSS? 'c': '').CSS_URL.$path.".css";
return $this->output(sprintf($this->tags['css'], $rel, $url,
$this->parseHtmlOptions($htmlAttributes, null, '', ' ')), $return);
}
/**
* Creates file input widget.
*
* @param string $fieldName If field is to be used for CRUD, this
* should be modelName/fieldName.
* @param array $htmlAttributes Array of HTML attributes.
* @param boolean $return Wheter this method should return a value
* or output it. This overrides AUTO_OUTPUT.
* @return mixed Either string or boolean value, depends on AUTO_OUTPUT
* and $return.
*/
function file($fieldName, $htmlAttributes = null, $return = false)
{
return $this->output(sprintf($this->tags['file'], $fieldName,
$this->_parseAttributes($htmlAttributes, null, '', ' ')), $return);
}
/**
* Returns the breadcrumb trail as a sequence of &raquo;-separated links.
*
* @param string $separator Text to separate crumbs.
* @param boolean $return Wheter this method should return a value
* or output it. This overrides AUTO_OUTPUT.
* @return mixed Either string or boolean value, depends on AUTO_OUTPUT
* and $return. If $this->_crumbs is empty, return null.
*/
function getCrumbs($separator = '&raquo;', $return = false)
{
if(count($this->_crumbs))
{
$out = array("<a href=\"{$this->base}\">START</a>");
foreach ($this->_crumbs as $crumb)
{
$out[] = "<a href=\"{$this->base}{$crumb[1]}\">{$crumb[0]}</a>";
}
return $this->output(join($separator, $out), $return);
}
else
{
return null;
}
}
/**
* Creates a hidden input tag.
*
* @param string $fieldName If field is to be used for CRUD, this
* should be modelName/fieldName.
* @param array $htmlAttributes Array of HTML attributes.
* @param boolean $return Wheter this method should return a value
* or output it. This overrides AUTO_OUTPUT.
* @return mixed Either string or boolean value, depends on AUTO_OUTPUT
* and $return.
*/
function hidden($fieldName, $htmlAttributes = null, $return = false)
{
$this->setFormTag($fieldName);
if(!isset($htmlAttributes['value'])) {
$htmlAttributes['value'] = $this->tagValue($fieldName);
}
return $this->output(sprintf($this->tags['hidden'], $this->model, $this->field,
$this->_parseAttributes($htmlAttributes, null, ' ', ' ')), $return);
}
/**
* Creates a formatted IMG element.
*
* @param string $path Path to the image file.
* @param array $htmlAttributes Array of HTML attributes.
* @param boolean $return Wheter this method should return a value
* or output it. This overrides AUTO_OUTPUT.
* @return mixed Either string or boolean value, depends on AUTO_OUTPUT
* and $return.
*/
function image($path, $htmlAttributes = null, $return = false)
{
$url = $this->webroot.IMAGES_URL.$path;
return $this->output(sprintf($this->tags['image'], $url, $this->parseHtmlOptions($htmlAttributes, null, '', ' ')), $return);
}
/**
* Creates a text input widget.
*
* @param string $fieldName If field is to be used for CRUD, this
* should be modelName/fieldName.
* @param array $htmlAttributes Array of HTML attributes.
* @param boolean $return Wheter this method should return a value
* or output it. This overrides AUTO_OUTPUT.
* @return mixed Either string or boolean value, depends on AUTO_OUTPUT
* and $return.
*/
function input($fieldName, $htmlAttributes = null, $return = false)
{
$this->setFormTag($fieldName);
if (!isset($htmlAttributes['value']))
{
$htmlAttributes['value'] = $this->tagValue($fieldName);
}
if ($this->tagIsInvalid($this->model, $this->field))
{
$htmlAttributes['class'] = 'form_error';
}
return $this->output(sprintf($this->tags['input'], $this->model, $this->field,
$this->_parseAttributes($htmlAttributes, null, ' ', ' ')), $return);
}
/**
* Creates a set of radio widgets.
*
* @param string $fieldName If field is to be used for CRUD, this
* should be modelName/fieldName.
* @param array $options
* @param array $inbetween
* @param array $htmlAttributes Array of HTML attributes.
* @param boolean $return Wheter this method should return a value
* or output it. This overrides AUTO_OUTPUT.
* @return mixed Either string or boolean value, depends on AUTO_OUTPUT
* and $return.
*/
function radio($fieldName, $options, $inbetween = null, $htmlAttributes = null,
$return = false)
{
$this->setFormTag($fieldName);
$value = isset($htmlAttributes['value'])? $htmlAttributes['value']: $this->tagValue($fieldName);
$out = array();
foreach ($options as $opt_value=>$opt_title)
{
$options_here = array('value' => $opt_value);
$opt_value==$value? $options_here['checked'] = 'checked': null;
$parsed_options = $this->parseHtmlOptions(array_merge($htmlAttributes, $options_here), null, '', ' ');
$individual_tag_name = "{$this->field}_{$opt_value}";
$out[] = sprintf($this->tags['radio'], $individual_tag_name, $this->model, $this->field, $individual_tag_name, $parsed_options, $opt_title);
}
$out = join($inbetween, $out);
return $this->output($out? $out: null, $return);
}
/**
* Returns a row of formatted and named TABLE headers.
*
* @param array $names
* @param array $tr_options
* @param array $th_options
* @return string
*/
function tableHeaders($names, $tr_options=null, $th_options=null)
{
$out = array();
foreach ($names as $arg)
{
$out[] = sprintf($this->tags['tableheader'], $this->parseHtmlOptions($th_options), $arg);
}
return sprintf($this->tags['tableheader'], $this->parseHtmlOptions($tr_options), join(' ', $out));
}
/**
* Returns a formatted string of table rows (TR's with TD's in them).
*
* @param array $data Array of table data
* @param array $tr_options HTML options for TR elements
* @param array $td_options HTML options for TD elements
* @return string
*/
function tableCells($data, $odd_tr_options=null, $even_tr_options=null)
{
if (empty($data[0]) || !is_array($data[0]))
{
$data = array($data);
}
$count=0;
foreach ($data as $line)
{
$count++;
$cells_out = array();
foreach ($line as $cell)
{
$cells_out[] = sprintf($this->tags['tablecell'], null, $cell);
}
$options = $this->parseHtmlOptions($count%2? $odd_tr_options: $even_tr_options);
$out[] = sprintf($this->tags['tablerow'], $options, join(' ', $cells_out));
}
return join("\n", $out);
}
/**
* Returns value of $fieldName. False is the tag does not exist.
*
* @param string $fieldName
* @return unknown Value of the named tag.
*/
function tagValue ($fieldName)
{
$this->setFormTag($fieldName);
return isset($this->params['data'][$this->model][$this->field])? $this->params['data'][$this->model][$this->field]: false;
}
/**
* Returns false if given FORM field has no errors. Otherwise it returns the constant set in the array Model->validationErrors.
*
* @param string $model
* @param string $field
* @return unknown
*/
function tagIsInvalid ($model, $field)
{
return empty($this->validationErrors[$model][$field])? 0: $this->validationErrors[$model][$field];
}
/**
* Returns number of errors in a submitted FORM.
*
* @return int Number of errors
*/
function validate ()
{
$args = func_get_args();
$errors = call_user_func_array(array(&$this, 'validateErrors'), $args);
return count($errors);
}
/**
* Validates a FORM according to the rules set up in the Model.
*
* @return int Number of errors
*/
function validateErrors ()
{
$objects = func_get_args();
if (!count($objects)) return false;
$errors = array();
foreach ($objects as $object)
{
$errors = array_merge($errors, $object->invalidFields($object->data));
}
return $this->validationErrors = (count($errors)? $errors: false);
}
/**
* Returns a formatted error message for given FORM field, NULL if no errors.
*
* @param string $field If field is to be used for CRUD, this should be modelName/fieldName
* @param string $text
* @return string If there are errors this method returns an error message, else NULL.
*/
function tagErrorMsg ($field, $text)
{
$error = 1;
$this->setFormTag($field);
if ($error == $this->tagIsInvalid($this->model, $this->field))
{
return sprintf(SHORT_ERROR_MESSAGE, is_array($text)? (empty($text[$error-1])? 'Error in field': $text[$error-1]): $text);
}
else
{
return null;
}
}
/**
* Sets this helper's model and field properties to the slash-separated value-pair in $tagValue.
*
* @param string $tagValue Slash-separated model/field pair.
*/
function setFormTag($tagValue)
{
return list($this->model, $this->field) = explode("/", $tagValue);
}
/**#@-*/
/*************************************************************************
* Private methods
*************************************************************************/
/**#@+
* @access private
*/
/**
* Returns a space-separated string with items of the $options array. If a
* key of $options array happens to be one of:
* + 'compact'
* + 'checked'
* + 'declare'
* + 'readonly'
* + 'disabled'
* + 'selected'
* + 'defer'
* + 'ismap'
* + 'nohref'
* + 'noshade'
* + 'nowrap'
* + 'multiple'
* + 'noresize'
*
* And it's value is one of:
* + 1
* + true
* + 'true'
*
* Then the value will be reset to be identical with key's name.
* If the value is not one of these 3, the parameeter is not outputed.
*
* @param array $options Array of options.
* @param array $exclude Array of options to be excluded.
* @param string $insertBefore String to be inserted before options.
* @param string $insertAfter String to be inserted ater options.
* @return string
*/
function _parseAttributes($options, $exclude = null, $insertBefore = ' ',
$insertAfter = null)
{
$minimizedAttributes = array(
'compact',
'checked',
'declare',
'readonly',
'disabled',
'selected',
'defer',
'ismap',
'nohref',
'noshade',
'nowrap',
'multiple',
'noresize');
if (!is_array($exclude))
{
$exclude = array();
}
if (is_array($options))
{
$out = array();
foreach ($options as $key => $value)
{
if (!in_array($key, $exclude))
{
if (in_array($key, $minimizedAttributes) && ($value === 1 ||
$value === true || $value === 'true' || in_array($value,
$minimizedAttributes)))
{
$value = $key;
}
elseif (in_array($key, $minimizedAttributes))
{
continue;
}
$out[] = "{$key}=\"{$value}\"";
}
}
$out = join(' ', $out);
return $out? $insertBefore.$out.$insertAfter: null;
}
else
{
return $options? $insertBefore.$options.$insertAfter: null;
}
}
/**#@-*/
/*************************************************************************
* Renamed methods
*************************************************************************/
/**
* @deprecated Name changed to 'textarea'. Version 0.9.2.
* @see HtmlHelper::textarea()
* @param string $tagName
* @param integer $cols
* @param integer $rows
* @param array $htmlAttributes Array of HTML attributes.
* @param boolean $return Wheter this method should return a value
* or output it. This overrides AUTO_OUTPUT.
* @return mixed Either string or boolean value, depends on AUTO_OUTPUT
* and $return.
*/
function areaTag($tagName, $cols = 60, $rows = 10, $htmlAttributes = null, $return = false)
{
$htmlAttributes['cols'] = $cols;
$htmlAttributes['rows'] = $rows;
return $this->textarea($tagName, $htmlAttributes, $return);
}
/**
* @deprecated Name changed to 'charset'. Version 0.9.2.
* @see HtmlHelper::charset()
* @param string $charset
* @param boolean $return Wheter this method should return a value
* or output it. This overrides AUTO_OUTPUT.
* @return mixed Either string or boolean value, depends on AUTO_OUTPUT
* and $return.
*/
function charsetTag($charset, $return = false)
{
return $this->charset($charset, $return);
}
/**
* @deprecated Name changed to 'checkbox'. Version 0.9.2.
* @see HtmlHelper::checkbox()
* @param string $fieldName If field is to be used for CRUD, this
* should be modelName/fieldName.
* @param string $title
* @param array $htmlAttributes Array of HTML attributes.
* @param boolean $return Wheter this method should return a value
* or output it. This overrides AUTO_OUTPUT.
* @return mixed Either string or boolean value, depends on AUTO_OUTPUT
* and $return.
*/
function checkboxTag($fieldName, $title = null, $htmlAttributes = null, $return = false)
{
return $this->checkbox($fieldName, $title, $htmlAttributes, $return);
}
/**
* @deprecated Name changed to 'css'. Version 0.9.2.
* @see HtmlHelper::css()
* @param string $path Path to CSS file
* @param string $rel Rel attribute. Defaults to "stylesheet".
* @param array $htmlAttributes Array of HTML attributes.
* @param boolean $return Wheter this method should return a value
* or output it. This overrides AUTO_OUTPUT.
* @return mixed Either string or boolean value, depends on AUTO_OUTPUT
* and $return.
*/
function cssTag($path, $rel = 'stylesheet', $htmlAttributes = null, $return = false)
{
return $this->css($path, $rel , $htmlAttributes , $return );
}
/**
* @deprecated Name changed to 'file'. Version 0.9.2.
* @see HtmlHelper::file()
* @param string $fieldName If field is to be used for CRUD, this
* should be modelName/fieldName.
* @param array $htmlAttributes Array of HTML attributes.
* @param boolean $return Wheter this method should return a value
* or output it. This overrides AUTO_OUTPUT.
* @return mixed Either string or boolean value, depends on AUTO_OUTPUT
* and $return.
*/
function fileTag($fieldName, $htmlAttributes = null, $return = false)
{
return $this->file($fieldName, $htmlAttributes, $return);
}
/**
* @deprecated Name changed to 'hidden'. Version 0.9.2.
* @see HtmlHelper::hidden()
* @param string $fieldName If field is to be used for CRUD, this
* should be modelName/fieldName.
* @param string $value
* @param array $htmlAttributes Array of HTML attributes.
* @param boolean $return Wheter this method should return a value
* or output it. This overrides AUTO_OUTPUT.
* @return mixed Either string or boolean value, depends on AUTO_OUTPUT
* and $return.
*/
//function hiddenTag($fieldName, $value = null, $htmlAttributes = null, $return = false)
//{
// $htmlAttributes['value'] = $value;
// return $this->hidden($fieldName, $htmlAttributes, $return);
//}
function hiddenTag($tagName, $value=null, $htmlOptions=null)
{
$this->setFormTag($tagName);
$htmlOptions['value'] = $value? $value: $this->tagValue($tagName);
return $this->output(sprintf($this->tags['hidden'], $this->model, $this->field, $this->parseHtmlOptions($htmlOptions, null, '', ' ')));
}
/**
* @deprecated Name changed to 'image'. Version 0.9.2.
* @see HtmlHelper::image()
* @param string $path Path to the image file.
* @param string $alt
* @param array $htmlAttributes Array of HTML attributes.
* @param boolean $return Wheter this method should return a value
* or output it. This overrides AUTO_OUTPUT.
* @return mixed Either string or boolean value, depends on AUTO_OUTPUT
* and $return.
*/
function imageTag($path, $alt = null, $htmlAttributes = null, $return = false)
{
$htmlAttributes['alt'] = $alt;
return $this->image($path, $htmlAttributes, $return);
}
/**
* @deprecated Name changed to 'input'. Version 0.9.2.
* @see HtmlHelper::input()
* @param string $fieldName If field is to be used for CRUD, this
* should be modelName/fieldName.
* @param string $value
* @param array $htmlAttributes Array of HTML attributes.
* @param boolean $return Wheter this method should return a value
* or output it. This overrides AUTO_OUTPUT.
* @return mixed Either string or boolean value, depends on AUTO_OUTPUT
* and $return.
*/
//function inputTag($fieldName, $value = null, $htmlAttributes = null, $return = false)
//{
// $htmlAttributes['value'] = $value;
// return $this->input($fieldName, $htmlAttributes, $return);
//}
function inputTag($tagName, $size=20, $htmlOptions=null)
{
$this->setFormTag($tagName);
$htmlOptions['value'] = isset($htmlOptions['value'])? $htmlOptions['value']: $this->tagValue($tagName);
$this->tagIsInvalid($this->model,$this->field)? $htmlOptions['class'] = 'form_error': null;
return $this->output(sprintf($this->tags['input'], $this->model, $this->field, $this->parseHtmlOptions($htmlOptions, null, '', ' ')));
}
/**
* @deprecated Unified with 'link'. Version 0.9.2.
* @see HtmlHelper::link()
* @param string $title The content of the "a" tag.
* @param string $url
* @param array $htmlAttributes Array of HTML attributes.
* @param boolean $escapeTitle Whether or not the text in the $title variable should be HTML escaped.
* @param boolean $return Wheter this method should return a value
* or output it. This overrides AUTO_OUTPUT.
* @return mixed Either string or boolean value, depends on AUTO_OUTPUT
* and $return.
*/
function linkOut($title, $url = null, $htmlAttributes = null, $escapeTitle = true, $return = false)
{
return $this->link($title, $url, $htmlAttributes, false, $escapeTitle, $return);
}
/**
* @deprecated Unified with 'link'. Version 0.9.2.
* @see HtmlHelper::link()
* @param string $title The content of the "a" tag.
* @param string $url
* @param array $htmlAttributes Array of HTML attributes.
* @param string $confirmMessage Confirmation message.
* @param boolean $escapeTitle Whether or not the text in the $title variable should be HTML escaped.
* @param boolean $return Wheter this method should return a value
* or output it. This overrides AUTO_OUTPUT.
* @return mixed Either string or boolean value, depends on AUTO_OUTPUT
* and $return.
*/
function linkTo($title, $url, $htmlAttributes = null, $confirmMessage = false, $escapeTitle = true, $return = false)
{
return $this->link($title, $url, $htmlAttributes, $confirmMessage, $escapeTitle, $return);
}
/**
* @deprecated Name changed to '_parseAttributes'. Version 0.9.2.
* @see HtmlHelper::_parseAttributes()
* @param array $options Array of options.
* @param array $exclude Array of options to be excluded.
* @param string $insertBefore String to be inserted before options.
* @param string $insertAfter String to be inserted ater options.
* @return string
*/
//function parseHtmlOptions($options, $exclude = null, $insertBefore = ' ', $insertAfter = null)
// {
// $this->_parseAttributes($options, $exclude, $insertBefore, $insertAfter);
// }
function parseHtmlOptions($options, $exclude=null, $insert_before=' ', $insert_after=null)
{
if (!is_array($exclude)) $exclude = array();
if (is_array($options))
{
$out = array();
foreach ($options as $k=>$v)
{
if (!in_array($k, $exclude))
{
$out[] = "{$k}=\"{$v}\"";
}
}
$out = join(' ', $out);
return $out? $insert_before.$out.$insert_after: null;
}
else
{
return $options? $insert_before.$options.$insert_after: null;
}
}
/**
* @deprecated Name changed to 'password'. Version 0.9.2.
* @see HtmlHelper::password()
* @param string $fieldName If field is to be used for CRUD, this
* should be modelName/fieldName.
* @param array $htmlAttributes Array of HTML attributes.
* @param boolean $return Wheter this method should return a value
* or output it. This overrides AUTO_OUTPUT.
* @return mixed Either string or boolean value, depends on AUTO_OUTPUT
* and $return.
*/
function passwordTag($fieldName, $size = 20, $htmlAttributes = null, $return = false)
{
$args = func_get_args();
return call_user_func_array(array(&$this, "password"), $args);
}
/**
* @deprecated Name changed to 'radio'. Version 0.9.2.
* @see HtmlHelper::radio()
* @param string $fieldName If field is to be used for CRUD, this
* should be modelName/fieldName.
* @param array $options
* @param array $inbetween
* @param array $htmlAttributes Array of HTML attributes.
* @param boolean $return Wheter this method should return a value
* or output it. This overrides AUTO_OUTPUT.
* @return mixed Either string or boolean value, depends on AUTO_OUTPUT
* and $return.
*/
function radioTags($fieldName, $options, $inbetween = null, $htmlAttributes = null,
$return = false)
{
return $this->radio($fieldName, $options, $inbetween, $htmlAttributes, $return);
}
/**
* Returns a SELECT element,
*
* @param string $fieldName Name attribute of the SELECT
* @param array $option_elements Array of the OPTION elements (as 'value'=>'Text' pairs) to be used in the SELECT element
* @param boolean $show_empty Show/hide the empty select option
* @param array $select_attr Array of HTML options for the opening SELECT element
* @param array $optionAttr Array of HTML options for the enclosed OPTION elements
* @return string Formatted SELECT element
*/
function selectTag($fieldName, $option_elements, $selected=null, $select_attr=null, $optionAttr=null, $showEmpty=true)
{
$this->setFormTag($fieldName);
// do not display the select tag if no option elements are avaible
if (!is_array($option_elements) || count($option_elements) == 0)
{
return null;
}
if( isset($select_attr) && array_key_exists( "multiple", $select_attr) )
{
$select[] = sprintf($this->tags['selectmultiplestart'], $this->model, $this->field, $this->parseHtmlOptions($select_attr));
}
else
{
$select[] = sprintf($this->tags['selectstart'], $this->model, $this->field, $this->parseHtmlOptions($select_attr));
}
if($showEmpty == true)
{
$select[] = sprintf($this->tags['selectempty'], $this->parseHtmlOptions($optionAttr));
}
foreach ($option_elements as $name=>$title)
{
$options_here = $optionAttr;
if (!empty($selected) && ($selected == $name))
{
$options_here['selected'] = 'selected';
} else if ( is_array($selected) && array_key_exists($name, $selected) )
{
$options_here['selected'] = 'selected';
}
$select[] = sprintf($this->tags['selectoption'], $name, $this->parseHtmlOptions($options_here), $title);
}
$select[] = sprintf($this->tags['selectend']);
return implode("\n", $select);
}
/**
* @deprecated Name changed to 'url'. Version 0.9.2.
* @see HtmlHelper::url()
*/
function urlFor($url)
{
return $this->url($url);
}
/**
* @deprecated Name changed to 'submit'. Version 0.9.2.
* @see HtmlHelper::submit()
*/
function submitTag()
{
$args = func_get_args();
return call_user_func_array(array(&$this, "submit"), $args);
}
/*************************************************************************
* Moved methods
*************************************************************************/
/**
* @deprecated Moved to TextHelper. Version 0.9.2.
*/
function trim()
{
die("Method HtmlHelper::trim() was moved to TextHelper::trim().");
}
/**
* @deprecated Moved to JavascriptHelper. Version 0.9.2.
*/
function javascriptIncludeTag($url)
{
die("Method HtmlHelper::javascriptIncludeTag() was moved to JavascriptHelper::link().");
}
/**
* @deprecated Moved to JavascriptHelper. Version 0.9.2.
*/
function javascriptTag($script)
{
die("Method HtmlHelper::javascriptTag() was moved to JavascriptHelper::codeBlock().");
}
/*************************************************************************
* Deprecated methods
*************************************************************************/
/**
* Returns an HTML FORM element.
*
* @param string $target URL for the FORM's ACTION attribute.
* @param string $type FORM type (POST/GET).
* @param array $htmlAttributes
* @return string An formatted opening FORM tag.
* @deprecated This is very WYSIWYG unfriendly, use HtmlHelper::url() to get
* contents of "action" attribute. Version 0.9.2.
*/
function formTag($target=null, $type='post', $htmlAttributes=null)
{
$htmlAttributes['action'] = $this->UrlFor($target);
$htmlAttributes['method'] = $type=='get'? 'get': 'post';
$type == 'file'? $htmlAttributes['enctype'] = 'multipart/form-data': null;
return sprintf($this->tags['form'], $this->parseHtmlOptions($htmlAttributes, null, ''));
}
/**
* Generates a nested unordered list tree from an array.
*
* @param array $data
* @param array $htmlAttributes
* @param string $bodyKey
* @param string $childrenKey
* @param boolean $return Wheter this method should return a value
* or output it. This overrides AUTO_OUTPUT.
* @return mixed Either string or boolean value, depends on AUTO_OUTPUT
* and $return. If $this->_crumbs is empty, return null.
* @deprecated This seems useless. Version 0.9.2.
*/
function guiListTree($data, $htmlAttributes = null, $bodyKey = 'body', $childrenKey='children', $return = false)
{
$out = "<ul".$this->_parseAttributes($htmlAttributes).">\n";
foreach ($data as $item)
{
$out .= "<li>{$item[$bodyKey]}</li>\n";
if (isset($item[$childrenKey]) && is_array($item[$childrenKey]) && count($item[$childrenKey]))
{
$out .= $this->guiListTree($item[$childrenKey], $htmlAttributes, $bodyKey, $childrenKey);
}
}
$out .= "</ul>\n";
return $this->output($out, $return);
}
/**
* Returns a mailto: link.
*
* @param string $title Title of the link, or the e-mail address
* (if the same).
* @param string $email E-mail address if different from title.
* @param array $options
* @return string Formatted A tag
* @deprecated This should be done using a content filter. Version 0.9.2.
*/
function linkEmail($title, $email=null, $options=null)
{
// if no $email, then title contains the email.
if (empty($email)) $email = $title;
$match = array();
// does the address contain extra attributes?
preg_match('!^(.*)(\?.*)$!', $email, $match);
// plaintext
if (empty($options['encode']) || !empty($match[2]))
{
return sprintf($this->tags['mailto'], $email, $this->parseHtmlOptions($options), $title);
}
// encoded to avoid spiders
else
{
$email_encoded = null;
for ($ii=0; $ii < strlen($email); $ii++)
{
if(preg_match('!\w!',$email[$ii]))
{
$email_encoded .= '%' . bin2hex($email[$ii]);
}
else
{
$email_encoded .= $email[$ii];
}
}
$title_encoded = null;
for ($ii=0; $ii < strlen($title); $ii++)
{
$title_encoded .= preg_match('/^[A-Za-z0-9]$/', $title[$ii])? '&#x' . bin2hex($title[$ii]).';': $title[$ii];
}
return sprintf($this->tags['mailto'], $email_encoded, $this->parseHtmlOptions($options, array('encode')), $title_encoded);
}
}
/**
* Returns a generic HTML tag (no content).
*
* Examples:
* + <code>tag("br") => <br /></code>
* + <code>tag("input", array("type" => "text")) => <input type="text" /></code>
*
* @param string $name Name of HTML element
* @param array $options HTML options
* @param bool $open Is the tag open or closed? (defaults to closed "/>")
* @return string The formatted HTML tag
* @deprecated This seems useless. Version 0.9.2.
*/
function tag($name, $options=null, $open=false)
{
$tag = "<$name ". $this->parseHtmlOptions($options);
$tag .= $open? ">" : " />";
return $tag;
}
/**
* Returns a generic HTML tag with content.
*
* Examples:
* <code>
* content_tag("p", "Hello world!") => <p>Hello world!</p>
* content_tag("div", content_tag("p", "Hello world!"),
* array("class" => "strong")) => <div class="strong"><p>Hello world!</p></div>
* </code>
*
* @param string $name Name of HTML element
* @param array $options HTML options
* @param bool $open Is the tag open or closed? (defaults to closed "/>")
* @return string The formatted HTML tag
* @deprecated This seems useless. Version 0.9.2.
*/
function contentTag($name, $content, $options=null)
{
return "<$name ". $this->parseHtmlOptions($options). ">$content</$name>";
}
function dayOptionTag( $tagName, $value=null, $selected=null, $optionAttr=null)
{
$value = isset($value)? $value : $this->tagValue($tagName."_day");
$dayValue = empty($value) ? date('d') : $value;
$days=array('1'=>'1','2'=>'2','3'=>'3','4'=>'4',
'5'=>'5','6'=>'6','7'=>'7','8'=>'8','9'=>'9',
'10'=>'10','11'=>'11','12'=>'12',
'13'=>'13','14'=>'14','15'=>'15',
'16'=>'16','17'=>'17','18'=>'18',
'19'=>'19','20'=>'20','21'=>'21',
'22'=>'22','23'=>'23','24'=>'24',
'25'=>'25','26'=>'26','27'=>'27',
'28'=>'28','29'=>'29','30'=>'30','31'=>'31');
$option = $this->selectTag($tagName.'_day', $days, $dayValue,
$optionAttr);
return $option;
}
function yearOptionTag( $tagName, $value=null, $minYear=null, $maxYear=null, $selected=null, $optionAttr=null)
{
$value = isset($value)? $value : $this->tagValue($tagName."_year");
$yearValue = empty($value) ? date('Y') : $value;
$maxYear = is_null($maxYear) ? $yearValue + 10 : $maxYear;
$minYear = is_null($minYear) ? $yearValue - 10 : $minYear;
if ( $minYear>$minYear)
{
$tmpYear = $minYear;
$minYear = $maxYear;
$maxYear = $tmpYear;
};
$minYear = $yearValue < $minYear ? $yearValue : $minYear;
$maxYear = $yearValue > $maxYear ? $yearValue : $maxYear;
for ( $yearCounter=$minYear; $yearCounter<$maxYear; $yearCounter++)
{
$years[$yearCounter]=$yearCounter;
}
$option = $this->selectTag($tagName.'_year', $years, $yearValue,
$optionAttr);
return $option;
}
function monthOptionTag( $tagName, $value=null, $selected=null, $optionAttr=null)
{
$value = isset($value)? $value : $this->tagValue($tagName."_month");
$monthValue = empty($value) ? date('m') : $value ;
$months=array('1'=>'January','2'=>'February','3'=>'March',
'4'=>'April','5'=>'May','6'=>'June','7'=>'July','8'=>'August',
'9'=>'September','10'=>'October','11'=>'November','12'=>'December');
$option = $this->selectTag($tagName.'_month', $months, $monthValue,
$optionAttr);
return $option;
}
function hourOptionTag( $tagName,$value=null,
$format24Hours = false,
$selected=null,
$optionAttr=null )
{
$value = isset($value)? $value : $this->tagValue($tagName."_hour");
if ( $format24Hours )
{
$hourValue = empty($value) ? date('H') : $value;
}
else
{
$hourValue = empty($value) ? date('g') : $value;
}
if ( $format24Hours )
{ $hours = array('0'=>'00','1'=>'01','2'=>'02','3'=>'03','4'=>'04',
'5'=>'05','6'=>'06','7'=>'07','8'=>'08','9'=>'09',
'10'=>'10','11'=>'11','12'=>'12',
'13'=>'13','14'=>'14','15'=>'15',
'16'=>'16','17'=>'17','18'=>'18',
'19'=>'19','20'=>'20','21'=>'21',
'22'=>'22','23'=>'23');
}
else
{
$hours = array('1'=>'1','2'=>'2','3'=>'3','4'=>'4',
'5'=>'5','6'=>'6','7'=>'7','8'=>'8','9'=>'9',
'10'=>'10','11'=>'11','12'=>'12');
}
$option = $this->selectTag($tagName.'_hour', $hours, $hourValue,
$optionAttr);
return $option;
}
function minuteOptionTag( $tagName, $value=null, $selected=null, $optionAttr=null)
{
$value = isset($value)? $value : $this->tagValue($tagName."_min");
$minValue = empty($value) ? date('i') : $value ;
for( $minCount=0; $minCount<61; $minCount++)
{
$mins[$minCount] = sprintf('%02d', $minCount);
}
$option = $this->selectTag($tagName.'_min', $mins, $minValue,
$optionAttr);
return $option;
}
function meridianOptionTag( $tagName, $value=null, $selected=null, $optionAttr=null)
{
$value = isset($value)? $value : $this->tagValue($tagName."_meridian");
$merValue = empty($value) ? date('a') : $value ;
$meridians = array('am'=>'am','pm'=>'pm');
$option = $this->selectTag($tagName.'_meridian', $meridians, $merValue,
$optionAttr);
return $option;
}
function dateTimeOptionTag( $tagName, $dateFormat = 'DMY', $timeFormat = '12',$selected=null, $optionAttr=null)
{
switch ( $dateFormat )
{
case 'DMY' :
$opt = $this->dayOptionTag( $tagName ) . '-' . $this->monthOptionTag( $tagName ) . '-' . $this->yearOptionTag( $tagName );
break;
case 'MDY' :
$opt = $this->monthOptionTag( $tagName ) .'-'.$this->dayOptionTag( $tagName ) . '-' . $this->yearOptionTag($tagName);
break;
case 'YMD' :
$opt = $this->yearOptionTag($tagName) . '-' . $this->monthOptionTag( $tagName ) . '-' . $this->dayOptionTag( $tagName );
break;
case 'NONE':
$opt ='';
break;
default:
$opt = '';
break;
}
switch ($timeFormat)
{
case '24':
$opt .= $this->hourOptionTag( $tagName, null , true ) . ':' . $this->minuteOptionTag( $tagName );
break;
case '12':
$opt .= $this->hourOptionTag( $tagName ) . ':' . $this->minuteOptionTag( $tagName ) . ' ' . $this->meridianOptionTag($tagName);
break;
case 'NONE':
$opt .='';
break;
default :
break;
}
return $opt;
}
}
?>
Reference in a new issue View git blame Copy permalink