array('type'=> 'string', 'length'=> 100), * primaryKey and validates array('field_name') * * @access public */ var $fieldset = array('fields' => array(), 'key' => 'id', 'validates' => array()); /** * Options used by DateTime fields * * @var array */ var $__options = array( 'day' => array(), 'minute' => array(), 'hour' => array(), 'month' => array(), 'year' => array(), 'meridian' => array() ); /** * List of fields created, used with secure forms. * * @var array * @access public */ var $fields = array(); /** * Defines the type of form being created. Set by FormHelper::create(). * * @var string * @access public */ var $requestType = null; /** * Returns an HTML FORM element. * * Options: * * - 'type' Form method defaults to POST * - 'action' The Action the form submits to. Can be a string or array, * - 'url' The url the form submits to. Can be a string or a url array, * - 'default' Allows for the creation of Ajax forms. * - 'onsubmit' Used in conjunction with 'default' to create ajax forms. * * @access public * @param string $model The model object which the form is being defined for * @param array $options An array of html attributes and options. * @return string An formatted opening FORM tag. */ function create($model = null, $options = array()) { $defaultModel = null; $view =& ClassRegistry::getObject('view'); if (is_array($model) && empty($options)) { $options = $model; $model = null; } if (empty($model) && $model !== false && !empty($this->params['models'])) { $model = $this->params['models'][0]; $defaultModel = $this->params['models'][0]; } elseif (empty($model) && empty($this->params['models'])) { $model = false; } elseif (is_string($model) && strpos($model, '.') !== false) { $path = explode('.', $model); $model = $path[count($path) - 1]; } if (ClassRegistry::isKeySet($model)) { $object =& ClassRegistry::getObject($model); } $models = ClassRegistry::keys(); foreach ($models as $currentModel) { if (ClassRegistry::isKeySet($currentModel)) { $currentObject =& ClassRegistry::getObject($currentModel); if (is_a($currentObject, 'Model') && !empty($currentObject->validationErrors)) { $this->validationErrors[Inflector::camelize($currentModel)] =& $currentObject->validationErrors; } } } $this->setEntity($model . '.', true); $append = ''; $created = $id = false; if (isset($object)) { $fields = $object->schema(); foreach ($fields as $key => $value) { unset($fields[$key]); $fields[$model . '.' . $key] = $value; } if (!empty($object->hasAndBelongsToMany)) { foreach ($object->hasAndBelongsToMany as $alias => $assocData) { $fields[$alias] = array('type' => 'multiple'); } } $validates = array(); if (!empty($object->validate)) { foreach ($object->validate as $validateField => $validateProperties) { if (is_array($validateProperties)) { $dims = Set::countDim($validateProperties); if (($dims == 1 && !isset($validateProperties['required']) || (array_key_exists('required', $validateProperties) && $validateProperties['required'] !== false))) { $validates[] = $validateField; } elseif ($dims > 1) { foreach ($validateProperties as $rule => $validateProp) { if (is_array($validateProp) && (array_key_exists('required', $validateProp) && $validateProp['required'] !== false)) { $validates[] = $validateField; } } } } } } $key = $object->primaryKey; $this->fieldset = compact('fields', 'key', 'validates'); } $data = $this->fieldset; $recordExists = ( isset($this->data[$model]) && isset($this->data[$model][$data['key']]) && !empty($this->data[$model][$data['key']]) ); if ($recordExists) { $created = true; $id = $this->data[$model][$data['key']]; } $options = array_merge(array( 'type' => ($created && empty($options['action'])) ? 'put' : 'post', 'action' => null, 'url' => null, 'default' => true), $options); if (empty($options['url']) || is_array($options['url'])) { if (empty($options['url']['controller'])) { if (!empty($model) && $model != $defaultModel) { $options['url']['controller'] = Inflector::underscore(Inflector::pluralize($model)); } elseif (!empty($this->params['controller'])) { $options['url']['controller'] = Inflector::underscore($this->params['controller']); } } if (empty($options['action'])) { $options['action'] = ($created) ? 'edit' : 'add'; } $actionDefaults = array( 'plugin' => $this->plugin, 'controller' => $view->viewPath, 'action' => $options['action'], 'id' => $id ); if (!empty($options['action']) && !isset($options['id'])) { $options['id'] = $model . Inflector::camelize($options['action']) . 'Form'; } $options['action'] = array_merge($actionDefaults, (array)$options['url']); } elseif (is_string($options['url'])) { $options['action'] = $options['url']; } unset($options['url']); switch (strtolower($options['type'])) { case 'get': $htmlAttributes['method'] = 'get'; break; case 'file': $htmlAttributes['enctype'] = 'multipart/form-data'; $options['type'] = ($created) ? 'put' : 'post'; case 'post': case 'put': case 'delete': $append .= $this->hidden('_method', array( 'name' => '_method', 'value' => strtoupper($options['type']), 'id' => null )); default: $htmlAttributes['method'] = 'post'; break; } $this->requestType = strtolower($options['type']); $htmlAttributes['action'] = $this->url($options['action']); unset($options['type'], $options['action']); if ($options['default'] == false) { if (isset($htmlAttributes['onSubmit']) || isset($htmlAttributes['onsubmit'])) { $htmlAttributes['onsubmit'] .= ' event.returnValue = false; return false;'; } else { $htmlAttributes['onsubmit'] = 'event.returnValue = false; return false;'; } } unset($options['default']); $htmlAttributes = array_merge($options, $htmlAttributes); if (isset($this->params['_Token']) && !empty($this->params['_Token'])) { $append .= $this->hidden('_Token.key', array( 'value' => $this->params['_Token']['key'], 'id' => 'Token' . mt_rand()) ); } if (!empty($append)) { $append = sprintf($this->Html->tags['fieldset'], ' style="display:none;"', $append); } $this->setEntity($model . '.', true); $attributes = $this->_parseAttributes($htmlAttributes, null, ''); return $this->output(sprintf($this->Html->tags['form'], $attributes)) . $append; } /** * Closes an HTML form, cleans up values set by FormHelper::create(), and writes hidden * input fields where appropriate. * * If $options is set a form submit button will be created. * * @param mixed $options as a string will use $options as the value of button, * array usage: * array('label' => 'save'); value="save" * array('label' => 'save', 'name' => 'Whatever'); value="save" name="Whatever" * array('name' => 'Whatever'); value="Submit" name="Whatever" * array('label' => 'save', 'name' => 'Whatever', 'div' => 'good')
value="save" name="Whatever" * array('label' => 'save', 'name' => 'Whatever', 'div' => array('class' => 'good'));
value="save" name="Whatever" * * @return string a closing FORM tag optional submit button. * @access public */ function end($options = null) { if (!empty($this->params['models'])) { $models = $this->params['models'][0]; } $out = null; $submit = null; if ($options !== null) { $submitOptions = array(); if (is_string($options)) { $submit = $options; } else { if (isset($options['label'])) { $submit = $options['label']; unset($options['label']); } $submitOptions = $options; if (!$submit) { $submit = __('Submit', true); } } $out .= $this->submit($submit, $submitOptions); } if (isset($this->params['_Token']) && !empty($this->params['_Token'])) { $out .= $this->secure($this->fields); $this->fields = array(); } $this->setEntity(null); $out .= $this->Html->tags['formend']; $view =& ClassRegistry::getObject('view'); $view->modelScope = false; return $this->output($out); } /** * Generates a hidden field with a security hash based on the fields used in the form. * * @param array $fields The list of fields to use when generating the hash * @return string A hidden input field with a security hash * @access public */ function secure($fields = array()) { if (!isset($this->params['_Token']) || empty($this->params['_Token'])) { return; } $out = '
'; $locked = array(); foreach ($fields as $key => $value) { if (!is_int($key)) { $locked[$key] = $value; unset($fields[$key]); } } sort($fields, SORT_STRING); ksort($locked, SORT_STRING); $fields += $locked; $fields = Security::hash(serialize($fields) . Configure::read('Security.salt')); $locked = str_rot13(serialize(array_keys($locked))); $out .= $this->hidden('_Token.fields', array( 'value' => urlencode($fields . ':' . $locked), 'id' => 'TokenFields' . mt_rand() )); return $out .= '
'; } /** * Determine which fields of a form should be used for hash * * @param mixed $field Reference to field to be secured * @param mixed $value Field value, if value should not be tampered with * @access private */ function __secure($field = null, $value = null) { if (!$field) { $view =& ClassRegistry::getObject('view'); $field = $view->entity(); } elseif (is_string($field)) { $field = Set::filter(explode('.', $field), true); } if (!empty($this->params['_Token']['disabledFields'])) { foreach ((array)$this->params['_Token']['disabledFields'] as $disabled) { $disabled = explode('.', $disabled); if (array_values(array_intersect($field, $disabled)) === $disabled) { return; } } } $field = join('.', $field); if (!in_array($field, $this->fields)) { if ($value !== null) { return $this->fields[$field] = $value; } $this->fields[] = $field; } } /** * Returns true if there is an error for the given field, otherwise false * * @param string $field This should be "Modelname.fieldname" * @return boolean If there are errors this method returns true, else false. * @access public */ function isFieldError($field) { $this->setEntity($field); return (bool)$this->tagIsInvalid(); } /** * Returns a formatted error message for given FORM field, NULL if no errors. * * Options: * * - 'escape' bool Whether or not to html escape the contents of the error. * - 'wrap' mixed Whether or not the error message should be wrapped in a div. If a * string, will be used as the HTML tag to use. * - 'class' string The classname for the error message * * @param string $field A field name, like "Modelname.fieldname" * @param mixed $text Error message or array of $options * @param array $options Rendering options for
wrapper tag * @return string If there are errors this method returns an error message, otherwise null. * @access public */ function error($field, $text = null, $options = array()) { $defaults = array('wrap' => true, 'class' => 'error-message', 'escape' => true); $options = array_merge($defaults, $options); $this->setEntity($field); if ($error = $this->tagIsInvalid()) { if (is_array($error)) { list(,,$field) = explode('.', $field); if (isset($error[$field])) { $error = $error[$field]; } else { return null; } } if (is_array($text) && is_numeric($error) && $error > 0) { $error--; } if (is_array($text) && isset($text[$error])) { $text = $text[$error]; } elseif (is_array($text)) { $options = array_merge($options, $text); $text = null; } if ($text != null) { $error = $text; } elseif (is_numeric($error)) { $error = sprintf(__('Error in field %s', true), Inflector::humanize($this->field())); } if ($options['escape']) { $error = h($error); unset($options['escape']); } if ($options['wrap']) { $tag = is_string($options['wrap']) ? $options['wrap'] : 'div'; unset($options['wrap']); return $this->Html->tag($tag, $error, $options); } else { return $error; } } else { return null; } } /** * Returns a formatted LABEL element for HTML FORMs. * * @param string $fieldName This should be "Modelname.fieldname" * @param string $text Text that will appear in the label field. * @param array $attributes Array of HTML attributes. * @return string The formatted LABEL element */ function label($fieldName = null, $text = null, $attributes = array()) { if (empty($fieldName)) { $view = ClassRegistry::getObject('view'); $fieldName = implode('.', $view->entity()); } if ($text === null) { if (strpos($fieldName, '.') !== false) { $text = array_pop(explode('.', $fieldName)); } else { $text = $fieldName; } if (substr($text, -3) == '_id') { $text = substr($text, 0, strlen($text) - 3); } $text = __(Inflector::humanize(Inflector::underscore($text)), true); } if (isset($attributes['for'])) { $labelFor = $attributes['for']; unset($attributes['for']); } else { $labelFor = $this->domId($fieldName); } return $this->output(sprintf( $this->Html->tags['label'], $labelFor, $this->_parseAttributes($attributes), $text )); } /** * Will display all the fields passed in an array expects fieldName as an array key * replaces generateFields * * @access public * @param array $fields works well with Controller::generateFields() or on its own; * @param array $blacklist a simple array of fields to skip * @return output */ function inputs($fields = null, $blacklist = null) { $fieldset = $legend = true; if (is_array($fields)) { if (array_key_exists('legend', $fields)) { $legend = $fields['legend']; unset($fields['legend']); } if (isset($fields['fieldset'])) { $fieldset = $fields['fieldset']; unset($fields['fieldset']); } } elseif ($fields !== null) { $fieldset = $legend = $fields; if (!is_bool($fieldset)) { $fieldset = true; } $fields = array(); } if (empty($fields)) { $fields = array_keys($this->fieldset['fields']); } if ($legend === true) { $actionName = __('New', true); $isEdit = ( strpos($this->action, 'update') !== false || strpos($this->action, 'edit') !== false ); if ($isEdit) { $actionName = __('Edit', true); } $modelName = Inflector::humanize(Inflector::underscore($this->model())); $legend = $actionName .' '. __($modelName, true); } $out = null; foreach ($fields as $name => $options) { if (is_numeric($name) && !is_array($options)) { $name = $options; $options = array(); } $entity = explode('.', $name); $blacklisted = ( is_array($blacklist) && (in_array($name, $blacklist) || in_array(end($entity), $blacklist)) ); if ($blacklisted) { continue; } $out .= $this->input($name, $options); } if (is_string($fieldset)) { $fieldsetClass = sprintf(' class="%s"', $fieldset); } else { $fieldsetClass = ''; } if ($fieldset && $legend) { return sprintf( $this->Html->tags['fieldset'], $fieldsetClass, sprintf($this->Html->tags['legend'], $legend) . $out ); } elseif ($fieldset) { return sprintf($this->Html->tags['fieldset'], $fieldsetClass, $out); } else { return $out; } } /** * Generates a form input element complete with label and wrapper div * * Options - See each field type method for more information. Any options that are part of * $attributes or $options for the different type methods can be included in $options for input(). * * - 'type' - Force the type of widget you want. e.g. ```type => 'select'``` * - 'label' - control the label * - 'div' - control the wrapping div element * - 'options' - for widgets that take options e.g. radio, select * - 'error' - control the error message that is produced * * @param string $fieldName This should be "Modelname.fieldname" * @param array $options Each type of input takes different options. * @return string Completed form widget */ function input($fieldName, $options = array()) { $view =& ClassRegistry::getObject('view'); $this->setEntity($fieldName); $entity = join('.', $view->entity()); $defaults = array('before' => null, 'between' => null, 'after' => null); $options = array_merge($defaults, $options); if (!isset($options['type'])) { $options['type'] = 'text'; if (isset($options['options'])) { $options['type'] = 'select'; } elseif (in_array($this->field(), array('psword', 'passwd', 'password'))) { $options['type'] = 'password'; } elseif (isset($this->fieldset['fields'][$entity])) { $fieldDef = $this->fieldset['fields'][$entity]; $type = $fieldDef['type']; $primaryKey = $this->fieldset['key']; } elseif (ClassRegistry::isKeySet($this->model())) { $model =& ClassRegistry::getObject($this->model()); $type = $model->getColumnType($this->field()); $fieldDef = $model->schema(); if (isset($fieldDef[$this->field()])) { $fieldDef = $fieldDef[$this->field()]; } else { $fieldDef = array(); } $primaryKey = $model->primaryKey; } if (isset($type)) { $map = array( 'string' => 'text', 'datetime' => 'datetime', 'boolean' => 'checkbox', 'timestamp' => 'datetime', 'text' => 'textarea', 'time' => 'time', 'date' => 'date', 'float' => 'text' ); if (isset($this->map[$type])) { $options['type'] = $this->map[$type]; } elseif (isset($map[$type])) { $options['type'] = $map[$type]; } if ($this->field() == $primaryKey) { $options['type'] = 'hidden'; } } if ($this->model() === $this->field()) { $options['type'] = 'select'; if (!isset($options['multiple'])) { $options['multiple'] = 'multiple'; } } } $types = array('text', 'checkbox', 'radio', 'select'); if (!isset($options['options']) && in_array($options['type'], $types)) { $view =& ClassRegistry::getObject('view'); $varName = Inflector::variable( Inflector::pluralize(preg_replace('/_id$/', '', $this->field())) ); $varOptions = $view->getVar($varName); if (is_array($varOptions)) { if ($options['type'] !== 'radio') { $options['type'] = 'select'; } $options['options'] = $varOptions; } } $autoLength = (!array_key_exists('maxlength', $options) && isset($fieldDef['length'])); if ($autoLength && $options['type'] == 'text') { $options['maxlength'] = $fieldDef['length']; } if ($autoLength && $fieldDef['type'] == 'float') { $options['maxlength'] = array_sum(explode(',', $fieldDef['length']))+1; } $out = ''; $div = true; $divOptions = array(); if (array_key_exists('div', $options)) { $div = $options['div']; unset($options['div']); } if (!empty($div)) { $divOptions['class'] = 'input'; $divOptions = $this->addClass($divOptions, $options['type']); if (is_string($div)) { $divOptions['class'] = $div; } elseif (is_array($div)) { $divOptions = array_merge($divOptions, $div); } if (in_array($this->field(), $this->fieldset['validates'])) { $divOptions = $this->addClass($divOptions, 'required'); } if (!isset($divOptions['tag'])) { $divOptions['tag'] = 'div'; } } $label = null; if (isset($options['label']) && $options['type'] !== 'radio') { $label = $options['label']; unset($options['label']); } if ($options['type'] === 'radio') { $label = false; if (isset($options['options'])) { if (is_array($options['options'])) { $radioOptions = $options['options']; } else { $radioOptions = array($options['options']); } unset($options['options']); } } if ($label !== false) { $labelAttributes = $this->domId(array(), 'for'); if (in_array($options['type'], array('date', 'datetime'))) { $labelAttributes['for'] .= 'Month'; } else if ($options['type'] === 'time') { $labelAttributes['for'] .= 'Hour'; } if (is_array($label)) { $labelText = null; if (isset($label['text'])) { $labelText = $label['text']; unset($label['text']); } $labelAttributes = array_merge($labelAttributes, $label); } else { $labelText = $label; } if (isset($options['id'])) { $labelAttributes = array_merge($labelAttributes, array('for' => $options['id'])); } $out = $this->label($fieldName, $labelText, $labelAttributes); } $error = null; if (isset($options['error'])) { $error = $options['error']; unset($options['error']); } $selected = null; if (array_key_exists('selected', $options)) { $selected = $options['selected']; unset($options['selected']); } if (isset($options['rows']) || isset($options['cols'])) { $options['type'] = 'textarea'; } $empty = false; if (isset($options['empty'])) { $empty = $options['empty']; unset($options['empty']); } $timeFormat = 12; if (isset($options['timeFormat'])) { $timeFormat = $options['timeFormat']; unset($options['timeFormat']); } $dateFormat = 'MDY'; if (isset($options['dateFormat'])) { $dateFormat = $options['dateFormat']; unset($options['dateFormat']); } $type = $options['type']; $before = $options['before']; $between = $options['between']; $after = $options['after']; unset($options['type'], $options['before'], $options['between'], $options['after']); switch ($type) { case 'hidden': $out = $this->hidden($fieldName, $options); unset($divOptions); break; case 'checkbox': $out = $before . $this->checkbox($fieldName, $options) . $between . $out; break; case 'radio': $out = $before . $out . $this->radio($fieldName, $radioOptions, $options) . $between; break; case 'text': case 'password': $out = $before . $out . $between . $this->{$type}($fieldName, $options); break; case 'file': $out = $before . $out . $between . $this->file($fieldName, $options); break; case 'select': $options = array_merge(array('options' => array()), $options); $list = $options['options']; unset($options['options']); $out = $before . $out . $between . $this->select( $fieldName, $list, $selected, $options, $empty ); break; case 'time': $out = $before . $out . $between . $this->dateTime( $fieldName, null, $timeFormat, $selected, $options, $empty ); break; case 'date': $out = $before . $out . $between . $this->dateTime( $fieldName, $dateFormat, null, $selected, $options, $empty ); break; case 'datetime': $out = $before . $out . $between . $this->dateTime( $fieldName, $dateFormat, $timeFormat, $selected, $options, $empty ); break; case 'textarea': default: $out = $before . $out . $between . $this->textarea($fieldName, array_merge( array('cols' => '30', 'rows' => '6'), $options )); break; } if ($type != 'hidden') { $out .= $after; if ($error !== false) { $errMsg = $this->error($fieldName, $error); if ($errMsg) { $out .= $errMsg; $divOptions = $this->addClass($divOptions, 'error'); } } } if (isset($divOptions) && isset($divOptions['tag'])) { $tag = $divOptions['tag']; unset($divOptions['tag']); $out = $this->Html->tag($tag, $out, $divOptions); } return $out; } /** * Creates a checkbox input widget. * * Options: * * - 'value' - the value of the checkbox * - checked' - boolean indicate that this checkbox is checked. * * @param string $fieldName Name of a field, like this "Modelname.fieldname" * @param array $options Array of HTML attributes. * @todo Right now, automatically setting the 'checked' value is dependent on whether or not the * checkbox is bound to a model. This should probably be re-evaluated in future versions. * @return string An HTML text input element */ function checkbox($fieldName, $options = array()) { $options = $this->_initInputField($fieldName, $options); $value = current($this->value()); if (!isset($options['value']) || empty($options['value'])) { $options['value'] = 1; } elseif (!empty($value) && $value === $options['value']) { $options['checked'] = 'checked'; } $hiddenOptions = array( 'id' => $options['id'] . '_', 'name' => $options['name'], 'value' => '0', 'secure' => false ); if (isset($options['disabled']) && $options['disabled'] == true) { $hiddenOptions['disabled'] = 'disabled'; } $output = $this->hidden($fieldName, $hiddenOptions); return $this->output($output . sprintf( $this->Html->tags['checkbox'], $options['name'], $this->_parseAttributes($options, array('name'), null, ' ') )); } /** * Creates a set of radio widgets. * * Attributes: * * - 'separator' - define the string in between the radio buttons * - 'legend' - control whether or not the widget set has a fieldset & legend * - 'value' - indicate a value that is should be checked * - 'label' - boolean to indicate whether or not labels for widgets show be displayed * * @param string $fieldName Name of a field, like this "Modelname.fieldname" * @param array $options Radio button options array. * @param array $attributes Array of HTML attributes. * @return string */ function radio($fieldName, $options = array(), $attributes = array()) { $attributes = $this->_initInputField($fieldName, $attributes); $legend = false; if (isset($attributes['legend'])) { $legend = $attributes['legend']; unset($attributes['legend']); } elseif (count($options) > 1) { $legend = __(Inflector::humanize($this->field()), true); } $label = true; if (isset($attributes['label'])) { $label = $attributes['label']; unset($attributes['label']); } $inbetween = null; if (isset($attributes['separator'])) { $inbetween = $attributes['separator']; unset($attributes['separator']); } if (isset($attributes['value'])) { $value = $attributes['value']; } else { $value = $this->value($fieldName); } $out = array(); foreach ($options as $optValue => $optTitle) { $optionsHere = array('value' => $optValue); if (isset($value) && $optValue == $value) { $optionsHere['checked'] = 'checked'; } $parsedOptions = $this->_parseAttributes( array_merge($attributes, $optionsHere), array('name', 'type', 'id'), '', ' ' ); $tagName = Inflector::camelize( $attributes['id'] . '_' . Inflector::underscore($optValue) ); if ($label) { $optTitle = sprintf($this->Html->tags['label'], $tagName, null, $optTitle); } $out[] = sprintf( $this->Html->tags['radio'], $attributes['name'], $tagName, $parsedOptions, $optTitle ); } $hidden = null; if (!isset($value) || $value === '') { $hidden = $this->hidden($fieldName, array( 'id' => $attributes['id'] . '_', 'value' => '', 'name' => $attributes['name'] )); } $out = $hidden . join($inbetween, $out); if ($legend) { $out = sprintf( $this->Html->tags['fieldset'], '', sprintf($this->Html->tags['legend'], $legend) . $out ); } return $this->output($out); } /** * Creates a text input widget. * * @param string $fieldName Name of a field, in the form "Modelname.fieldname" * @param array $options Array of HTML attributes. * @return string An HTML text input element */ function text($fieldName, $options = array()) { $options = $this->_initInputField($fieldName, array_merge( array('type' => 'text'), $options )); return $this->output(sprintf( $this->Html->tags['input'], $options['name'], $this->_parseAttributes($options, array('name'), null, ' ') )); } /** * Creates a password input widget. * * @param string $fieldName Name of a field, like in the form "Modelname.fieldname" * @param array $options Array of HTML attributes. * @return string */ function password($fieldName, $options = array()) { $options = $this->_initInputField($fieldName, $options); return $this->output(sprintf( $this->Html->tags['password'], $options['name'], $this->_parseAttributes($options, array('name'), null, ' ') )); } /** * Creates a textarea widget. * * @param string $fieldName Name of a field, in the form "Modelname.fieldname" * @param array $options Array of HTML attributes. * @return string An HTML text input element */ function textarea($fieldName, $options = array()) { $options = $this->_initInputField($fieldName, $options); $value = null; if (array_key_exists('value', $options)) { $value = $options['value']; if (!array_key_exists('escape', $options) || $options['escape'] !== false) { $value = h($value); } unset($options['value']); } return $this->output(sprintf( $this->Html->tags['textarea'], $options['name'], $this->_parseAttributes($options, array('type', 'name'), null, ' '), $value )); } /** * Creates a hidden input field. * * @param string $fieldName Name of a field, in the form"Modelname.fieldname" * @param array $options Array of HTML attributes. * @return string * @access public */ function hidden($fieldName, $options = array()) { $secure = true; if (isset($options['secure'])) { $secure = $options['secure']; unset($options['secure']); } $options = $this->_initInputField($fieldName, array_merge( $options, array('secure' => false) )); $model = $this->model(); if ($fieldName !== '_method' && $model !== '_Token' && $secure) { $this->__secure(null, '' . $options['value']); } return $this->output(sprintf( $this->Html->tags['hidden'], $options['name'], $this->_parseAttributes($options, array('name', 'class'), '', ' ') )); } /** * Creates file input widget. * * @param string $fieldName Name of a field, in the form "Modelname.fieldname" * @param array $options Array of HTML attributes. * @return string * @access public */ function file($fieldName, $options = array()) { $options = array_merge($options, array('secure' => false)); $options = $this->_initInputField($fieldName, $options); $view =& ClassRegistry::getObject('view'); $field = $view->entity(); foreach (array('name', 'type', 'tmp_name', 'error', 'size') as $suffix) { $this->__secure(array_merge($field, array($suffix))); } $attributes = $this->_parseAttributes($options, array('name'), '', ' '); return $this->output(sprintf($this->Html->tags['file'], $options['name'], $attributes)); } /** * Creates a button tag. * * @param string $title The button's caption * @param array $options Array of options. * @return string A HTML button tag. * @access public */ function button($title, $options = array()) { $options = array_merge(array('type' => 'button', 'value' => $title), $options); if (isset($options['name']) && strpos($options['name'], '.') !== false) { if ($this->value($options['name'])) { $options['checked'] = 'checked'; } $name = $options['name']; unset($options['name']); $options = $this->_initInputField($name, $options); } return $this->output(sprintf( $this->Html->tags['button'], $options['type'], $this->_parseAttributes($options, array('type'), '', ' ') )); } /** * Creates a submit button element. * * @param string $caption The label appearing on the button OR if string contains :// or the * extension .jpg, .jpe, .jpeg, .gif, .png use an image if the extension * exists, AND the first character is /, image is relative to webroot, * OR if the first character is not /, image is relative to webroot/img. * @param array $options * @return string A HTML submit button */ function submit($caption = null, $options = array()) { if (!$caption) { $caption = __('Submit', true); } $out = null; $div = true; if (isset($options['div'])) { $div = $options['div']; unset($options['div']); } $divOptions = array('tag' => 'div'); if ($div === true) { $divOptions['class'] = 'submit'; } elseif ($div === false) { unset($divOptions); } elseif (is_string($div)) { $divOptions['class'] = $div; } elseif (is_array($div)) { $divOptions = array_merge(array('class' => 'submit', 'tag' => 'div'), $div); } if (strpos($caption, '://') !== false) { $out .= $this->output(sprintf( $this->Html->tags['submitimage'], $caption, $this->_parseAttributes($options, null, '', ' ') )); } elseif (preg_match('/\.(jpg|jpe|jpeg|gif|png|ico)$/', $caption)) { if ($caption{0} !== '/') { $url = $this->webroot(IMAGES_URL . $caption); } else { $caption = trim($caption, '/'); $url = $this->webroot($caption); } $out .= $this->output(sprintf( $this->Html->tags['submitimage'], $url, $this->_parseAttributes($options, null, '', ' ') )); } else { $options['value'] = $caption; $out .= $this->output(sprintf( $this->Html->tags['submit'], $this->_parseAttributes($options, null, '', ' ') )); } if (isset($divOptions)) { $tag = $divOptions['tag']; unset($divOptions['tag']); $out = $this->Html->tag($tag, $out, $divOptions); } return $out; } /** * Returns a formatted SELECT element. * * Attributes: * * - 'showParents' - If included in the array and set to true, an additional option element * will be added for the parent of each option group. * - 'multiple' - show a multiple select box. If set to 'checkbox' multiple checkboxes will be * created instead. * * @param string $fieldName Name attribute of the SELECT * @param array $options Array of the OPTION elements (as 'value'=>'Text' pairs) to be used in the * SELECT element * @param mixed $selected The option selected by default. If null, the default value * from POST data will be used when available. * @param array $attributes The HTML attributes of the select element. * @param mixed $showEmpty If true, the empty select option is shown. If a string, * that string is displayed as the empty element. * @return string Formatted SELECT element */ function select($fieldName, $options = array(), $selected = null, $attributes = array(), $showEmpty = '') { $select = array(); $showParents = false; $escapeOptions = true; $style = null; $tag = null; if (isset($attributes['escape'])) { $escapeOptions = $attributes['escape']; unset($attributes['escape']); } $attributes = $this->_initInputField($fieldName, array_merge( (array)$attributes, array('secure' => false) )); if (is_string($options) && isset($this->__options[$options])) { $options = $this->__generateOptions($options); } elseif (!is_array($options)) { $options = array(); } if (isset($attributes['type'])) { unset($attributes['type']); } if (in_array('showParents', $attributes)) { $showParents = true; unset($attributes['showParents']); } if (!isset($selected)) { $selected = $attributes['value']; } if (isset($attributes) && array_key_exists('multiple', $attributes)) { $style = ($attributes['multiple'] === 'checkbox') ? 'checkbox' : null; $template = ($style) ? 'checkboxmultiplestart' : 'selectmultiplestart'; $tag = $this->Html->tags[$template]; $select[] = $this->hidden(null, array('value' => '', 'id' => null, 'secure' => false)); } else { $tag = $this->Html->tags['selectstart']; } if (!empty($tag) || isset($template)) { $this->__secure(); $select[] = sprintf($tag, $attributes['name'], $this->_parseAttributes( $attributes, array('name', 'value')) ); } $emptyMulti = ( $showEmpty !== null && $showEmpty !== false && !( empty($showEmpty) && (isset($attributes) && array_key_exists('multiple', $attributes)) ) ); if ($emptyMulti) { $showEmpty = ($showEmpty === true) ? '' : $showEmpty; $options = array_reverse($options, true); $options[''] = $showEmpty; $options = array_reverse($options, true); } $select = array_merge($select, $this->__selectOptions( array_reverse($options, true), $selected, array(), $showParents, array('escape' => $escapeOptions, 'style' => $style) )); $template = ($style == 'checkbox') ? 'checkboxmultipleend' : 'selectend'; $select[] = $this->Html->tags[$template]; return $this->output(implode("\n", $select)); } /** * Returns a SELECT element for days. * * @param string $fieldName Prefix name for the SELECT element * @param string $selected Option which is selected. * @param array $attributes HTML attributes for the select element * @param mixed $showEmpty Show/hide the empty select option * @return string */ function day($fieldName, $selected = null, $attributes = array(), $showEmpty = true) { if ((empty($selected) || $selected === true) && $value = $this->value($fieldName)) { if (is_array($value)) { extract($value); $selected = $day; } else { if (empty($value)) { if (!$showEmpty) { $selected = 'now'; } } else { $selected = $value; } } } if (strlen($selected) > 2) { $selected = date('d', strtotime($selected)); } elseif ($selected === false) { $selected = null; } return $this->select( $fieldName . ".day", $this->__generateOptions('day'), $selected, $attributes, $showEmpty ); } /** * Returns a SELECT element for years * * @param string $fieldName Prefix name for the SELECT element * @param integer $minYear First year in sequence * @param integer $maxYear Last year in sequence * @param string $selected Option which is selected. * @param array $attributes Attribute array for the select elements. * @param boolean $showEmpty Show/hide the empty select option * @return string */ function year($fieldName, $minYear = null, $maxYear = null, $selected = null, $attributes = array(), $showEmpty = true) { if ((empty($selected) || $selected === true) && $value = $this->value($fieldName)) { if (is_array($value)) { extract($value); $selected = $year; } else { if (empty($value)) { if (!$showEmpty && !$maxYear) { $selected = 'now'; } elseif (!$showEmpty && $maxYear && !$selected) { $selected = $maxYear; } } else { $selected = $value; } } } if (strlen($selected) > 4 || $selected === 'now') { $selected = date('Y', strtotime($selected)); } elseif ($selected === false) { $selected = null; } $yearOptions = array('min' => $minYear, 'max' => $maxYear); return $this->select( $fieldName . ".year", $this->__generateOptions('year', $yearOptions), $selected, $attributes, $showEmpty ); } /** * Returns a SELECT element for months. * * Attributes: * * - 'monthNames' is set and false 2 digit numbers will be used instead of text. * * @param string $fieldName Prefix name for the SELECT element * @param string $selected Option which is selected. * @param array $attributes Attributes for the select element * @param boolean $showEmpty Show/hide the empty select option * @return string */ function month($fieldName, $selected = null, $attributes = array(), $showEmpty = true) { if ((empty($selected) || $selected === true) && $value = $this->value($fieldName)) { if (is_array($value)) { extract($value); $selected = $month; } else { if (empty($value)) { if (!$showEmpty) { $selected = 'now'; } } else { $selected = $value; } } } if (strlen($selected) > 2) { $selected = date('m', strtotime($selected)); } elseif ($selected === false) { $selected = null; } $defaults = array('monthNames' => true); $attributes = array_merge($defaults, (array) $attributes); $monthNames = $attributes['monthNames']; unset($attributes['monthNames']); return $this->select( $fieldName . ".month", $this->__generateOptions('month', array('monthNames' => $monthNames)), $selected, $attributes, $showEmpty ); } /** * Returns a SELECT element for hours. * * @param string $fieldName Prefix name for the SELECT element * @param boolean $format24Hours True for 24 hours format * @param string $selected Option which is selected. * @param array $attributes List of HTML attributes * @param mixed $showEmpty True to show an empty element, or a string to provide default empty element text * @return string */ function hour($fieldName, $format24Hours = false, $selected = null, $attributes = array(), $showEmpty = true) { if ((empty($selected) || $selected === true) && $value = $this->value($fieldName)) { if (is_array($value)) { extract($value); $selected = $hour; } else { if (empty($value)) { if (!$showEmpty) { $selected = 'now'; } } else { $selected = $value; } } } else { $value = $selected; } if (strlen($selected) > 2) { if ($format24Hours) { $selected = date('H', strtotime($value)); } else { $selected = date('g', strtotime($value)); } } elseif ($selected === false) { $selected = null; } return $this->select( $fieldName . ".hour", $this->__generateOptions($format24Hours ? 'hour24' : 'hour'), $selected, $attributes, $showEmpty ); } /** * Returns a SELECT element for minutes. * * @param string $fieldName Prefix name for the SELECT element * @param string $selected Option which is selected. * @param string $attributes Array of Attributes * @param bool $showEmpty True to show an empty element, or a string to provide default empty element text * @return string */ function minute($fieldName, $selected = null, $attributes = array(), $showEmpty = true) { if ((empty($selected) || $selected === true) && $value = $this->value($fieldName)) { if (is_array($value)) { extract($value); $selected = $min; } else { if (empty($value)) { if (!$showEmpty) { $selected = 'now'; } } else { $selected = $value; } } } if (strlen($selected) > 2) { $selected = date('i', strtotime($selected)); } elseif ($selected === false) { $selected = null; } $minuteOptions = array(); if (isset($attributes['interval'])) { $minuteOptions['interval'] = $attributes['interval']; unset($attributes['interval']); } return $this->select( $fieldName . ".min", $this->__generateOptions('minute', $minuteOptions), $selected, $attributes, $showEmpty ); } /** * Returns a SELECT element for AM or PM. * * @param string $fieldName Prefix name for the SELECT element * @param string $selected Option which is selected. * @param string $attributes Array of Attributes * @param bool $showEmpty Show/Hide an empty option * @return string */ function meridian($fieldName, $selected = null, $attributes = array(), $showEmpty = true) { if ((empty($selected) || $selected === true) && $value = $this->value($fieldName)) { if (is_array($value)) { extract($value); $selected = $meridian; } else { if (empty($value)) { if (!$showEmpty) { $selected = date('a'); } } else { $selected = date('a', strtotime($value)); } } } if ($selected === false) { $selected = null; } return $this->select( $fieldName . ".meridian", $this->__generateOptions('meridian'), $selected, $attributes, $showEmpty ); } /** * Returns a set of SELECT elements for a full datetime setup: day, month and year, and then time. * * Attributes: * * - 'monthNames' If set and false numbers will be used for month select instead of text. * - 'minYear' The lowest year to use in the year select * - 'maxYear' The maximum year to use in the year select * - 'interval' The interval for the minutes select. Defaults to 1 * - 'separator' The contents of the string between select elements. Defaults to '-' * * @param string $fieldName Prefix name for the SELECT element * @param string $dateFormat DMY, MDY, YMD or NONE. * @param string $timeFormat 12, 24, NONE * @param string $selected Option which is selected. * @param string $attributes array of Attributes * @param bool $showEmpty Whether or not to show an empty default value. * @return string The HTML formatted OPTION element */ function dateTime($fieldName, $dateFormat = 'DMY', $timeFormat = '12', $selected = null, $attributes = array(), $showEmpty = true) { $year = $month = $day = $hour = $min = $meridian = null; if (empty($selected)) { $selected = $this->value($fieldName); } if ($selected === null && $showEmpty != true) { $selected = time(); } if (!empty($selected)) { if (is_array($selected)) { extract($selected); } else { if (is_numeric($selected)) { $selected = strftime('%Y-%m-%d %H:%M:%S', $selected); } $meridian = 'am'; $pos = strpos($selected, '-'); if ($pos !== false) { $date = explode('-', $selected); $days = explode(' ', $date[2]); $day = $days[0]; $month = $date[1]; $year = $date[0]; } else { $days[1] = $selected; } if ($timeFormat != 'NONE' && !empty($timeFormat)) { $time = explode(':', $days[1]); $check = str_replace(':', '', $days[1]); if (($check > 115959) && $timeFormat == '12') { $time[0] = $time[0] - 12; $meridian = 'pm'; } elseif ($time[0] == '00' && $timeFormat == '12') { $time[0] = 12; } elseif ($time[0] > 12) { $meridian = 'pm'; } if ($time[0] == 0 && $timeFormat == '12') { $time[0] = 12; } $hour = $time[0]; $min = $time[1]; } } } $elements = array('Day','Month','Year','Hour','Minute','Meridian'); $defaults = array( 'minYear' => null, 'maxYear' => null, 'separator' => '-', 'interval' => 1, 'monthNames' => true ); $attributes = array_merge($defaults, (array) $attributes); if (isset($attributes['minuteInterval'])) { $attributes['interval'] = $attributes['minuteInterval']; unset($attributes['minuteInterval']); } $minYear = $attributes['minYear']; $maxYear = $attributes['maxYear']; $separator = $attributes['separator']; $interval = $attributes['interval']; $monthNames = $attributes['monthNames']; $attributes = array_diff_key($attributes, $defaults); if (isset($attributes['id'])) { if (is_string($attributes['id'])) { // build out an array version foreach ($elements as $element) { $selectAttrName = 'select' . $element . 'Attr'; ${$selectAttrName} = $attributes; ${$selectAttrName}['id'] = $attributes['id'] . $element; } } elseif (is_array($attributes['id'])) { // check for missing ones and build selectAttr for each element foreach ($elements as $element) { $selectAttrName = 'select' . $element . 'Attr'; ${$selectAttrName} = $attributes; ${$selectAttrName}['id'] = $attributes['id'][strtolower($element)]; } } } else { // build the selectAttrName with empty id's to pass foreach ($elements as $element) { $selectAttrName = 'select' . $element . 'Attr'; ${$selectAttrName} = $attributes; } } $opt = ''; if ($dateFormat != 'NONE') { $selects = array(); foreach (preg_split('//', $dateFormat, -1, PREG_SPLIT_NO_EMPTY) as $char) { switch ($char) { case 'Y': $selects[] = $this->year( $fieldName, $minYear, $maxYear, $year, $selectYearAttr, $showEmpty ); break; case 'M': $selectMonthAttr['monthNames'] = $monthNames; $selects[] = $this->month($fieldName, $month, $selectMonthAttr, $showEmpty); break; case 'D': $selects[] = $this->day($fieldName, $day, $selectDayAttr, $showEmpty); break; } } $opt = implode($separator, $selects); } switch ($timeFormat) { case '24': $selectMinuteAttr['interval'] = $interval; $opt .= $this->hour($fieldName, true, $hour, $selectHourAttr, $showEmpty) . ':' . $this->minute($fieldName, $min, $selectMinuteAttr, $showEmpty); break; case '12': $selectMinuteAttr['interval'] = $interval; $opt .= $this->hour($fieldName, false, $hour, $selectHourAttr, $showEmpty) . ':' . $this->minute($fieldName, $min, $selectMinuteAttr, $showEmpty) . ' ' . $this->meridian($fieldName, $meridian, $selectMeridianAttr, $showEmpty); break; case 'NONE': default: $opt .= ''; break; } return $opt; } /** * Gets the input field name for the current tag * * @param array $options * @param string $key * @return array */ function __name($options = array(), $field = null, $key = 'name') { if ($this->requestType == 'get') { if ($options === null) { $options = array(); } elseif (is_string($options)) { $field = $options; $options = 0; } if (!empty($field)) { $this->setEntity($field); } if (is_array($options) && isset($options[$key])) { return $options; } $name = $this->field(); if (is_array($options)) { $options[$key] = $name; return $options; } else { return $name; } } return parent::__name($options, $field, $key); } /** * Returns an array of formatted OPTION/OPTGROUP elements * @access private * @return array */ function __selectOptions($elements = array(), $selected = null, $parents = array(), $showParents = null, $attributes = array()) { $select = array(); $attributes = array_merge(array('escape' => true, 'style' => null), $attributes); $selectedIsEmpty = ($selected === '' || $selected === null); $selectedIsArray = is_array($selected); foreach ($elements as $name => $title) { $htmlOptions = array(); if (is_array($title) && (!isset($title['name']) || !isset($title['value']))) { if (!empty($name)) { if ($attributes['style'] === 'checkbox') { $select[] = $this->Html->tags['fieldsetend']; } else { $select[] = $this->Html->tags['optiongroupend']; } $parents[] = $name; } $select = array_merge($select, $this->__selectOptions( $title, $selected, $parents, $showParents, $attributes )); if (!empty($name)) { if ($attributes['style'] === 'checkbox') { $select[] = sprintf($this->Html->tags['fieldsetstart'], $name); } else { $select[] = sprintf($this->Html->tags['optiongroup'], $name, ''); } } $name = null; } elseif (is_array($title)) { $htmlOptions = $title; $name = $title['value']; $title = $title['name']; unset($htmlOptions['name'], $htmlOptions['value']); } if ($name !== null) { if ((!$selectedIsEmpty && $selected == $name) || ($selectedIsArray && in_array($name, $selected))) { if ($attributes['style'] === 'checkbox') { $htmlOptions['checked'] = true; } else { $htmlOptions['selected'] = 'selected'; } } if ($showParents || (!in_array($title, $parents))) { $title = ($attributes['escape']) ? h($title) : $title; if ($attributes['style'] === 'checkbox') { $htmlOptions['value'] = $name; $tagName = Inflector::camelize( $this->model() . '_' . $this->field().'_'.Inflector::underscore($name) ); $htmlOptions['id'] = $tagName; $label = array('for' => $tagName); if (isset($htmlOptions['checked']) && $htmlOptions['checked'] === true) { $label['class'] = 'selected'; } list($name) = array_values($this->__name()); if (empty($attributes['class'])) { $attributes['class'] = 'checkbox'; } $label = $this->label(null, $title, $label); $item = sprintf( $this->Html->tags['checkboxmultiple'], $name, $this->_parseAttributes($htmlOptions) ); $select[] = $this->Html->div($attributes['class'], $item . $label); } else { $select[] = sprintf( $this->Html->tags['selectoption'], $name, $this->_parseAttributes($htmlOptions), $title ); } } } } return array_reverse($select, true); } /** * Generates option lists for common