CWIS Developer Documentation
Public Member Functions | Static Public Member Functions | List of all members
FormTool Class Reference

Helps print and validate form fields, and their errors, associated with a form. More...

Public Member Functions

 __construct ($FormFields, $AdditionalErrorMessages=NULL)
 Object constructor. More...
 
 ValueForField ($FieldName, $NewValue=NULL)
 Get and set the value for a form field. More...
 
 AllRequiredVarsAreSet ()
 Determine whether all of the required form field values are set in the POST variables. More...
 
 GetValsAsUrlParams ($IncludePasswords=FALSE)
 Return the URL parameter string with form field values that are set in the POST variables. More...
 
 SetFieldValuesFromUrlParams ()
 Set the values for the form fields from the URL parameters when available. More...
 
 IncomingFieldValuesHaveErrors ()
 Check the incoming form values for each field and report whether errors were found. More...
 
 GetErrorCodesAsUrlParams ()
 Return the URL parameter string with error codes for any form value errors. More...
 
 SetAdditionalErrorFields ($FieldNames)
 Save additional fields marked as having errors. More...
 
 SetAdditionalErrorCodes ($Codes)
 Save additional error codes if not already present. More...
 
 GetUrlWithValuesAndErrorCodes ($BaseUrl, $IncludePasswords=FALSE)
 Convenience method that adds value and error codes to the URL. More...
 
 GetErrorMessages ($EliminateDuplicateMessages=TRUE)
 Get the list of error messages based on the error codes from the URL via $_GET. More...
 
 PrintField ($FieldName)
 Print the label and input for given form field. More...
 
 PrintLabelForField ($FieldName)
 Print the label element for the given field. More...
 
 PrintInputForField ($FieldName)
 Print the input element for the given field. More...
 
 ErrorCodesAvailable ()
 Determine if there are any error codes available from the form. More...
 

Static Public Member Functions

static GetArrayOfUsStates ()
 Get an array of US state names with their two-letter abbreviations as the index. More...
 

Detailed Description

Helps print and validate form fields, and their errors, associated with a form.

Definition at line 14 of file FormTool.php.

Constructor & Destructor Documentation

FormTool::__construct (   $FormFields,
  $AdditionalErrorMessages = NULL 
)

Object constructor.

Parameters
mixed$FormFieldsArray of form field objects or the path to a file that loads and returns form field objects via $FormFields.
array$AdditionalErrorMessagesAdditional error messages to add, if any. This parameter is optional.

Definition at line 25 of file FormTool.php.

Member Function Documentation

FormTool::AllRequiredVarsAreSet ( )

Determine whether all of the required form field values are set in the POST variables.

Returns
Returns TRUE if all the required form field values are set in the POST variables.

Definition at line 100 of file FormTool.php.

FormTool::ErrorCodesAvailable ( )

Determine if there are any error codes available from the form.

Returns
Return TRUE if there are any error codes available.

Definition at line 427 of file FormTool.php.

Referenced by PrintField(), PrintInputForField(), and PrintLabelForField().

Here is the caller graph for this function:

static FormTool::GetArrayOfUsStates ( )
static

Get an array of US state names with their two-letter abbreviations as the index.

Returns
Returns an array of US state names with their two-letter abbreviations as the index.

Definition at line 438 of file FormTool.php.

References StdLib\GetUsStatesList().

FormTool::GetErrorCodesAsUrlParams ( )

Return the URL parameter string with error codes for any form value errors.

The URL parameter string does not include a leading separator (? or &).

Returns
Returns the URL parameter string with error codes or an empty string if no errors were found.

Definition at line 187 of file FormTool.php.

Referenced by GetUrlWithValuesAndErrorCodes(), and IncomingFieldValuesHaveErrors().

Here is the caller graph for this function:

FormTool::GetErrorMessages (   $EliminateDuplicateMessages = TRUE)

Get the list of error messages based on the error codes from the URL via $_GET.

Parameters
bool$EliminateDuplicateMessagesTRUE to remove error messages that are exactly the same.
Returns
Returns an array of error messages.

Definition at line 318 of file FormTool.php.

FormTool::GetUrlWithValuesAndErrorCodes (   $BaseUrl,
  $IncludePasswords = FALSE 
)

Convenience method that adds value and error codes to the URL.

Parameters
string$BaseUrlBase URL to which to add the value and error codes.
bool$IncludePasswordsTRUE to include password fields in the URL parameters.
Returns
Returns the base URL with the values and error codes added to it.

Definition at line 300 of file FormTool.php.

References GetErrorCodesAsUrlParams(), and GetValsAsUrlParams().

FormTool::GetValsAsUrlParams (   $IncludePasswords = FALSE)

Return the URL parameter string with form field values that are set in the POST variables.

The URL parameter string does not include a leading separator (? or &).

Parameters
bool$IncludePasswordsTRUE to include password fields in the URL parameters.

Definition at line 128 of file FormTool.php.

Referenced by GetUrlWithValuesAndErrorCodes().

Here is the caller graph for this function:

FormTool::IncomingFieldValuesHaveErrors ( )

Check the incoming form values for each field and report whether errors were found.

Returns
Returns TRUE if errors were found.

Definition at line 174 of file FormTool.php.

References GetErrorCodesAsUrlParams().

FormTool::PrintField (   $FieldName)

Print the label and input for given form field.

Parameters
string$FieldNameForm field name.

Definition at line 394 of file FormTool.php.

References ErrorCodesAvailable().

FormTool::PrintInputForField (   $FieldName)

Print the input element for the given field.

Parameters
string$FieldNameForm field name.

Definition at line 416 of file FormTool.php.

References ErrorCodesAvailable().

FormTool::PrintLabelForField (   $FieldName)

Print the label element for the given field.

Parameters
string$FieldNameForm field name.

Definition at line 405 of file FormTool.php.

References ErrorCodesAvailable().

FormTool::SetAdditionalErrorCodes (   $Codes)

Save additional error codes if not already present.

Parameters
array$CodesAdditional error codes to save.

Definition at line 274 of file FormTool.php.

FormTool::SetAdditionalErrorFields (   $FieldNames)

Save additional fields marked as having errors.

Parameters
array$FieldNamesField names to mark as having errors.

Definition at line 252 of file FormTool.php.

FormTool::SetFieldValuesFromUrlParams ( )

Set the values for the form fields from the URL parameters when available.

Definition at line 155 of file FormTool.php.

FormTool::ValueForField (   $FieldName,
  $NewValue = NULL 
)

Get and set the value for a form field.

Parameters
string$FieldNameForm field name.
mixed$NewValueNew value to set for the form field. This parameter is optional.
Returns
mixed Returns The current value for the form field.

Definition at line 89 of file FormTool.php.


The documentation for this class was generated from the following file: