/** * Method to get a form object. * * @param string $xml The form data. Can be XML string if file flag is set to false. * @param array $options Optional array of parameters. * @param boolean $clear Optional argument to force load a new form. * @return mixed JForm object on success, False on error. */ public function &getForm($xml = null, $name = 'form', $options = array(), $clear = false) { if ($xml === null) { $xml = strtolower($this->getName()); } // Handle the optional arguments. $options['array'] = array_key_exists('array', $options) ? $options['array'] : 'jform'; $options['file'] = array_key_exists('file', $options) ? $options['file'] : true; $options['event'] = array_key_exists('event', $options) ? $options['event'] : null; $options['group'] = array_key_exists('group', $options) ? $options['group'] : null; // Create a signature hash. $hash = md5($xml . serialize($options)); // Check if we can use a previously loaded form. if (isset($this->_forms[$hash]) && !$clear) { return $this->_forms[$hash]; } // Get the form. EForm::addFormPath(JPATH_COMPONENT_ADMINISTRATOR . DS . 'models' . DS . 'forms'); EForm::addFieldPath(JPATH_COMPONENT_ADMINISTRATOR . DS . 'models' . DS . 'fields'); EFormValidator::addRulePath(JPATH_COMPONENT_ADMINISTRATOR . DS . 'models' . DS . 'rules'); $app = JFactory::getApplication(); if ($app->isSite()) { EForm::addFormPath(JPATH_COMPONENT_SITE . DS . 'models' . DS . 'forms'); EForm::addFieldPath(JPATH_COMPONENT_SITE . DS . 'models' . DS . 'fields'); EFormValidator::addRulePath(JPATH_COMPONENT_SITE . DS . 'models' . DS . 'rules'); } $form =& EForm::getInstance($xml, $name, $options['file'], $options); // Check for an error. if (JError::isError($form)) { $this->setError($form->getMessage()); $false = false; return $form; } // Look for an event to fire. if ($options['event'] !== null) { // Get the dispatcher. $dispatcher =& JDispatcher::getInstance(); // Load an optional plugin group. if ($options['group'] !== null) { JPluginHelper::importPlugin($options['group']); } // Trigger the form preparation event. $results = $dispatcher->trigger($options['event'], array($form->getName(), $form)); // Check for errors encountered while preparing the form. if (count($results) && in_array(false, $results, true)) { // Get the last error. $error = $dispatcher->getError(); // Convert to a JException if necessary. if (!JError::isError($error)) { $error = new JException($error, 500); } return $error; } } // Store the form for later. $this->_forms[$hash] = $form; return $form; }
/** * Method to test if a value is valid for a field. * * @param object $field The field to validate. * @param array $values The values to validate. * @return mixed Boolean on success, JException on error. * @since 1.6 */ protected function _isValid(&$field, $values) { $result = true; // Get the validator type. if ($type = $field->attributes('validate')) { // Get the validator class. $class = 'JFormRule' . $type; if (!class_exists($class)) { jimport('joomla.filesystem.path'); // Attempt to load the rule file. if ($file = JPath::find(EFormValidator::addRulePath(), $type . '.php')) { require_once $file; } if (!class_exists($class)) { return new JException(JText::sprintf('Libraries_Form_Validator_Rule_Not_Found', $type), 0, E_ERROR); } } // Run the validator. $rule = new $class(); $result = $rule->test($field, $values); } return $result; }