/**
* Set Values to Form
*
* An associative array is used to pre-populate form elements.
* The keys of this array correspond with the element names.
*
* There are two use cases for this method:
* 1) pre-filled form
* Some default values are set to the form, which then get altered by the user.
* b) incomming post data
* Set the incomming POST data values are set to the form for validation.
*
* @param object|array $data Object or Array. If null (default), POST parameters are used.
*/
public function setValues($data = null)
{
// because $data might be an object, typecast $data object to array
if (is_object($data) === true) {
$data = (array) $data;
} elseif (null === $data) {
if ('POST' === Koch_HttpRequest::getRequestMethod()) {
$data = Koch_HttpRequest::getPost();
}
}
// now we got an $data array to populate all the formelements with (setValue)
foreach ($data as $key => $value) {
foreach ($this->formelements as $formelement) {
$type = $formelement->getType();
/**
* Exclude some formelements from setValue(), e.g. buttons, etc.
* Setting the value would just change the visible "name" of these elements.
*/
if (true === in_array($type, array('submit', 'button', 'cancelbutton', 'resetbutton'))) {
continue;
}
// data[key] and formelement[name] have to match
if ($formelement->getName() == ucfirst($key)) {
$formelement->setValue($value);
}
}
}
}
