sName = sprintf("_kt_attempt_unique_%s", $this->sName); // we don't have access via "wrap" when processing, so we can't actually // wrap. just don't use a lot of names } function process($data){ $tname = sprintf("_kt_attempt_unique_%s", $this->sName); return array($this->sBasename => $_FILES[$tname]); } function getValidators() { if (!$this->bAutoValidate) { return null; } $oVF =& KTValidatorFactory::getSingleton(); return $oVF->get('ktcore.validators.requiredfile', array( 'test' => sprintf("_kt_attempt_unique_%s", $this->sName), 'basename' => $this->sBasename, )); } } class KTCoreTextWidget extends KTWidget { var $sNamespace = 'ktcore.widgets.text'; var $sTemplate = 'ktcore/forms/widgets/text'; } class KTCoreReasonWidget extends KTWidget { var $sNamespace = 'ktcore.widgets.reason'; var $sTemplate = 'ktcore/forms/widgets/text'; function configure($aOptions) { $res = parent::configure($aOptions); if (PEAR::isError($res)) { return $res; } // FIXME make required *either* per-action property // FIXME or a global pref. $global_required_default = true; $this->bRequired = KTUtil::arrayGet($aOptions, 'required', $global_required_default, false); $this->aOptions['cols'] = KTUtil::arrayGet($aOptions, 'cols', 60); $this->aOptions['rows'] = KTUtil::arrayGet($aOptions, 'rows', 3); } } class KTCoreBooleanWidget extends KTWidget { var $sNamespace = 'ktcore.widgets.boolean'; var $sTemplate = 'ktcore/forms/widgets/boolean'; function setDefault($mValue) { $this->value = ($mValue == true); } } class KTCorePasswordWidget extends KTWidget { var $sNamespace = 'ktcore.widgets.password'; var $sTemplate = 'ktcore/forms/widgets/password'; var $bConfirm = false; var $sConfirmDescription; function configure($aOptions) { $res = parent::configure($aOptions); if (PEAR::isError($res)) { return $res; } $this->bConfirm = KTUtil::arrayGet($aOptions, 'confirm', false); $this->sConfirmDescription = KTUtil::arrayGet($aOptions, 'confirm_description'); } function process($raw_data) { // since we're essentially a string, pass *that* out as the primary // but we also might want to confirm, and if so we use a private name $res = array(); if ($this->bConfirm) { $res['_password_confirm_' . $this->sBasename] = array( 'base' => $raw_data[$this->sBasename]['base'], 'confirm' => $raw_data[$this->sBasename]['confirm'], ); $res[$this->sBasename] = $raw_data[$this->sBasename]['base']; } else { $res[$this->sBasename] = $raw_data[$this->sName]; } return $res; } function getValidators() { if (!$this->bAutoValidate) { return null; } $oVF =& KTValidatorFactory::getSingleton(); $val = array(); $val[] = parent::getValidators(); // required, etc. $val[] = $oVF->get('ktcore.validators.password', array( 'test' => $this->sOrigname, 'basename' => $this->sBasename )); return $val; } } class KTCoreSelectionWidget extends KTWidget { var $sNamespace = 'ktcore.widgets.selection'; var $bMulti = false; // multiselection var $USE_SIMPLE = 10; // point at which to switch to a dropdown/multiselect var $bUseSimple; // only use checkboxes, regardless of size var $aVocab; var $sEmptyMessage; var $_valuesearch; function configure($aOptions) { $res = parent::configure($aOptions); if (PEAR::isError($res)) { return $res; } $this->bUseSimple = KTUtil::arrayGet($aOptions, 'simple_select', null, false); $this->bMulti = KTUtil::arrayGet($aOptions, 'multi', false); $this->aVocab = (array) KTUtil::arrayGet($aOptions, 'vocab'); $this->sEmptyMessage = KTUtil::arrayGet($aOptions, 'empty_message', _kt('No options available for this field.')); } function getWidget() { // very simple, general purpose passthrough. Chances are this is sufficient, // just override the template being used. $bHasErrors = false; if (count($this->aErrors) != 0) { $bHasErrors = true; } // at this last moment we pick the template to use $total = count($this->aVocab); if ($this->bUseSimple === true) { $this->sTemplate = 'ktcore/forms/widgets/simple_selection'; } else if ($this->bUseSimple === false) { $this->sTemplate = 'ktcore/forms/widgets/selection'; } else if (is_null($this->bUseSimple) && ($total <= $this->USE_SIMPLE)) { $this->sTemplate = 'ktcore/forms/widgets/simple_selection'; } else { $this->sTemplate = 'ktcore/forms/widgets/selection'; } $oTemplating =& KTTemplating::getSingleton(); $oTemplate = $oTemplating->loadTemplate($this->sTemplate); // performance optimisation for large selected sets. if ($this->bMulti) { $this->_valuesearch = array(); $value = (array) $this->value; foreach ($value as $v) { $this->_valuesearch[$v] = true; } } $aTemplateData = array( "context" => $this, "name" => $this->sName, "has_id" => ($this->sId !== null), "id" => $this->sId, "has_value" => ($this->value !== null), "value" => $this->value, "options" => $this->aOptions, 'vocab' => $this->aVocab, ); return $oTemplate->render($aTemplateData); } function selected($lookup) { if ($this->bMulti) { return $this->_valuesearch[$lookup]; } else { return ($this->value == $lookup); } } function process($raw_data) { return array($this->sBasename => $raw_data[$this->sBasename]); } } // this happens so often, its worth creating a util function for it class KTCoreEntitySelectionWidget extends KTCoreSelectionWidget { var $sNamespace = 'ktcore.widgets.entityselection'; var $sIdMethod; var $sLabelMethod; function configure($aOptions) { $res = parent::configure($aOptions); if (PEAR::isError($res)) { return $res; } // the selection widget's configure method has already setup almost // all the vars we need. we have one utility here, where you pass // in a list of existing entities that match the query, and we work // from there. $this->sIdMethod = KTUtil::arrayGet($aOptions, 'id_method', 'getId'); $this->sLabelMethod = KTUtil::arrayGet($aOptions, 'label_method'); if (empty($this->sLabelMethod)) { return PEAR::raiseError(_kt('No label method specified.')); } $existing_entities = (array) KTUtil::arrayGet($aOptions, 'existing_entities'); // now we construct the "value" array from this set // BUT ONLY IF WE DON'T HAVE A "VALUE" array. if (empty($this->value)) { $this->value = array(); foreach ($existing_entities as $oEntity) { $this->value[] = call_user_func(array(&$oEntity, $this->sIdMethod)); } } // we next walk the "vocab" array, constructing a new one based on the // functions passed in so far. $new_vocab = array(); foreach ($this->aVocab as $oEntity) { $id = call_user_func(array(&$oEntity, $this->sIdMethod)); $label = call_user_func(array(&$oEntity, $this->sLabelMethod)); $new_vocab[$id] = $label; } $this->aVocab = $new_vocab; } } // wrap a set of fields into a core, basic one. // // this *also* subdivides the form data output namespace. // to do this, it encapsulates a *large* amount of the KTWidget API class KTCoreFieldsetWidget extends KTWidget { var $sNamespace = 'ktcore.widgets.fieldset'; var $_widgets; var $sDescription; var $sLabel; function configure($aOptions) { // do NOT use parent. $this->sLabel = KTUtil::arrayGet($aOptions, 'label'); $this->sDescription = KTUtil::arrayGet($aOptions, 'description'); $this->sName = KTUtil::arrayGet($aOptions, 'name'); $this->sBasename = $this->sName; $aWidgets = (array) KTUtil::arrayGet($aOptions, 'widgets'); // very similar to the one in forms.inc.php if (is_null($this->_oWF)) { $this->_oWF =& KTWidgetFactory::getSingleton(); } $this->_widgets = array(); // we don't want to expose the factory stuff to the user - its an // arbitrary distinction to the user. Good point from NBM ;) foreach ($aWidgets as $aInfo) { if (is_null($aInfo)) { continue; } else if (is_object($aInfo)) { // assume this is a fully configured object $this->_widgets[] = $aInfo; } else { $namespaceOrObject = $aInfo[0]; $config = (array) $aInfo[1]; $this->_widgets[] = $this->_oWF->get($namespaceOrObject, $config); } } } function render() { $oTemplating =& KTTemplating::getSingleton(); $oTemplate = $oTemplating->loadTemplate('ktcore/forms/widgets/fieldset'); $aTemplateData = array( "context" => $this, "label" => $this->sLabel, "description" => $this->sDescription, "widgets" => $this->renderWidgets(), ); return $oTemplate->render($aTemplateData); } function renderWidgets() { $rendered = array(); foreach ($this->_widgets as $v) { if (PEAR::isError($v)) { $rendered[] = sprintf(_kt('
Unable to show widget — %s