/**
* Convert an array of details into a form element.
* @param String $fieldName The name of the form element
* @param Array $fieldDetails The list of details for the form element.
*/
protected function createElementObject($fieldName, $fieldDetails)
{
// Extract fields
$label = $this->formObj->getArrayValue($fieldDetails, 'label');
$type = $this->formObj->getArrayValue($fieldDetails, 'type');
// Required 'true' or true are valid
$required = $this->formObj->getArrayValue($fieldDetails, 'required');
$required = $required == 'true' || $required == '1';
// Start creating form element if anything other than a break.
$elem = false;
if ($type != 'break') {
$elem = new FormElement($fieldName, $label, $required);
}
// Handle specific types
switch ($type) {
// Text Area
case 'textarea':
$rows = $this->formObj->getArrayValue($fieldDetails, 'rows') + 0;
if ($rows == 0) {
$rows = 5;
}
$elem->setTypeAsTextArea($rows, 70);
break;
// Select/Dropdown
// Select/Dropdown
case 'select':
$options = false;
if (isset($fieldDetails['data']) && is_array($fieldDetails['data'])) {
$options = $fieldDetails['data'];
}
$elem->setTypeAsComboBox($options);
break;
// Radio Buttons
// Radio Buttons
case 'radio':
$options = false;
if (isset($fieldDetails['data']) && is_array($fieldDetails['data'])) {
$options = $fieldDetails['data'];
}
$elem->setTypeAsRadioButtons($options);
break;
// Checkbox
// Checkbox
case 'checkbox':
$label = false;
if (isset($fieldDetails['extralabel'])) {
$label = $fieldDetails['extralabel'];
}
$elem->setTypeAsCheckbox($label);
break;
// Checkbox List
// Checkbox List
case 'checkboxlist':
$options = false;
if (isset($fieldDetails['data']) && is_array($fieldDetails['data'])) {
$options = $fieldDetails['data'];
}
$elem->setTypeAsCheckboxList($options);
break;
// Merged Fields - process each sub element
// Merged Fields - process each sub element
case 'merge':
$elementList = array();
if (!empty($fieldDetails['merge'])) {
foreach ($fieldDetails['merge'] as $fieldName => $fieldDetails) {
$elementList[] = $this->createElementObject($fieldName, $fieldDetails);
}
}
$elem->setTypeAsMergedElements($elementList);
break;
// File upload
// File upload
case 'uploadfile':
$elem->setTypeAsUploadFile($this->formObj->getArrayValue($fieldDetails, 'show_existing'), $this->formObj->getArrayValue($fieldDetails, 'valid_if_value'));
break;
// Custom HTML
// Custom HTML
case 'custom':
$elem->setTypeAsCustom($this->formObj->getArrayValue($fieldDetails, 'html'));
break;
// Hidden field
// Hidden field
case 'hidden':
$elem->setTypeAsHidden();
break;
// Section break
// Section break
case 'break':
$this->formObj->addBreak($fieldName, $this->formObj->getArrayValue($fieldDetails, 'html'));
break;
// Text box
// Text box
default:
break;
}
// Add optional fields
if ($type != 'break') {
// Element description
if ($desc = $this->formObj->getArrayValue($fieldDetails, 'desc')) {
$elem->description = $desc;
}
// Extra CSS
if ($cssclass = $this->formObj->getArrayValue($fieldDetails, 'cssclass')) {
$elem->cssclass = $cssclass;
}
// Add extra HTML if provided.
$extraHTML = $this->formObj->getArrayValue($fieldDetails, 'extrahtml');
if ($extraHTML) {
$elem->afterFormElementHTML = $extraHTML;
}
// Add custom error message if there is one
$elem->errorMessage = $this->formObj->getArrayValue($fieldDetails, 'errormsg');
// Validation rules
if (isset($fieldDetails['validate']) && is_array($fieldDetails['validate'])) {
// Is it a custom function? If so, get the function name.
if ($this->formObj->getArrayValue($fieldDetails['validate'], 'type') == 'function') {
$elem->validationFn = $this->formObj->getArrayValue($fieldDetails['validate'], 'fname');
$elem->errorMessage = $this->formObj->getArrayValue($fieldDetails['validate'], 'error');
} else {
$elem->setValidationRules($fieldDetails['validate']);
}
}
// See if there are any suffix items? If so, parse them.
// See wiki for documentation on how to structure this.
if (!empty($fieldDetails['suffix_subitems'])) {
$suffixItems = array();
// suffix_subitems contains a list of 'position' => array(fieldName => fieldDetails)
foreach ($fieldDetails['suffix_subitems'] as $position => $elementDetails) {
$suffixItems[$position] = array();
// Need to process each field now we know the position.
foreach ($elementDetails as $fieldName => $fieldDetails) {
// Add the position of this item (in order), with the object for this element.
$suffixItems[$position][] = $this->createElementObject($fieldName, $fieldDetails);
}
}
// Update the form element with the subitems
$elem->setSuffixItems($suffixItems);
}
}
return $elem;
}