mirror of
https://github.com/kamilwylegala/cakephp2-php8.git
synced 2025-01-19 11:06:15 +00:00
677a39a445
Revision: [1761] Removing old db_acl.sql Revision: [1759] Removed unneeded calls to uses(). Changed basics.php listClasses() no longer using folder class. Starting corrections in DboPostgres class. Adding missing DboPostgres::query(). Added missing doc blocks to AjaxHelper. Fixed undefined keys in FormHelper::generateFields() Reformatted FormHelper::generateFields() adding open and close brackets where needed Revision: [1758] Fixed typo Revision: [1757] Fixed errors found when using PHP 4. Fixed a scaffold error Revision: [1756] Merging changes to model_php4.php Revision: [1755] Fixed scaffolding for the changes made to the model. Fixed Model::isForeignKey(), replaced array_key_exists with in_array, other function was failing Revision: [1754] Committing changes from bundt model to beta. DataSources will not be in the beta release Revision: [1751] Cleaning up a little more in the code. Removing loading of log.php unless it is really needed. Refactored dispatcher to speed up the stripslashes code if it is called Revision: [1748] removing all references to error_messages and deleting the file Revision: [1747] updated more error messages Revision: [1746] removing all error message defines Revision: [1745] added _() method from 1.0 to basics.php only used to return string right now Revision: [1744] Adding fix for ticket #220 Revision: [1743] More work on ErrorHandler class Revision: [1742] Renaming error view for missing database connection Revision: [1741] More work on ErrorHandler class Revision: [1740] More work on error class Revision: [1739] Replacing all $_SERVER variable check with env() in basics.php Revision: [1738] Adding env() to basic Revision: [1737] Updated session to use env() Revision: [1736] Removing ternary operators from Dispatcher Revision: [1735] Per nates request I am rolling back ACL to [1373] Revision: [1734] Removed the IP in the session class this was not very reliable. Added a time setting that generates current time adding the Security::inactiveMins() to the session Removed code that was added to basics.php to replace gethostbyaddr(). Added CAKE_SESSION_STRING define to core.php which is used in the by the Session class to generate a hashed key. Revision: [1733] Moving errors messages to ErrorHandler class. Updating errors view for use with new class. Updating Scaffold to use new class. Updated Dispatcher to use new class. Removing methods from Object class Revision: [1732] Adding ErrorHandler class Revision: [1731] Adding fix for Ticket #223 git-svn-id: https://svn.cakephp.org/repo/trunk/cake@1762 3807eeeb-6ff5-0310-8944-8be069107fe0
477 lines
No EOL
18 KiB
PHP
477 lines
No EOL
18 KiB
PHP
<?php
|
|
/* SVN FILE: $Id$ */
|
|
|
|
/**
|
|
* Automatic generation of HTML FORMs from given data.
|
|
*
|
|
* Used for scaffolding.
|
|
*
|
|
* PHP versions 4 and 5
|
|
*
|
|
* CakePHP : Rapid Development Framework <http://www.cakephp.org/>
|
|
* Copyright (c) 2005, Cake Software Foundation, Inc.
|
|
* 1785 E. Sahara Avenue, Suite 490-204
|
|
* Las Vegas, Nevada 89104
|
|
*
|
|
* Licensed under The MIT License
|
|
* Redistributions of files must retain the above copyright notice.
|
|
*
|
|
* @filesource
|
|
* @copyright Copyright (c) 2005, Cake Software Foundation, Inc.
|
|
* @link http://www.cakefoundation.org/projects/info/cakephp CakePHP Project
|
|
* @package cake
|
|
* @subpackage cake.cake.libs.view.helpers
|
|
* @since CakePHP v 0.10.0.1076
|
|
* @version $Revision$
|
|
* @modifiedby $LastChangedBy$
|
|
* @lastmodified $Date$
|
|
* @license http://www.opensource.org/licenses/mit-license.php The MIT License
|
|
*/
|
|
|
|
|
|
/**
|
|
* Tag template for a div.
|
|
*/
|
|
define('TAG_DIV', '<div class="%s">%s</div>');
|
|
|
|
/**
|
|
* Tag template for a div.
|
|
*/
|
|
define('TAG_P_CLASS', '<p class="%s">%s</p>');
|
|
|
|
/**
|
|
* Tag template for a label.
|
|
*/
|
|
define('TAG_LABEL', '<label for="%s">%s</label>');
|
|
|
|
/**
|
|
* Tag template for a fieldset.
|
|
*/
|
|
define('TAG_FIELDSET', '<fieldset><legend>%s</legend>%s</label>');
|
|
|
|
/**
|
|
* Form helper library.
|
|
*
|
|
* Automatic generation of HTML FORMs from given data.
|
|
*
|
|
* @package cake
|
|
* @subpackage cake.cake.libs.view.helpers
|
|
* @since CakePHP v 0.10.0.1076
|
|
*
|
|
*/
|
|
class FormHelper extends Helper
|
|
{
|
|
|
|
var $helpers = array('Html');
|
|
/**
|
|
* Constructor which takes an instance of the HtmlHelper class.
|
|
*
|
|
* @param object $htmlHelper the HtmlHelper object to use as our helper.
|
|
* @return void
|
|
*/
|
|
function FormHelper()
|
|
{
|
|
}
|
|
|
|
/**
|
|
* 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
|
|
* @return bool If there are errors this method returns true, else false.
|
|
*/
|
|
function isFieldError($field )
|
|
{
|
|
$error = 1;
|
|
$this->Html->setFormTag( $field );
|
|
if( $error == $this->Html->tagIsInvalid( $this->Html->model, $this->Html->field) )
|
|
{
|
|
return true;
|
|
} else {
|
|
return false;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Returns a formatted LABEL element for HTML FORMs.
|
|
*
|
|
* @param string $tagName If field is to be used for CRUD, this should be modelName/fieldName
|
|
* @param string $text Text that will appear in the label field.
|
|
* @return string The formatted LABEL element
|
|
*/
|
|
function labelTag( $tagName, $text )
|
|
{
|
|
return sprintf( TAG_LABEL, strtolower(str_replace('/', '_',$tagName)), $text );
|
|
}
|
|
|
|
/**
|
|
* Returns a formatted DIV tag for HTML FORMs.
|
|
*
|
|
* @param string $class If field is to be used for CRUD, this should be modelName/fieldName
|
|
* @param string $text Text that will appear in the label field.
|
|
* @return string The formatted DIV element
|
|
*/
|
|
function divTag( $class, $text )
|
|
{
|
|
return sprintf( TAG_DIV, $class, $text );
|
|
}
|
|
|
|
/**
|
|
* Returns a formatted P tag with class for HTML FORMs.
|
|
*
|
|
* @param string $class If field is to be used for CRUD, this should be modelName/fieldName
|
|
* @param string $text Text that will appear in the label field.
|
|
* @return string The formatted DIV element
|
|
*/
|
|
function pTag( $class, $text )
|
|
{
|
|
return sprintf( TAG_P_CLASS, $class, $text );
|
|
}
|
|
|
|
/**
|
|
* Returns a formatted INPUT tag for HTML FORMs.
|
|
*
|
|
* @param string $tagName If field is to be used for CRUD, this should be modelName/fieldName
|
|
* @param string $prompt Text that will appear in the label field.
|
|
* @param bool $required True if this field is required.
|
|
* @param string $errorMsg Text that will appear if an error has occurred.
|
|
* @param int $size Size attribute for INPUT element
|
|
* @param array $htmlOptions
|
|
* @return string The formatted INPUT element
|
|
*/
|
|
function generateInputDiv($tagName, $prompt, $required=false, $errorMsg=null, $size=20, $htmlOptions=null )
|
|
{
|
|
$htmlOptions['id'] = strtolower(str_replace('/', '_',$tagName));;
|
|
$str = $this->Html->inputTag( $tagName, $size, $htmlOptions );
|
|
$strLabel = $this->labelTag( $tagName, $prompt );
|
|
|
|
$divClass = "optional";
|
|
|
|
if( $required )
|
|
$divClass = "required";
|
|
|
|
$strError = ""; // initialize the error to empty.
|
|
|
|
if( $this->isFieldError( $tagName ) )
|
|
{
|
|
// if it was an error that occured, then add the error message, and append " error" to the div tag.
|
|
$strError = $this->pTag( 'error', $errorMsg );
|
|
$divClass = sprintf( "%s error", $divClass );
|
|
}
|
|
$divTagInside = sprintf( "%s %s %s", $strError, $strLabel, $str );
|
|
|
|
return $this->divTag( $divClass, $divTagInside );
|
|
|
|
}
|
|
|
|
/**
|
|
* Returns a formatted CHECKBOX tag inside a DIV for HTML FORMs.
|
|
*
|
|
* @param HtmlHelper $html The HtmlHelper object which is creating this form.
|
|
* @param string $tagName If field is to be used for CRUD, this should be modelName/fieldName
|
|
* @param string $prompt Text that will appear in the label field.
|
|
* @param bool $required True if this field is required.
|
|
* @param string $errorMsg Text that will appear if an error has occurred.
|
|
* @param int $size Size attribute for INPUT element
|
|
* @param array $htmlOptions
|
|
* @return string The formatted INPUT element
|
|
*/
|
|
function generateCheckboxDiv($tagName, $prompt, $required=false, $errorMsg=null, $htmlOptions=null )
|
|
{
|
|
$htmlOptions['class'] = "inputCheckbox";
|
|
$htmlOptions['id'] = strtolower(str_replace('/', '_',$tagName));;
|
|
$str = $this->Html->checkbox( $tagName, null, $htmlOptions );
|
|
$strLabel = $this->labelTag( $tagName, $prompt );
|
|
|
|
$divClass = "optional";
|
|
|
|
if( $required )
|
|
$divClass = "required";
|
|
|
|
$strError = ""; // initialize the error to empty.
|
|
|
|
if( $this->isFieldError( $tagName ) )
|
|
{
|
|
// if it was an error that occured, then add the error message, and append " error" to the div tag.
|
|
$strError = $this->pTag( 'error', $errorMsg );
|
|
$divClass = sprintf( "%s error", $divClass );
|
|
}
|
|
$divTagInside = sprintf( "%s %s %s", $strError, $strLabel, $str );
|
|
|
|
return $this->divTag( $divClass, $divTagInside );
|
|
|
|
}
|
|
|
|
/**
|
|
* Returns a formatted date option element for HTML FORMs.
|
|
*
|
|
* @param string $tagName If field is to be used for CRUD, this should be modelName/fieldName
|
|
* @param string $prompt Text that will appear in the label field.
|
|
* @param bool $required True if this field is required.
|
|
* @param string $errorMsg Text that will appear if an error has occurred.
|
|
* @param int $size Size attribute for INPUT element
|
|
* @param array $htmlOptions
|
|
* @return string The formatted INPUT element
|
|
*/
|
|
function generateDate($tagName, $prompt, $required=false, $errorMsg=null, $size=20, $htmlOptions=null, $selected )
|
|
{
|
|
$htmlOptions['id'] = strtolower(str_replace('/', '_',$tagName));;
|
|
$str = $this->Html->dateTimeOptionTag( $tagName, 'MDY' , 'NONE', $selected, $htmlOptions);
|
|
$strLabel = $this->labelTag( $tagName, $prompt );
|
|
|
|
$divClass = "optional";
|
|
|
|
if( $required )
|
|
$divClass = "required";
|
|
|
|
$strError = ""; // initialize the error to empty.
|
|
|
|
if( $this->isFieldError( $tagName ) )
|
|
{
|
|
// if it was an error that occured, then add the error message, and append " error" to the div tag.
|
|
$strError = $this->pTag( 'error', $errorMsg );
|
|
$divClass = sprintf( "%s error", $divClass );
|
|
}
|
|
$divTagInside = sprintf( "%s %s %s", $strError, $strLabel, $str );
|
|
|
|
$requiredDiv = $this->divTag( $divClass, $divTagInside );
|
|
|
|
return $this->divTag("date", $requiredDiv);
|
|
}
|
|
|
|
/**
|
|
* Returns a formatted datetime option element for HTML FORMs.
|
|
*
|
|
* @param string $tagName If field is to be used for CRUD, this should be modelName/fieldName
|
|
* @param string $prompt Text that will appear in the label field.
|
|
* @param bool $required True if this field is required.
|
|
* @param string $errorMsg Text that will appear if an error has occurred.
|
|
* @param int $size Size attribute for INPUT element
|
|
* @param array $htmlOptions
|
|
* @return string The formatted datetime option element
|
|
*/
|
|
function generateDateTime($tagName, $prompt, $required=false, $errorMsg=null, $size=20, $htmlOptions=null, $selected = null )
|
|
{
|
|
$htmlOptions['id'] = strtolower(str_replace('/', '_',$tagName));;
|
|
$str = $this->Html->dateTimeOptionTag( $tagName, 'MDY' , '12', $selected, $htmlOptions);
|
|
$strLabel = $this->labelTag( $tagName, $prompt );
|
|
|
|
$divClass = "optional";
|
|
|
|
if( $required )
|
|
$divClass = "required";
|
|
|
|
$strError = ""; // initialize the error to empty.
|
|
|
|
if( $this->isFieldError( $tagName ) )
|
|
{
|
|
// if it was an error that occured, then add the error message, and append " error" to the div tag.
|
|
$strError = $this->pTag( 'error', $errorMsg );
|
|
$divClass = sprintf( "%s error", $divClass );
|
|
}
|
|
$divTagInside = sprintf( "%s %s %s", $strError, $strLabel, $str );
|
|
|
|
$requiredDiv = $this->divTag( $divClass, $divTagInside );
|
|
|
|
return $this->divTag("date", $requiredDiv);
|
|
}
|
|
|
|
/**
|
|
* Returns a formatted TEXTAREA inside a DIV for use with HTML forms.
|
|
*
|
|
* @param string $tagName If field is to be used for CRUD, this should be modelName/fieldName
|
|
* @param string $prompt Text that will appear in the label field.
|
|
* @param boolean $required True if this field is required.
|
|
* @param string $errorMsg ext that will appear if an error has occurred.
|
|
* @param integer $cols Number of columns.
|
|
* @param integer $rows Number of rows.
|
|
* @param array $htmlOptions
|
|
* @return string The formatted TEXTAREA element
|
|
*/
|
|
function generateAreaDiv($tagName, $prompt, $required=false, $errorMsg=null, $cols=60, $rows=10, $htmlOptions=null )
|
|
{
|
|
$htmlOptions['id'] = strtolower(str_replace('/', '_',$tagName));;
|
|
$str = $this->Html->areaTag( $tagName, $cols, $rows, $htmlOptions );
|
|
$strLabel = $this->labelTag( $tagName, $prompt );
|
|
|
|
$divClass = "optional";
|
|
|
|
if( $required )
|
|
$divClass = "required";
|
|
|
|
$strError = ""; // initialize the error to empty.
|
|
|
|
if( $this->isFieldError( $tagName ) )
|
|
{
|
|
// if it was an error that occured, then add the error message, and append " error" to the div tag.
|
|
$strError = $this->pTag( 'error', $errorMsg );
|
|
$divClass = sprintf( "%s error", $divClass );
|
|
}
|
|
$divTagInside = sprintf( "%s %s %s", $strError, $strLabel, $str );
|
|
|
|
return $this->divTag( $divClass, $divTagInside );
|
|
|
|
}
|
|
|
|
/**
|
|
* Returns a formatted SELECT tag for HTML FORMs.
|
|
*
|
|
* @param string $tagName If field is to be used for CRUD, this should be modelName/fieldName
|
|
* @param string $prompt Text that will appear in the label field
|
|
* @param array $options Options to be contained in SELECT element
|
|
* @param string $selected Text of the currently selected item
|
|
* @param array $selectAttr Array of HTML attributes for the SELECT element
|
|
* @param array $optionAttr Array of HTML attributes for the OPTION elements
|
|
* @param bool $required True if this field is required
|
|
* @param string $errorMsg Text that will appear if an error has occurred
|
|
* @return string The formatted INPUT element
|
|
*/
|
|
function generateSelectDiv($tagName, $prompt, $options, $selected=null, $selectAttr=null, $optionAttr=null, $required=false, $errorMsg=null)
|
|
{
|
|
$selectAttr['id'] = strtolower(str_replace('/', '_',$tagName));;
|
|
$str = $this->Html->selectTag( $tagName, $options, $selected, $selectAttr, $optionAttr );
|
|
$strLabel = $this->labelTag( $tagName, $prompt );
|
|
|
|
$divClass = "optional";
|
|
|
|
if( $required )
|
|
$divClass = "required";
|
|
|
|
$strError = ""; // initialize the error to empty.
|
|
|
|
if( $this->isFieldError( $tagName ) )
|
|
{
|
|
// if it was an error that occured, then add the error message, and append " error" to the div tag.
|
|
$strError = $this->pTag( 'error', $errorMsg );
|
|
$divClass = sprintf( "%s error", $divClass );
|
|
}
|
|
$divTagInside = sprintf( "%s %s %s", $strError, $strLabel, $str );
|
|
|
|
return $this->divTag( $divClass, $divTagInside );
|
|
|
|
}
|
|
|
|
/**
|
|
* Returns a formatted submit widget for HTML FORMs.
|
|
*
|
|
* @param string $prompt Text that will appear on the widget
|
|
* @param array $htmlOptions
|
|
* @return string The formatted submit widget
|
|
*/
|
|
function generateSubmitDiv($displayText, $htmlOptions = null)
|
|
{
|
|
return $this->divTag( 'submit', $this->Html->submitTag( $displayText, $htmlOptions) );
|
|
}
|
|
|
|
/**
|
|
* Generates a form to go onto a HtmlHelper object.
|
|
*
|
|
* @param array $fields An array of form field definitions
|
|
* @param boolean $readOnly True if the form should be rendered as READONLY
|
|
* @return string The completed form specified by the $fields parameter
|
|
*/
|
|
function generateFields( $fields, $readOnly = false )
|
|
{
|
|
$strFormFields = '';
|
|
foreach( $fields as $field )
|
|
{
|
|
if(isset( $field['type']))
|
|
{
|
|
if(!isset($field['required']))
|
|
{
|
|
$field['required'] = false;
|
|
}
|
|
if(!isset( $field['errorMsg']))
|
|
{
|
|
$field['errorMsg'] = null;
|
|
}
|
|
if(!isset( $field['htmlOptions']))
|
|
{
|
|
$field['htmlOptions'] = array();
|
|
}
|
|
if( $readOnly )
|
|
{
|
|
$field['htmlOptions']['READONLY'] = "readonly";
|
|
}
|
|
|
|
switch( $field['type'] )
|
|
{
|
|
case "input" :
|
|
if( !isset( $field['size'] ) )
|
|
{
|
|
$field['size'] = 40;
|
|
}
|
|
$strFormFields = $strFormFields.$this->generateInputDiv( $field['tagName'], $field['prompt'], $field['required'], $field['errorMsg'], $field['size'], $field['htmlOptions'] );
|
|
break;
|
|
case "checkbox" :
|
|
$strFormFields = $strFormFields.$this->generateCheckboxDiv( $field['tagName'], $field['prompt'], $field['required'], $field['errorMsg'], $field['htmlOptions'] );
|
|
break;
|
|
case "select";
|
|
case "selectMultiple";
|
|
if( "selectMultiple" == $field['type'] )
|
|
{
|
|
$field['selectAttr']['multiple'] = 'multiple';
|
|
$field['selectAttr']['class'] = 'selectMultiple';
|
|
}
|
|
if(!isset( $field['selected']))
|
|
{
|
|
$field['selected'] = null;
|
|
}
|
|
if(!isset( $field['selectAttr']))
|
|
{
|
|
$field['selectAttr'] = null;
|
|
}
|
|
if(!isset( $field['optionsAttr']))
|
|
{
|
|
$field['optionsAttr'] = null;
|
|
}
|
|
if($readOnly)
|
|
{
|
|
$field['selectAttr']['DISABLED'] = true;
|
|
}
|
|
$strFormFields = $strFormFields.$this->generateSelectDiv( $field['tagName'], $field['prompt'], $field['options'], $field['selected'], $field['selectAttr'], $field['optionsAttr'], $field['required'], $field['errorMsg'] );
|
|
break;
|
|
case "area";
|
|
if(!isset( $field['rows']))
|
|
{
|
|
$field['rows'] = 10;
|
|
}
|
|
if(!isset( $field['cols']))
|
|
{
|
|
$field['cols'] = 60;
|
|
}
|
|
$strFormFields = $strFormFields.$this->generateAreaDiv( $field['tagName'], $field['prompt'], $field['required'], $field['errorMsg'], $field['cols'], $field['rows'], $field['htmlOptions'] );
|
|
break;
|
|
case "fieldset";
|
|
|
|
$strFieldsetFields = $this->generateFields( $field['fields'] );
|
|
$strFieldSet = sprintf( '
|
|
<fieldset><legend>%s</legend><div class="notes"><h4>%s</h4><p class="last">%s</p></div>%s</fieldset>',
|
|
$field['legend'], $field['noteHeading'], $field['note'], $strFieldsetFields );
|
|
$strFormFields = $strFormFields.$strFieldSet;
|
|
break;
|
|
case "hidden";
|
|
$strFormFields = $strFormFields . $this->Html->hiddenTag( $field['tagName']);
|
|
break;
|
|
case "date":
|
|
if( !isset( $field['selected']))
|
|
{
|
|
$field['selected'] = null;
|
|
}
|
|
$strFormFields = $strFormFields.$this->generateDate( $field['tagName'], $field['prompt'], null, null, null, null, $field['selected']);
|
|
break;
|
|
case "datetime":
|
|
if( !isset( $field['selected']))
|
|
{
|
|
$field['selected'] = null;
|
|
}
|
|
$strFormFields = $strFormFields.$this->generateDateTime( $field['tagName'], $field['prompt'], '','','', '', $field['selected']);
|
|
break;
|
|
default:
|
|
break;
|
|
}
|
|
}
|
|
}
|
|
return $strFormFields;
|
|
}
|
|
}
|
|
?>
|