+ * array( + * array( + * 'filter' => 'Multiplier', + * 'params' => array( 'multiplier' => 6 ) + * ) + * ) + *+ * + * @access public + * @param string $name The name of the element + * @param string $type The type of the element; for a list of possible elements, have a look at the elements/ subfolder of the patForms package. + * @param array $attributes Attributes for the element + * @param array $filters Optional filters that will be applied + * @return object patForms_Element $element The element object, or patError if failed. + */ + function &createElement( $name, $type, $attributes, $filters = null, $children = null ) + { + $element =& patForms::_createModule( 'Element', $type ); + if ( patErrorManager::isError( $element ) ) + { + return $element; + } + + $attributes['name'] = $name; + if ( !isset( $attributes['id'] ) ) { + $attributes['id'] = $this->getElementId(); + } + + // add default attributes - do this the 'silent' way be checking whether + // the element supports the given attribute, as the element throws a notice + // if it does not support it - this is not expected from default attributes. + foreach ( patForms::getStaticProperty( 'defaultAttributes' ) as $attributeName => $attributeValue ) + { + if ( !$element->hasAttribute( $attributeName ) ) + { + continue; + } + + $element->setAttribute( $attributeName, $attributeValue ); + } + + // set the given attributes normally + $success = $element->setAttributes( $attributes ); + if ( patErrorManager::isError( $success ) ) + { + return $success; + } + + if (is_array($children)) { + foreach ($children as $child) { + $childName = $child['attributes']['name']; + + $childEl = &patForms::createElement($childName, $child['type'], $child['attributes']); + if ( isset( $child["renderer"] ) ) { + $childEl->setRenderer( $child["renderer"] ); + } + + $element->addElement($childEl); + } + } + + $success = $element->_init(); + if ( patErrorManager::isError( $success ) ) { + return $success; + } + + // if we don't have any filters to add, we're done + if ( !is_array( $filters ) ) + { + return $element; + } + + $cnt = count( $filters ); + for ( $i = 0; $i < $cnt; $i++ ) + { + $params = isset( $filters[$i]['params'] ) ? $filters[$i]['params'] : null; + $filter = &patForms::createFilter( $filters[$i]['filter'], $params ); + if ( patErrorManager::isError( $filter ) ) + { + continue; + } + $element->applyFilter( $filter ); + } + + return $element; + } + + /** + * retrieves the validation errors from all elements in the form. Use this if the validateForm() + * method returned false. + * + * @access public + * q + * @return array $errors Array containing an array with validation errors for each element in the form. + * @todo replace __form with the name of the form, once attributes are implemented + */ + function getValidationErrors($withElements = true) + { + $found = false; + $errors = array(); + + if ( !empty( $this->validationErrors ) ) + { + $errors['__form'] = $this->validationErrors; + $found = true; + } + + if ($withElements === false) { + return $errors; + } + + $cnt = count( $this->elements ); + for ( $i = 0; $i < $cnt; ++$i ) + { + $name = $this->elements[$i]->getAttribute( 'name' ); + if ( $name === false ) + { + continue; + } + + $elementErrors = $this->elements[$i]->getValidationErrors(); + + if ( empty( $elementErrors ) ) + continue; + + $errors[$name] = $elementErrors; + $found = true; + } + + if ( $found ) + return $errors; + + return false; + } + + /** + * retrieves the values for all elements in the form. + * + * @access public + * @param array desired fields + * @param integer Mode that should be used to return values in groups + * @return array The values for all elements, as elementname => elementvalue. + * + * @todo remove the ugly Group check and replace with something better + * @todo implement something similar for getValidation errors + */ + function getValues( $fields = null, $type = PATFORMS_VALUES_NESTED ) + { + $values = array(); + + $cnt = count( $this->elements ); + for ( $i = 0; $i < $cnt; ++$i ) + { + $name = $this->elements[$i]->getAttribute( 'name' ); + if ( $name === false ) { + continue; + } + + if ( is_array( $fields ) && !in_array( $name, $fields ) ) { + continue; + } + + $tmpVal = $this->elements[$i]->getValue(); + if (!is_array($tmpVal) || $this->elements[$i]->elementName != 'Group') { + $values[$name] = $tmpVal; + continue; + } + + switch ($type) { + case PATFORMS_VALUES_FLATTENED: + $values = array_merge($values, $tmpVal); + break; + case PATFORMS_VALUES_PREFIXED: + foreach ($tmpVal as $key => $val) { + $values[$name.'_'.$key] = $val; + } + break; + case PATFORMS_VALUES_NESTED: + default: + $values[$name] = $tmpVal; + break; + + } + } + return $values; + } + + /** + * sets the values for all elements in the form. Use this to fill your form with external + * data, like a db query. Caution: if you do this and set the form to submitted, the values + * will be overwritten by any values present in the $_GET or $_POST variables. + * + * @access public + * @param array $values The values for all elements, as elementname => elementvalue. + */ + function setValues( $values, $overrideUserInput = false ) + { + patErrorManager::pushExpect(PATFORMS_ERROR_ELEMENT_NOT_FOUND); + foreach ($values as $elName => $value) { + $el = &$this->getElementByName($elName); + if (patErrorManager::isError($el)) { + continue; + } + if ($overrideUserInput === true) { + $el->setValue($value); + } else { + $el->setDefaultValue($value); + } + } + patErrorManager::popExpect(); + return true; + } + + /** + * retrieves the current mode of the form + * + * @access public + * @return string $mode The current form mode + * @see setMode() + * @see $mode + */ + function getMode() + { + return $this->mode; + } + + /** + * returns the locale that is currently set for the form. + * + * @access public + * @return string $locale The locale. + * @see setLocale() + * @see $locale + */ + function getLocale() + { + return $this->locale; + } + + /** + * retrieves the current format of the form + * + * @access public + * @return string $format The current form format + * @see setFormat() + * @see format + */ + function getFormat() + { + return $this->format; + } + + /** + * retrieves the current method of the form + * + * @access public + * @return string $method The request method + * @see setMethod() + */ + function getMethod() + { + return $this->getAttribute( 'method' ); + } + + /** + * retrieves the current action of the form + * + * @access public + * @return string $action Action of the form + * @see setAction() + */ + function getAction() + { + $action = $this->getAttribute( 'action' ); + if ( !empty( $action ) ) + return $action; + return $_SERVER['PHP_SELF']; + } + + /** + * adds an atribute to the form's attribute collection. If the attribute + * already exists, it is overwritten. + * + * @access public + * @param string $attributeName The name of the attribute to add + * @param string $atributeValue The value of the attribute + */ + function setAttribute( $attributeName, $attributeValue ) + { + if ( !isset( $this->attributeDefinition[$attributeName] ) ) + { + patErrorManager::raiseNotice( + PATFORMS_NOTICE_ATTRIBUTE_NOT_SUPPORTED, + "The attribute '".$attributeName."' is not supported by the form, skipped it. [".get_class( $this )."]" + ); + return true; + } + + $this->attributes[$attributeName] = $attributeValue; + + return true; + } + + /** + * adds several attributes at once to the form's attribute collection. + * Any existing attributes will be overwritten. + * + * @access public + * @param array $attributes The attributes to add + * @see setAttribute() + */ + function setAttributes( $attributes ) + { + if ( !is_array( $attributes ) ) + { + return patErrorManager::raiseError( + PATFORMS_NOTICE_ARRAY_EXPECTED, + "setAttributes: array expected" + ); + } + + foreach ( $attributes as $attributeName => $attributeValue ) + { + $this->setAttribute( $attributeName, $attributeValue ); + } + + return true; + } + + /** + * retrieves the value of a form attribute. + * + * @access public + * @param string $attribute The name of the attribute to retrieve + * @return mixed $attributeValue The value of the attribute, or false if it does not exist in the attributes collection. + * @see setAttribute() + */ + function getAttribute( $attribute ) + { + if ( !isset( $this->attributes[$attribute] ) ) + { + return false; + } + + return $this->attributes[$attribute]; + } + + /** + * retrieves all attributes of the form, or only the specified attributes. + * + * @access public + * @param array $attributes Optional: The names of the attributes to retrieve. Only the attributes that exist will be returned. + * @return array $result The attributes + * @see getAttribute() + */ + function getAttributes( $attributes = array() ) + { + if ( empty( $attributes ) ) + { + return $this->attributes; + } + + $result = array(); + foreach ( $attributes as $attribute ) + { + if ( $attributeValue = $this->getAttribute( $attribute ) ) + { + $result[$attribute] = $attributeValue; + } + } + + return $result; + } + + /** + * Loads the default attribute values into the attributes collection. Done directly + * on startup (in the consructor). + * + * The action defaults to the path of the current script, with session + * ID appended automatically, if SID has been defined. + * + * @access public + * @return bool $success Always returns true. + * @see $attributeDefaults + */ + function loadAttributeDefaults() + { + foreach ( $this->attributeDefinition as $attributeName => $attributeDef ) + { + if ( isset( $attributeDef['default'] ) ) + { + $this->attributes[$attributeName] = $attributeDef['default']; + } + + if ( $attributeName == 'action' ) + { + $this->attributes[$attributeName] = $_SERVER['PHP_SELF']; + /** + * session has been started, append session ID + */ + if ( defined( 'SID' ) ) + $this->attributes[$attributeName] .= '?' . SID; + } + } + + return true; + } + + /** + * retrieves the form's current submitted state. + * + * If autoValidate is used, it will check for the submitVar and + * set the submitted flag accordingly + * + * @access public + * @return bool $state True if it has been submitted, false otherwise. + * @see setSubmitted(), setAutoValidate() + * @see submitted + */ + function isSubmitted() + { + if ( $this->submitted === true ) + { + return true; + } + + if ( !isset( $this->submitVar ) ) + { + return false; + } + + if ( !$this->autoValidate ) + { + return false; + } + + if ( isset( $_GET[$this->submitVar] ) || isset( $_POST[$this->submitVar] ) ) + { + $this->setSubmitted( true ); + } + + return $this->submitted; + } + + /** + * Creates a new patForms_Creator object + * + * @static + * @access public + * @return object $creator The creator object, or a patError object on failure + */ + function createCreator( $type ) + { + return patForms::_createModule( 'Creator', $type ); + } + + /** + * get the element name of the form + * + * @access public + * @return string name of the form + */ + function getElementName() + { + return $this->elementName; + } + + /** + * get next error offset + * + * @access public + * @return integer + */ + function getErrorOffset( $requiredCodes = 100 ) + { + $offset = $this->nextErrorOffset; + $this->nextErrorOffset = $this->nextErrorOffset + $requiredCodes; + return $offset; + } + + /** + * add error codes and messages for validator method + * + * @access public + * @param array defintions + * @param integer offset for the error codes + */ + function addValidatorErrorCodes( $defs, $offset = 1000 ) + { + foreach ( $defs as $lang => $codes ) + { + if ( !isset( $this->validatorErrorCodes[$lang] ) ) + { + $this->validatorErrorCodes[$lang] = array(); + } + + foreach ( $codes as $code => $message ) + { + $this->validatorErrorCodes[$lang][($offset+$code)] = $message; + } + } + } + + /** + * add a validation error to the whole form + * + * This can be achieved by adding a validation rule to the form. + * + * @access public + * @param integer $code + * @param array $vars fill named placeholder with values + * @return boolean $result true on success + * @see addRule() + */ + function addValidationError( $code, $vars = array() ) + { + $error = false; + $lang = $this->locale; + $element = $this->getElementName(); + + // find error message for selected language + while ( true ) + { + // error message matches language code + if ( isset( $this->validatorErrorCodes[$lang][$code] ) ) + { + $error = array( "element" => $element, "code" => $code, "message" => $this->validatorErrorCodes[$lang][$code] ); + break; + } + // no message found and no fallback-langauage available + else if ( $lang == "C" ) + { + break; + } + + $lang_old = $lang; + + // look for other languages + if ( strlen( $lang ) > 5 ) + { + list( $lang, $trash ) = explode( ".", $lang ); + } + else if ( strlen( $lang ) > 2 ) + { + list( $lang, $trash ) = explode( "_", $lang ); + } + else + { + $lang = "C"; + } + + // inform developer about missing language + patErrorManager::raiseNotice( + PATFORMS_NOTICE_VALIDATOR_ERROR_LOCALE_UNDEFINED, + "Required Validation Error-Code for language: $lang_old not available. Now trying language: $lang", + "Add language definition in used element or choose other language" + ); + + } + + // get default Error! + if ( !$error ) + { + patErrorManager::raiseWarning( + PATFORMS_WARNING_VALIDATOR_ERROR_UNDEFINED, + "No Error Message for this validation Error was defined", + "Review the error-definition for validation-errors in your element '$element'." + ); + $error = array( "element" => $element, "code" => 0, "message" => "Unknown validation Error" ); + } + + // insert values to placeholders + if ( !empty( $vars ) ) + { + foreach ( $vars as $key => $value ) + { + $error["message"] = str_replace( "[". strtoupper( $key ) ."]", $value, $error["message"] ); + } + } + + array_push( $this->validationErrors, $error ); + $this->valid = false; + return true; + } + + /** + * retreives a new element id, used to give each added element a unique id for this + * form (id can be overwritten by setting the id attribute specifically). + * + * @access private + * @return int $elementId The new element id. + */ + function getElementId() + { + $this->elementCounter++; + return 'pfo'.$this->elementCounter; + } + + /** + * attach an observer + * + * @access public + * @param object patForms_Observer + * @see createObserver() + * @uses patForms_Element::createObserver() + */ + function attachObserver( &$observer, $where = PATFORMS_OBSERVER_ATTACH_TO_ELEMENTS ) + { + /** + * attach the observer to all elements + */ + if ( ( $where & PATFORMS_OBSERVER_ATTACH_TO_ELEMENTS ) == PATFORMS_OBSERVER_ATTACH_TO_ELEMENTS ) + { + $cnt = count( $this->elements ); + for ( $i = 0; $i < $cnt; ++$i ) + { + $this->elements[$i]->attachObserver( $observer ); + } + } + + /** + * attach the observer to the form + */ + if ( ( $where & PATFORMS_OBSERVER_ATTACH_TO_FORM ) == PATFORMS_OBSERVER_ATTACH_TO_FORM ) + { + $this->observers[] = &$observer; + } + return true; + } + + /** + * Retrieve the content for the start of the form, including any + * additional content, e.g. global scripts if the scripts option + * is enabled. + * + * @access public + * @return string $formStart The form start content + * @todo use format to build a dynamic method + */ + function serializeStart() + { + $methodName = "serializeStart".ucfirst( $this->getFormat() ).ucfirst( $this->getMode() ); + + if ( !method_exists( $this, $methodName ) ) + { + return patErrorManager::raiseError( + PATFORMS_ERROR_METHOD_FOR_MODE_NOT_AVAILABLE, + "Method for patForms mode '".$this->getMode()."' (".$methodName.") is not available." + ); + } + + return $this->$methodName(); + } + + /** + * Serializes the form's start element for html format, in default mode. + * + * @access private + * @return mixed $formStart The serialized start content, or a patError object. + */ + function serializeStartHtmlDefault() + { + $attributes = $this->getAttributesFor( $this->format ); + if ( patErrorManager::isError( $attributes ) ) + { + return $attributes; + } + + $content = patForms_Element::createTag( 'form', 'opening', $attributes ); + + if ( $this->optionEnabled( 'scripts' ) ) + { + $content .= $this->getScripts(); + } + + return $content; + } + + /** + * Serializes the form's start element for html format, in readonly mode. + * + * @access private + * @return mixed $formStart The serialized start content, or a patError object. + */ + function serializeStartHtmlReadonly() + { + $attributes = $this->getAttributesFor( $this->format ); + if ( patErrorManager::isError( $attributes ) ) + { + return $attributes; + } + + return patForms_Element::createTag( 'form', 'opening', $attributes ); + } + + /** + * Retrieve the content for the end of the form. + * + * @access public + * @return string $formEnd The form end content + */ + function serializeEnd() + { + $methodName = "serializeEnd".ucfirst( $this->getFormat() ).ucfirst( $this->getMode() ); + + if ( !method_exists( $this, $methodName ) ) + { + return patErrorManager::raiseError( + PATFORMS_ERROR_METHOD_FOR_MODE_NOT_AVAILABLE, + "Method for patForms mode '".$this->getMode()."' (".$methodName.") is not available." + ); + } + + return $this->$methodName(); + } + + /** + * Retrieves the content for the end of the form for html format, + * in default mode. + * + * @access private + * @return string $formEnd The form end content + */ + function serializeEndHtmlDefault() + { + return patForms_Element::createTag( 'form', 'closing' ); + } + + /** + * Retrieves the content for the end of the form for html format, + * in readonly mode. + * + * @access private + * @return string $formEnd The form end content + */ + function serializeEndHtmlReadonly() + { + return $this->serializeEndHtmlDefault(); + } + + /** + * validates the current attribute collection according to the attributes definition + * and the given output format, and returns the list of valid attributes. + * + * @access private + * @param string $format The output format to retrieve the attributes for. + * @return mixed $attributes The list of attributes, or false if failed. + */ + function getAttributesFor( $format ) + { + $attributes = array(); + + foreach ( $this->attributeDefinition as $attributeName => $attributeDef ) + { + if ( !isset( $this->attributes[$attributeName] ) ) + { + if ( $attributeDef["required"] ) + { + return patErrorManager::raiseError( + PATFORMS_ERROR_ATTRIBUTE_REQUIRED, + 'patForms needs the attribute "'.$attributeName.'" to be set.', + 'See the patForms attribute definition of patForms for a complete attribute reference.' + ); + } + + continue; + } + + $attributeValue = $this->attributes[$attributeName]; + + if ( !in_array( $format, $attributeDef["outputFormats"] ) ) + { + continue; + } + + if ( isset( $attributeDef["format"] ) ) + { + if ( !$this->_checkAttributeFormat( $attributeValue, $attributeDef["format"] ) ) + { + return patErrorManager::raiseError( + PATFORMS_ERROR_CAN_NOT_VERIFY_FORMAT, + "Format '".$attributeDef["format"]."' could not be verified for patForms attribute '".$attributeName."' => '".$attributeValue."'" + ); + } + } + + $attributes[$attributeName] = $attributeValue; + } + + return $attributes; + } + + /** + * checks the format of an attribute value according to the given format. + * + * @access private + * @param mixed $attributeValue The attribute value to check + * @param string $format The format to check the attribute value against + * @return bool $result True if format check succeeded, false otherwise. + * @see createAttributes() + * @todo Implement this method sometime + */ + function _checkAttributeFormat( $attributeValue, $format ) + { + return true; + } + + /** + * Enables a patForms option. + * + * See the {@link $options} property for an exhaustive list of available options. + * + * @access public + * @param string $option The option to enable + * @param array $params Optional parameters for the option + * @return mixed $result True on success, patError object otherwise. + * @see disableOption() + * @see optionEnabled() + * @see $options + */ + function enableOption( $option, $params = array() ) + { + if ( !in_array( $option, array_keys( $this->options ) ) ) + { + return patErrorManager::raiseNotice( + PATFORMS_NOTICE_INVALID_OPTION, + 'The option "'.$option.'" is not a valid patForms option.' + ); + } + + $this->options[$option]['enabled'] = true; + $this->options[$option]['params'] = $params; + + // now update all available elements too + $cnt = count( $this->elements ); + for ( $i=0; $i < $cnt; $i++ ) + { + $this->elements[$i]->enableOption( $option, $params ); + } + + return true; + } + + /** + * Disables a patForms option + * + * See the {@link $options} property for an exhaustive list of available options. + * + * @access public + * @param string $option The option to disable + * @return mixed $result True on success, patError object otherwise. + * @see enableOption() + * @see optionEnabled() + * @see $options + */ + function disableOption( $option ) + { + if ( !in_array( $option, array_keys( $this->options ) ) ) + { + return patErrorManager::raiseNotice( + PATFORMS_NOTICE_INVALID_OPTION, + 'The option "'.$option.'" is not a valid patForms option.' + ); + } + + $this->options[$option]['enabled'] = false; + + // now update all available elements too + $cnt = count( $this->elements ); + for ( $i=0; $i < $cnt; $i++ ) + { + $this->elements[$i]->disableOption( $option ); + } + + return true; + } + + /** + * Checks whether the given option is enabled. + * + * @access public + * @param string $option The option to check + * @return bool $enabled True if enabled, false otherwise. + * @see enableOption() + * @see disableOption() + * @see $options + */ + function optionEnabled( $option ) + { + if ( !isset( $this->options[$option] ) ) + return false; + + return $this->options[$option]['enabled']; + } + + /** + * Set the form to auto validate + * + * If you use this method, patForms will check the _GET and _POST variables + * for the variable you specified. If it is set, patForms assumes, that + * the form has been submitted. + * + * When creating a start tag for the form, the value will be inserted automatically. + * + * @access public + * @param string $submitVar + */ + function setAutoValidate( $submitVar ) + { + $this->autoValidate = true; + $this->submitVar = $submitVar; + } + + /** + * register a new event + * + * After registering an event, you may register one or more + * event handlers for this event an then trigger the event. + * + * This lets you extend the functionality of patForms. + * + * @access public + * @param string event name + * @return boolean true, if event could be registered + * @see registerEventHandler() + * @see triggerEvent() + */ + function registerEvent( $name ) + { + $event = 'on' . $name; + if ( in_array( $event, $this->_validEvents ) ) + { + return patErrorManager::raiseNotice( + PATFORMS_NOTICE_EVENT_ALREADY_REGISTERED, + 'Event "'.$event.'" already has been registered or is built-in event' + ); + } + array_push( $this->_validEvents, $event ); + return true; + } + + /** + * Register an event handler + * + * An event handler can be any valid PHP callback. You may pass + * one of the following values: + * - string functionname to call a globally declared function + * - array( string classname, string methodname) to call a static method + * - array( object obj, string methodname) to call a method of an object + * + * When the handler is called, two parameters will be passed: + * - object form : a patForms object + * - string event : the name of the event has should be handled. + * + * An event handler should always return true. If false is returned, + * the event will be cancelled. + * + * Currently handlers for the following events can be registered: + * - onSubmit + * - onSuccess + * - onError + * + * @access public + * @param string event name + * @param mixed event handler + * @return boolean true, if the handler could be registered + * @see triggerEvent() + * @see $_validEvents + */ + function registerEventHandler( $event, $handler ) + { + if ( !in_array( $event, $this->_validEvents ) ) + { + return patErrorManager::raiseError( + PATFORMS_ERROR_UNKNOWN_EVENT, + 'Cannot register event handler for unknown event "' . $event .'".' + ); + } + + if ( !is_callable( $handler ) ) + { + return patErrorManager::raiseError( + PATFORMS_ERROR_INVALID_HANDLER, + 'Event handler is not callable.' + ); + } + + if ( !isset( $this->_eventHandler[$event] ) ) + { + $this->_eventHandler[$event] = array(); + } + + $this->_eventHandler[$event][] = &$handler; + return true; + } + + /** + * set event handler object. + * + * An event handler object is used to handle all + * registered events. The object has to provide methods + * for all events it should handle, the names of the methods + * have to be the same as the names of the events. + * + * @access public + * @param object event handler object + * @param array method names, used to change the names of the methods + * @return boolean + */ + function registerEventHandlerObject( &$obj, $methods = array() ) + { + if ( empty( $methods ) ) + { + foreach ( $this->_validEvents as $event ) + { + if ( !method_exists( $obj, $event ) ) + continue; + + $methods[$event] = $event; + } + } + + foreach ( $methods as $event => $method ) + { + if ( !isset( $this->_eventHandler[$event] ) ) + { + $this->_eventHandler[$event] = array(); + } + + $this->_eventHandler[$event][] = array( &$obj, $method ); + } + + return true; + } + + /** + * Trigger an event + * + * In most cases there's no need to call this event + * from outside the class. The method is declared public + * to allow you to trigger custom events. + * + * @access public + * @param string Event name. The event name must not contain 'on', as this will be + * prefixed automatically. + */ + function triggerEvent( $event ) + { + $handlerName = 'on' . $event; + + if ( !isset( $this->_eventHandler[$handlerName] ) || empty( $this->_eventHandler[$handlerName] ) ) + { + return true; + } + + $cnt = count( $this->_eventHandler[$handlerName] ); + for ( $i = 0; $i < $cnt; $i++ ) + { + $result = call_user_func( $this->_eventHandler[$handlerName][$i], $this, $event ); + if ( $result == false ) + { + return $result; + } + } + return true; + } + + /** + * Serializes the entire form to XML, all elements included + * + * @access public + * @param string $namespace Optional namespace to use for the tags + * @return string $xml The XML representation of the form + * @see patForms_Element::toXML() + * @todo needs patForms_Element, maybe switch to PEAR::XML_Util + */ + function toXML( $namespace = null ) + { + $tagName = 'Form'; + + // prepend Namespace + if ( $namespace != null ) + { + $tagName = $namespace.':'.$tagName; + } + + // get all attributes + $attributes = $this->getAttributes(); + + // create valid XML attributes + foreach ( $attributes as $key => $value ) + { + $attributes[$key] = strtr( $value, $this->xmlEntities ); + } + + $elements = ''; + for ( $i = 0; $i < $this->elementCounter; $i++ ) + { + $elements .= $this->elements[$i]->toXML( $namespace ); + } + + return patForms_Element::createTag( $tagName, "full", $attributes, $elements ); + } + + /** + * Set a static property. + * + * Static properties are stored in an array in a global variable, + * until PHP5 is ready to use. + * + * @static + * @param string property name + * @param mixed property value + * @see getStaticProperty() + */ + function setStaticProperty( $property, &$value ) + { + $GLOBALS["_patForms"][$property] = &$value; + } + + /** + * Get a static property. + * + * Static properties are stored in an array in a global variable, + * until PHP5 is ready to use. + * + * @static + * @param string property name + * @return mixed property value + * @see setStaticProperty() + */ + function &getStaticProperty( $property ) + { + if ( isset( $GLOBALS["_patForms"][$property] ) ) + { + return $GLOBALS["_patForms"][$property]; + } + return patErrorManager::raiseWarning( + PATFORMS_ERROR_NO_STATIC_PROPERTY, + 'Static property "'.$property.'" could not be retreived, it does not exist.' + ); + } + + /** + * Retrieves the form's name + * + * If no name is set, it will use 'patForms' as name. + * + * @access public + * @return string $name The name of the form. + */ + function getName() + { + if ( isset( $this->attributes['name'] ) ) + return $this->attributes['name']; + return 'patForms'; + } + + /** + * get the javascript for the form + * + * This is still in alpha state. It will later + * allow client side validation if the element + * provides this feature. + * + * @access public + * @return string javascript needed by the form + * @todo make this dependent on the format + * @todo add changeable linebreaks + */ + function getScripts() + { + foreach ($this->elements as $element) { + $element->registerJavascripts($this); + } + + $globalJavascript = implode ("", $this->javascripts['global']); + $instances = implode ("", $this->javascripts['instance']); + + $script = ''; + + return $script; + + /* + $globalJavascript = ''; + $instances = ''; + + $displayedTypes = array(); + + $cnt = count( $this->elements ); + for ( $i = 0; $i < $cnt; ++$i ) + { + $instances .= $this->elements[$i]->getInstanceJavascript(); + + $type = $this->elements[$i]->getElementName(); + if ( in_array( $type, $displayedTypes ) ) + continue; + + array_push( $displayedTypes, $type ); + $globalJavascript .= $this->elements[$i]->getGlobalJavascript(); + } + + $cnt = count( $this->_rules ); + for ( $i = 0; $i < $cnt; ++$i ) + { + $instances .= $this->_rules[$i]['rule']->getInstanceJavascript(); + + + $type = $this->_rules[$i]['rule']->getRuleName(); + if ( in_array( $type, $displayedTypes ) ) + continue; + + array_push( $displayedTypes, $type ); + + $globalJavascript .= $this->_rules[$i]['rule']->getGlobalJavascript(); + } + + $script = ''; + + return $script; + */ + } + + private $javascripts = array( + 'global' => array(), + 'instance' => array() + ); + + function registerGlobalJavascript($type, $script) { + + $this->javascripts['global'][$type] = $script; + } + + function registerInstanceJavascript($script) { + + $this->javascripts['instance'][] = $script; + } + + /** + * anounce a change in the element to all observers + * + * @access private + * @param string property that changed + * @param mixed new value of the property + */ + function _announce( $property, $value ) + { + $cnt = count( $this->observers ); + for ( $i = 0; $i < $cnt; $i++ ) + { + $this->observers[$i]->notify( $this, $property, $value ); + } + return true; + } +} diff --git a/3rd_party/php/propel/contrib/pat/patForms/Creator/Definition.php b/3rd_party/php/propel/contrib/pat/patForms/Creator/Definition.php new file mode 100644 index 000000000..c2ecb4a96 --- /dev/null +++ b/3rd_party/php/propel/contrib/pat/patForms/Creator/Definition.php @@ -0,0 +1,42 @@ + $definition->name + )); + + foreach ($definition->elements as $el) { + $element = &$form->createElement($el['name'], $el['type'], null); + if (!empty($el['attributes']['datasource'])) { + $ds = $el['attributes']['datasource']; + unset($el['attributes']['datasource']); + $element->setDatasource(new $ds['name']($ds)); + } + // patForms will choke when we try to set attributes that + // don't exist for an element type. So we'll have to ask. + foreach ($el['attributes'] as $name => $value) { + if ($element->hasAttribute($name)) { + $element->setAttribute($name, $value); + } + } + if (isset($el['rules'])) { + foreach ($el['rules'] as $rule) { + $element->addRule(new $rule['type']($rule)); + } + } + $form->addElement($element); + } + if (!is_null($object)) { + $form->setValues($object->toArray()); + } + if ($definition->autoValidate) { + $form->setAutoValidate($definition->autoValidate); + } + + return $form; + } + +} diff --git a/3rd_party/php/propel/contrib/pat/patForms/Creator/Propel.php b/3rd_party/php/propel/contrib/pat/patForms/Creator/Propel.php new file mode 100644 index 000000000..61876da98 --- /dev/null +++ b/3rd_party/php/propel/contrib/pat/patForms/Creator/Propel.php @@ -0,0 +1,132 @@ + + * @license LGPL, see license.txt for details + * @link http://www.php-tools.net + */ +class patForms_Creator_Propel extends patForms_Creator +{ + private static $creoleTypeMapping = array( + CreoleTypes::BOOLEAN =>'Radio', // BOOLEAN = 1; + CreoleTypes::BIGINT =>'String', // BIGINT = 2; + CreoleTypes::SMALLINT =>'String', // SMALLINT = 3; + CreoleTypes::TINYINT =>'String', // TINYINT = 4; + CreoleTypes::INTEGER =>'String', // INTEGER = 5; + CreoleTypes::CHAR =>'String', // CHAR = 6; + CreoleTypes::VARCHAR =>'String', // VARCHAR = 7; + CreoleTypes::FLOAT =>'String', // FLOAT = 8; + CreoleTypes::DOUBLE =>'String', // DOUBLE = 9; + CreoleTypes::DATE =>'Date', // DATE = 10; + CreoleTypes::TIME =>'String', // TIME = 11; + CreoleTypes::TIMESTAMP =>'Date', // TIMESTAMP = 12; + CreoleTypes::VARBINARY =>'String', // VARBINARY = 13; + CreoleTypes::NUMERIC =>'String', // NUMERIC = 14; + CreoleTypes::BLOB =>'String', // BLOB = 15; + CreoleTypes::CLOB =>'String', // CLOB = 16; + CreoleTypes::TEXT =>'Text', // TEXT = 17; + CreoleTypes::LONGVARCHAR =>'Text', // LONGVARCHAR = 17; + CreoleTypes::DECIMAL =>'String', // DECIMAL = 18; + CreoleTypes::REAL =>'String', // REAL = 19; + CreoleTypes::BINARY =>'String', // BINARY = 20; + CreoleTypes::LONGVARBINARY =>'String', // LONGVARBINARY = 21; + CreoleTypes::YEAR =>'String', // YEAR = 22; + CreoleTypes::ARR =>'String', + CreoleTypes::OTHER =>'String' + ); + + /** + * Create a form from a propel instance + * + * @access public + * @param mixed $object An instance of a Propel object + * @param array $options Any options the creator may need + * @return object $form The patForms object, or a patError object on failure. + */ + function &create( $object, $options = array() ) + { + // Propel stuff + $propel_peer = $object->getPeer(); + $propel_mapBuilder = $propel_peer->getMapBuilder(); // Not sure if we're gonna need this one + $propel_tablename = constant(get_class($propel_peer) . '::TABLE_NAME'); + $propel_tableMap = $propel_mapBuilder->getDatabaseMap()->getTable($propel_tablename); + + // The form + $form =& patForms::createForm( null, array( 'name' => 'patForms_Creator_Form' ) ); + + $propel_cols = $propel_tableMap->getColumns(); + foreach ($propel_cols as $propel_colname => $propel_col) { + + // phpName can be altered by editing the schema.xml, + // thus I think, we should lowercase()/ucfirst() this + $propel_colname = strtolower($propel_colname); + $el_displayname = ucFirst($propel_colname); + // this could be omitted of course, but I think, it's a + // convenient way to get more safe request properties + $el_name = $propel_tablename . '[' . $propel_colname . ']'; + + $el_attr = array( + 'edit' => 'yes', + 'title' => $el_displayname, + 'label' => $el_displayname, + 'name' => $el_name, + 'description' => $el_displayname + ); + + //// Obsolete ? + // Parse column info to element type info + //$type_info = $this->parseTypeInfoFromColumn($propel_col); + // Merge extra element attributes + //$el_attr = array_merge( $el_attr, $type_info['attributes'] ); + + // Is the element required ? Can we retrieve this info from the Column object ? + $el_attr['required'] = 'yes'; + // Value: for now we use default to set the value. Is there a better (more correct) way to do this ? + $el_attr['default'] = $object->{'get'.$propel_col->getPhpName()}(); + + if ($propel_col->isPrimaryKey()) { + $el_type = 'hidden'; + } else { + $el_type = self::$creoleTypeMapping[$propel_col->getCreoleType()]; + } + + $el = &$form->createElement($el_name, $el_type, null); + // patForms will choke when we try to set attributes + // that don't match the element type. So we'll ask. + foreach ($el_attr as $name => $value) { + if ($el->hasAttribute($name)) { + $el->setAttribute($name, $value); + } + } + $form->addElement($el); + } + + return $form; + } + + // Seems this function will become obsolete if we use the static $creoleTypeMapping + function parseTypeInfoFromColumn ( $column ) { + + return array( + 'type' => 'String', + 'attributes' => array() + ); + } +} diff --git a/3rd_party/php/propel/contrib/pat/patForms/Creator/_propel_creator_test.php b/3rd_party/php/propel/contrib/pat/patForms/Creator/_propel_creator_test.php new file mode 100644 index 000000000..33f108ed7 --- /dev/null +++ b/3rd_party/php/propel/contrib/pat/patForms/Creator/_propel_creator_test.php @@ -0,0 +1,201 @@ + + * @license LGPL, see license.txt for details + * @link http://www.php-tools.net + */ + + /** + * Main examples prepend file, needed *only* for the examples framework! + */ + //include_once 'patExampleGen/prepend.php'; + //$exampleGen->displayHead( 'Example' ); + + include('include/common.php'); + + // EXAMPLE START ------------------------------------------------------ + + /** + * main patForms class + */ + require_once ('patForms.php'); + + /** + * patErrorManager class + */ + require_once ('patErrorManager.php'); + + + // create the creator :) + $creator = &patForms::createCreator( 'Propel' ); + + // create the form object from the given propel Object class instance + + require_once('model/general/UserProfile.php'); + $userProfile = UserProfilePeer::retrieveByPK(1); + $form =& $creator->create( $userProfile ); + + //$wikipage = WikipagePeer::retrieveByPK('wiki'); + //$form =& $creator->create($wikipage); + + // create the needed renderer + $renderer =& patForms::createRenderer( "Array" ); + + // set the renderer + $form->setRenderer( $renderer ); + + // use auto-validation + $form->setAutoValidate( 'save' ); + + // serialize the elements + $elements = $form->renderForm(); + + + // ERROR DISPLAY ------------------------------------------------------ + if ( $form->isSubmitted() ) + { + displayErrors( $form ); // see patExampleGen/customFunctions.php + } + + // DISPLAY FORM ------------------------------------------------------ + displayForm( $form, $elements ); // see patExampleGen/customFunctions.php + + /** + * Takes a patForms object, asks it if there are any validation + * errors and displays them if need be. + * + * NOTE: this is just a helper method for our examples collection, + * so that you may concentrate on the relevant parts of the examples. + * It does in no way represent the way it should be done :) + * + * @access public + * @param object &$form The patForms object to use + */ + function displayErrors( &$form ) + { + // get the errors from the form object - if there are none, + // this returns false so it is easy to check if there are any. + $errors = $form->getValidationErrors(); + + // if there are any errors, display them. + if ( $errors ) + { + echo '
| '.$els[$i]->getAttribute('label').' | : | '.$els[$i]->getValue().' | '; + echo '
+ * patForms_Rule::prepareRule( $container );
+ *
+ *
+ * @access public
+ * @param object Either a patForms or patForms_Element object
+ */
+ function prepareRule( &$container )
+ {
+ $this->format = $container->getFormat();
+
+ $this->container = &$container;
+ $this->errorOffset = $container->getErrorOffset();
+
+ $container->addValidatorErrorCodes( $this->validatorErrorCodes, $this->errorOffset );
+
+ return true;
+ }
+
+ /**
+ * method called by patForms or any patForms_Element to validate the
+ * element or the form.
+ *
+ * @abstract
+ * @access public
+ * @param object Either a patForms or patForms_Element object
+ * @return boolean true, if rule has been applied succesfully, false otherwise
+ */
+ function applyRule( &$container, $type = PATFORMS_RULE_BEFORE_VALIDATION )
+ {
+ // your code
+ }
+
+ /**
+ * addValidationError
+ *
+ * @access private
+ * @param integer $code
+ * @param array $vars fill named placeholder with values
+ * @return boolean $result true on success
+ */
+ function addValidationError( $code, $vars = array() )
+ {
+ $code= $this->errorOffset + $code;
+ return $this->container->addValidationError( $code, $vars );
+ }
+
+ /**
+ * get the name of the rule
+ *
+ * By default just return the classname, this is sufficient.
+ *
+ * @access public
+ * @return string
+ */
+ function getRuleName()
+ {
+ if (!empty($this->ruleName)) {
+ return $this->ruleName;
+ }
+ return get_class( $this );
+ }
+
+ /**
+ * get the global javascript of the rule
+ *
+ * @access public
+ * @return string
+ * @todo Rules need to know the output format
+ */
+ /*
+ function getGlobalJavascript()
+ {
+ if ( isset( $this->globalScript['html'] ) )
+ {
+ return $this->globalScript['html'];
+ }
+ return '';
+ }
+ */
+
+ /**
+ * get the instance javascript of the rule
+ *
+ * @access public
+ * @return string
+ */
+ /*
+ function getInstanceJavascript()
+ {
+ if ( !isset( $this->instanceScript[$this->format] ) )
+ {
+ return false;
+ }
+ // get the script for the current format
+ $script = $this->instanceScript[$this->format];
+
+ // always replace the id
+ $script = str_replace( '[RULE::ID]', $this->_id, $script );
+ if ( method_exists( $this->container, 'getId' ) )
+ {
+ $script = str_replace( '[CONTAINER::ID]', $this->container->getId(), $script );
+ }
+ if ( method_exists( $this->container, 'getName' ) )
+ {
+ $script = str_replace( '[CONTAINER::NAME]', $this->container->getName(), $script );
+ }
+
+ foreach ( $this->scriptPlaceholders as $placeholder => $property )
+ {
+ if ( isset( $this->$property ) )
+ $script = str_replace( '['.$placeholder.']', $this->$property, $script );
+ else
+ $script = str_replace( '['.$placeholder.']', '', $script );
+ }
+ return $script;
+ }
+ */
+
+ function registerJavascripts(&$form) {
+
+ if ($script = $this->getGlobalJavascript()) {
+ $form->registerGlobalJavascript($this->getRuleName(), $script);
+ }
+
+ if ($script = $this->getInstanceJavascript()) {
+ $form->registerInstanceJavascript($script);
+ }
+ }
+
+ function getGlobalJavascript() {
+
+ if (isset($this->globalScript[$this->format])) {
+ return $this->globalScript[$this->format];
+ }
+ }
+
+ function getInstanceJavascript(){
+
+ if (isset($this->instanceScript[$this->format])) {
+ $script = $this->instanceScript[$this->format];
+ $script = str_replace('[RULE::ID]', $this->_id, $script);
+ if (method_exists($this->container, 'getId')) {
+ $script = str_replace('[CONTAINER::ID]', $this->container->getId(), $script);
+ }
+ if (method_exists($this->container, 'getName')) {
+ $script = str_replace('[CONTAINER::NAME]', $this->container->getName(), $script);
+ }
+ foreach ($this->scriptPlaceholders as $placeholder => $property) {
+ if (isset($this->$property)) {
+ $script = str_replace('['.$placeholder.']', $this->$property, $script);
+ } else {
+ $script = str_replace('['.$placeholder.']', '', $script);
+ }
+ }
+ return $script;
+ }
+ }
+}
diff --git a/3rd_party/php/propel/contrib/pat/patForms/Rule/Match.php b/3rd_party/php/propel/contrib/pat/patForms/Rule/Match.php
new file mode 100644
index 000000000..3d47185f2
--- /dev/null
+++ b/3rd_party/php/propel/contrib/pat/patForms/Rule/Match.php
@@ -0,0 +1,163 @@
+
+ * @license LGPL, see license.txt for details
+ * @link http://www.php-tools.net
+ */
+class patForms_Rule_Match extends patForms_Rule
+{
+ /**
+ * script that will be displayed only once
+ *
+ * @access private
+ * @var array
+ */
+
+ var $globalScript = array(
+ 'html' => "/* patForms::Rule::Match */
+
+function pFRC_Match(field) {
+ this.field = eval('pfe_' + field);
+}
+
+pFRC_Match.prototype.validate = function() {
+ value = this.field.getValue();
+ if (!value.match(this.pattern)) {
+ alert('This is an invalid value.');
+ }
+}
+
+pFRC_Match.prototype.setValue = function(pattern) {
+ this.pattern = pattern;
+}
+
+/* END: patForms::Rule::Match */
+"
+ );
+
+ /**
+ * javascript that will be displayed once per instance
+ *
+ * @access private
+ * @var array
+ */
+ var $instanceScript = array(
+ 'html' => "var pfr_[RULE::ID] = new pFRC_Match('[CONTAINER::NAME]');\n"
+ );
+
+ /**
+ * properties that have to be replaced in the instance script.
+ *
+ * @access private
+ * @var array
+ */
+ var $scriptPlaceholders = array(
+ 'RULE::SOURCE' => '_source',
+ );
+
+ /**
+ * name of the rule
+ *
+ * @abstract
+ * @access private
+ */
+ var $ruleName = 'Match';
+
+ /**
+ * define error codes and messages for the rule
+ *
+ * @access private
+ * @var array $validatorErrorCodes
+ * @todo translate error messages
+ */
+ var $validatorErrorCodes = array(
+ "C" => array(
+ 1 => "This is an invalid value.",
+ ),
+ "de" => array(
+ 1 => "Dies ist ein ungültiger Wert.",
+ ),
+ "fr" => array(
+ 1 => "This is an invalid value.",
+ )
+ );
+
+ /**
+ * the regEx pattern
+ * @access private
+ * @var string
+ */
+ var $_pattern;
+
+ /**
+ * field id that is used
+ * @access private
+ * @var string
+ */
+ var $_field;
+
+ private $value = 10;
+
+ public function __construct($params) {
+
+ parent::__construct();
+
+ extract($params);
+ $this->_pattern = $value;
+ }
+
+ /**
+ * prepare the rule
+ *
+ * @access public
+ * @param object patForms
+ */
+ function prepareRule(&$container) {
+
+ patForms_Rule::prepareRule($container);
+
+ $onChange = $container->getAttribute('onchange');
+ $newHandler = sprintf('pfr_%s.validate();', $this->_id);
+ $container->setAttribute('onchange', $newHandler . $onChange);
+
+ return true;
+ }
+
+ /**
+ * method called by patForms or any patForms_Element to validate the
+ * element or the form.
+ *
+ * @access public
+ * @param object patForms form object
+ */
+ function applyRule(&$element, $type = PATFORMS_RULE_AFTER_VALIDATION) {
+
+ if (preg_match($this->_pattern, $element->getValue()) != 0){
+ return true;
+ }
+
+ $this->addValidationError(1);
+ return false;
+ }
+
+ /**
+ *
+ *
+ * @access public
+ */
+ function registerJavascripts(&$form) {
+
+ parent::registerJavascripts($form);
+
+ $script = sprintf("pfr_%s.setValue(%s);\n", $this->_id, $this->_pattern);
+ $form->registerInstanceJavascript($script);
+ }
+}
diff --git a/3rd_party/php/propel/contrib/pat/patForms/Rule/MaxLength.php b/3rd_party/php/propel/contrib/pat/patForms/Rule/MaxLength.php
new file mode 100644
index 000000000..d28c2f758
--- /dev/null
+++ b/3rd_party/php/propel/contrib/pat/patForms/Rule/MaxLength.php
@@ -0,0 +1,161 @@
+
+ * @license LGPL, see license.txt for details
+ * @link http://www.php-tools.net
+ */
+class patForms_Rule_MaxLength extends patForms_Rule
+{
+ /**
+ * script that will be displayed only once
+ *
+ * @access private
+ * @var array
+ */
+ var $globalScript = array(
+ 'html' => "/* patForms::Rule::MaxLength */
+
+function pFRC_MaxLength(field) {
+ this.field = eval('pfe_' + field);
+}
+
+pFRC_MaxLength.prototype.validate = function() {
+ value = this.field.getValue();
+ if (value.length > this.value) {
+ alert('Please enter a value that is max. ' + this.value + ' characters long.');
+ }
+}
+
+pFRC_MaxLength.prototype.setValue = function(value) {
+ this.value = value;
+}
+
+/* END: patForms::Rule::MaxLength */
+"
+ );
+
+ /**
+ * javascript that will be displayed once per instance
+ *
+ * @access private
+ * @var array
+ */
+ var $instanceScript = array(
+ 'html' => "var pfr_[RULE::ID] = new pFRC_MaxLength('[CONTAINER::NAME]');\n"
+ );
+
+ /**
+ * properties that have to be replaced in the instance script.
+ *
+ * @access private
+ * @var array
+ */
+ var $scriptPlaceholders = array(
+ 'RULE::SOURCE' => '_source',
+ );
+
+ /**
+ * name of the rule
+ *
+ * @abstract
+ * @access private
+ */
+ var $ruleName = 'MaxLength';
+
+ /**
+ * define error codes and messages for the rule
+ *
+ * @access private
+ * @var array $validatorErrorCodes
+ * @todo translate error messages
+ */
+ var $validatorErrorCodes = array(
+ "C" => array(
+ 1 => "Please enter a value that is max. [VALUE] characters long.",
+ ),
+ "de" => array(
+ 1 => "Bitte geben Sie einen max. [VALUE] Zeichen langen Wert ein.",
+ ),
+ "fr" => array(
+ 1 => "Please enter a value that is max. [VALUE] characters long.",
+ )
+ );
+
+ /**
+ * possible values
+ * @access private
+ * @var array
+ */
+ var $_values;
+
+ /**
+ * field id that is used
+ * @access private
+ * @var string
+ */
+ var $_field;
+
+ private $value = 10;
+
+ public function __construct($params) {
+
+ parent::__construct();
+
+ extract($params);
+ $this->value = $value;
+ }
+
+ /**
+ * prepare the rule
+ *
+ * @access public
+ * @param object patForms
+ */
+ function prepareRule(&$container) {
+
+ patForms_Rule::prepareRule($container);
+
+ $onChange = $container->getAttribute('onchange');
+ $newHandler = sprintf('pfr_%s.validate();', $this->_id);
+ $container->setAttribute('onchange', $newHandler . $onChange);
+
+ return true;
+ }
+
+ /**
+ * method called by patForms or any patForms_Element to validate the
+ * element or the form.
+ *
+ * @access public
+ * @param object patForms form object
+ */
+ function applyRule(&$element, $type = PATFORMS_RULE_AFTER_VALIDATION) {
+
+ if (strlen($element->getValue()) <= $this->value) {
+ return true;
+ }
+
+ $this->addValidationError(1, array('value' => $this->value));
+ return false;
+ }
+
+ /**
+ *
+ *
+ * @access public
+ */
+ function registerJavascripts(&$form) {
+
+ parent::registerJavascripts($form);
+
+ $script = sprintf("pfr_%s.setValue(%s);\n", $this->_id, $this->value);
+ $form->registerInstanceJavascript($script);
+ }
+}
diff --git a/3rd_party/php/propel/contrib/pat/patForms/Rule/MaxValue.php b/3rd_party/php/propel/contrib/pat/patForms/Rule/MaxValue.php
new file mode 100644
index 000000000..6b25b8c84
--- /dev/null
+++ b/3rd_party/php/propel/contrib/pat/patForms/Rule/MaxValue.php
@@ -0,0 +1,163 @@
+
+ * @license LGPL, see license.txt for details
+ * @link http://www.php-tools.net
+ */
+class patForms_Rule_MaxValue extends patForms_Rule
+{
+ /**
+ * script that will be displayed only once
+ *
+ * @access private
+ * @var array
+ */
+
+ var $globalScript = array(
+ 'html' => "/* patForms::Rule::MaxValue */
+
+function pFRC_MaxValue(field) {
+ this.field = eval('pfe_' + field);
+}
+
+pFRC_MaxValue.prototype.validate = function() {
+ value = this.field.getValue();
+ if (parseInt(value) != value) {
+ alert('Please enter a number that is less or equal to ' + this.value);
+ }
+ if (parseInt(value) > this.value) {
+ alert('Please enter a number that is less or equal to ' + this.value);
+ }
+}
+
+pFRC_MaxValue.prototype.setMaxValue = function(value) {
+ this.value = value;
+}
+
+/* END: patForms::Rule::MaxValue */
+"
+ );
+
+ /**
+ * javascript that will be displayed once per instance
+ *
+ * @access private
+ * @var array
+ */
+ var $instanceScript = array(
+ 'html' => "var pfr_[RULE::ID] = new pFRC_MaxValue('[CONTAINER::NAME]');\n"
+ );
+
+ /**
+ * properties that have to be replaced in the instance script.
+ *
+ * @access private
+ * @var array
+ */
+ var $scriptPlaceholders = array(
+ 'RULE::SOURCE' => '_source',
+ );
+
+ /**
+ * name of the rule
+ *
+ * @abstract
+ * @access private
+ */
+ var $ruleName = 'MaxValue';
+
+ /**
+ * define error codes and messages for the rule
+ *
+ * @access private
+ * @var array $validatorErrorCodes
+ * @todo translate error messages
+ */
+ var $validatorErrorCodes = array(
+ "C" => array(
+ 1 => "Please enter a number that is less or equal to [VALUE].",
+ ),
+ "de" => array(
+ 1 => "Bitte geben Sie eine Zahl kleiner oder gleich [VALUE] ein.",
+ ),
+ "fr" => array(
+ 1 => "Please enter a number that is less or equal to [VALUE].",
+ )
+ );
+
+ /**
+ * the regEx pattern
+ * @access private
+ * @var string
+ */
+ var $_value;
+
+ /**
+ * field id that is used
+ * @access private
+ * @var string
+ */
+ var $_field;
+
+ public function __construct($params) {
+
+ parent::__construct();
+
+ extract($params);
+ $this->_value = $value;
+ }
+
+ /**
+ * prepare the rule
+ *
+ * @access public
+ * @param object patForms
+ */
+ function prepareRule(&$container) {
+
+ patForms_Rule::prepareRule($container);
+
+ $onChange = $container->getAttribute('onchange');
+ $newHandler = sprintf('pfr_%s.validate();', $this->_id);
+ $container->setAttribute('onchange', $newHandler . $onChange);
+
+ return true;
+ }
+
+ /**
+ * method called by patForms or any patForms_Element to validate the
+ * element or the form.
+ *
+ * @access public
+ * @param object patForms form object
+ */
+ function applyRule(&$element, $type = PATFORMS_RULE_AFTER_VALIDATION) {
+
+ if (intval($element->getValue()) <= intval($this->_value)){
+ return true;
+ }
+
+ $this->addValidationError(1, array('value' => $this->_value));
+ return false;
+ }
+
+ /**
+ *
+ *
+ * @access public
+ */
+ function registerJavascripts(&$form) {
+
+ parent::registerJavascripts($form);
+
+ $script = sprintf("pfr_%s.setMaxValue(%s);\n", $this->_id, $this->_value);
+ $form->registerInstanceJavascript($script);
+ }
+}
diff --git a/3rd_party/php/propel/contrib/pat/patForms/Rule/MinLength.php b/3rd_party/php/propel/contrib/pat/patForms/Rule/MinLength.php
new file mode 100644
index 000000000..427600e49
--- /dev/null
+++ b/3rd_party/php/propel/contrib/pat/patForms/Rule/MinLength.php
@@ -0,0 +1,161 @@
+
+ * @license LGPL, see license.txt for details
+ * @link http://www.php-tools.net
+ */
+class patForms_Rule_MinLength extends patForms_Rule
+{
+ /**
+ * script that will be displayed only once
+ *
+ * @access private
+ * @var array
+ */
+ var $globalScript = array(
+ 'html' => "/* patForms::Rule::MinLength */
+
+function pFRC_MinLength(field) {
+ this.field = eval('pfe_' + field);
+}
+
+pFRC_MinLength.prototype.validate = function() {
+ value = this.field.getValue();
+ if (value.length < this.value) {
+ alert('Please enter a value that is at least ' + this.value + ' characters long.');
+ }
+}
+
+pFRC_MinLength.prototype.setValue = function(value) {
+ this.value = value;
+}
+
+/* END: patForms::Rule::MinLength */
+"
+ );
+
+ /**
+ * javascript that will be displayed once per instance
+ *
+ * @access private
+ * @var array
+ */
+ var $instanceScript = array(
+ 'html' => "var pfr_[RULE::ID] = new pFRC_MinLength('[CONTAINER::NAME]');\n"
+ );
+
+ /**
+ * properties that have to be replaced in the instance script.
+ *
+ * @access private
+ * @var array
+ */
+ var $scriptPlaceholders = array(
+ 'RULE::SOURCE' => '_source',
+ );
+
+ /**
+ * name of the rule
+ *
+ * @abstract
+ * @access private
+ */
+ var $ruleName = 'MinLength';
+
+ /**
+ * define error codes and messages for the rule
+ *
+ * @access private
+ * @var array $validatorErrorCodes
+ * @todo translate error messages
+ */
+ var $validatorErrorCodes = array(
+ "C" => array(
+ 1 => "Please enter a value that is at least [VALUE] characters long.",
+ ),
+ "de" => array(
+ 1 => "Bitte geben Sie einen mindestens [VALUE] Zeichen langen Wert ein.",
+ ),
+ "fr" => array(
+ 1 => "Please enter a value that is at least [VALUE] characters long.",
+ )
+ );
+
+ /**
+ * possible values
+ * @access private
+ * @var array
+ */
+ var $_values;
+
+ /**
+ * field id that is used
+ * @access private
+ * @var string
+ */
+ var $_field;
+
+ private $value = 10;
+
+ public function __construct($params) {
+
+ parent::__construct();
+
+ extract($params);
+ $this->value = $value;
+ }
+
+ /**
+ * prepare the rule
+ *
+ * @access public
+ * @param object patForms
+ */
+ function prepareRule(&$container) {
+
+ patForms_Rule::prepareRule($container);
+
+ $onChange = $container->getAttribute('onchange');
+ $newHandler = sprintf('pfr_%s.validate();', $this->_id);
+ $container->setAttribute('onchange', $newHandler . $onChange);
+
+ return true;
+ }
+
+ /**
+ * method called by patForms or any patForms_Element to validate the
+ * element or the form.
+ *
+ * @access public
+ * @param object patForms form object
+ */
+ function applyRule(&$element, $type = PATFORMS_RULE_AFTER_VALIDATION) {
+
+ if (strlen($element->getValue()) >= $this->value) {
+ return true;
+ }
+
+ $this->addValidationError(1, array('value' => $this->value));
+ return false;
+ }
+
+ /**
+ *
+ *
+ * @access public
+ */
+ function registerJavascripts(&$form) {
+
+ parent::registerJavascripts($form);
+
+ $script = sprintf("pfr_%s.setValue(%s);\n", $this->_id, $this->value);
+ $form->registerInstanceJavascript($script);
+ }
+}
diff --git a/3rd_party/php/propel/contrib/pat/patForms/Rule/MinValue.php b/3rd_party/php/propel/contrib/pat/patForms/Rule/MinValue.php
new file mode 100644
index 000000000..f31b107a4
--- /dev/null
+++ b/3rd_party/php/propel/contrib/pat/patForms/Rule/MinValue.php
@@ -0,0 +1,165 @@
+
+ * @license LGPL, see license.txt for details
+ * @link http://www.php-tools.net
+ */
+class patForms_Rule_MinValue extends patForms_Rule
+{
+ /**
+ * script that will be displayed only once
+ *
+ * @access private
+ * @var array
+ */
+
+ var $globalScript = array(
+ 'html' => "/* patForms::Rule::MinValue */
+
+function pFRC_MinValue(field) {
+ this.field = eval('pfe_' + field);
+}
+
+pFRC_MinValue.prototype.validate = function() {
+ value = this.field.getValue();
+ if (parseInt(value) != value) {
+ alert('Please enter a number that is greater or equal to ' + this.value);
+ }
+ if (parseInt(value) < this.value) {
+ alert('Please enter a number that is greater or equal to ' + this.value);
+ }
+}
+
+pFRC_MinValue.prototype.setMinValue = function(value) {
+ this.value = value;
+}
+
+/* END: patForms::Rule::MinValue */
+"
+ );
+
+ /**
+ * javascript that will be displayed once per instance
+ *
+ * @access private
+ * @var array
+ */
+ var $instanceScript = array(
+ 'html' => "var pfr_[RULE::ID] = new pFRC_MinValue('[CONTAINER::NAME]');\n"
+ );
+
+ /**
+ * properties that have to be replaced in the instance script.
+ *
+ * @access private
+ * @var array
+ */
+ var $scriptPlaceholders = array(
+ 'RULE::SOURCE' => '_source',
+ );
+
+ /**
+ * name of the rule
+ *
+ * @abstract
+ * @access private
+ */
+ var $ruleName = 'MinValue';
+
+ /**
+ * define error codes and messages for the rule
+ *
+ * @access private
+ * @var array $validatorErrorCodes
+ * @todo translate error messages
+ */
+ var $validatorErrorCodes = array(
+ "C" => array(
+ 1 => "Please enter a number that is greater or equal to [VALUE].",
+ ),
+ "de" => array(
+ 1 => "Bitte geben Sie eine Zahl größer oder gleich [VALUE] ein.",
+ ),
+ "fr" => array(
+ 1 => "Please enter a number that is greater or equal to [VALUE].",
+ )
+ );
+
+ /**
+ * the regEx pattern
+ * @access private
+ * @var string
+ */
+ var $_value;
+
+ /**
+ * field id that is used
+ * @access private
+ * @var string
+ */
+ var $_field;
+
+ private $value = 10;
+
+ public function __construct($params) {
+
+ parent::__construct();
+
+ extract($params);
+ $this->_value = $value;
+ }
+
+ /**
+ * prepare the rule
+ *
+ * @access public
+ * @param object patForms
+ */
+ function prepareRule(&$container) {
+
+ patForms_Rule::prepareRule($container);
+
+ $onChange = $container->getAttribute('onchange');
+ $newHandler = sprintf('pfr_%s.validate();', $this->_id);
+ $container->setAttribute('onchange', $newHandler . $onChange);
+
+ return true;
+ }
+
+ /**
+ * method called by patForms or any patForms_Element to validate the
+ * element or the form.
+ *
+ * @access public
+ * @param object patForms form object
+ */
+ function applyRule(&$element, $type = PATFORMS_RULE_AFTER_VALIDATION) {
+
+ if (intval($element->getValue()) >= intval($this->_value)){
+ return true;
+ }
+
+ $this->addValidationError(1, array('value' => $this->_value));
+ return false;
+ }
+
+ /**
+ *
+ *
+ * @access public
+ */
+ function registerJavascripts(&$form) {
+
+ parent::registerJavascripts($form);
+
+ $script = sprintf("pfr_%s.setMinValue(%s);\n", $this->_id, $this->_value);
+ $form->registerInstanceJavascript($script);
+ }
+}
diff --git a/3rd_party/php/propel/contrib/pat/patForms/Rule/NotMatch.php b/3rd_party/php/propel/contrib/pat/patForms/Rule/NotMatch.php
new file mode 100644
index 000000000..c0ff7f365
--- /dev/null
+++ b/3rd_party/php/propel/contrib/pat/patForms/Rule/NotMatch.php
@@ -0,0 +1,163 @@
+
+ * @license LGPL, see license.txt for details
+ * @link http://www.php-tools.net
+ */
+class patForms_Rule_NotMatch extends patForms_Rule
+{
+ /**
+ * script that will be displayed only once
+ *
+ * @access private
+ * @var array
+ */
+
+ var $globalScript = array(
+ 'html' => "/* patForms::Rule::NotMatch */
+
+function pFRC_NotMatch(field) {
+ this.field = eval('pfe_' + field);
+}
+
+pFRC_NotMatch.prototype.validate = function() {
+ value = this.field.getValue();
+ if (value.match(this.pattern)) {
+ alert('This is an invalid value.');
+ }
+}
+
+pFRC_NotMatch.prototype.setValue = function(pattern) {
+ this.pattern = pattern;
+}
+
+/* END: patForms::Rule::NotMatch */
+"
+ );
+
+ /**
+ * javascript that will be displayed once per instance
+ *
+ * @access private
+ * @var array
+ */
+ var $instanceScript = array(
+ 'html' => "var pfr_[RULE::ID] = new pFRC_NotMatch('[CONTAINER::NAME]');\n"
+ );
+
+ /**
+ * properties that have to be replaced in the instance script.
+ *
+ * @access private
+ * @var array
+ */
+ var $scriptPlaceholders = array(
+ 'RULE::SOURCE' => '_source',
+ );
+
+ /**
+ * name of the rule
+ *
+ * @abstract
+ * @access private
+ */
+ var $ruleName = 'NotMatch';
+
+ /**
+ * define error codes and messages for the rule
+ *
+ * @access private
+ * @var array $validatorErrorCodes
+ * @todo translate error messages
+ */
+ var $validatorErrorCodes = array(
+ "C" => array(
+ 1 => "This is an invalid value.",
+ ),
+ "de" => array(
+ 1 => "Dies ist ein ungültiger Wert.",
+ ),
+ "fr" => array(
+ 1 => "This is an invalid value.",
+ )
+ );
+
+ /**
+ * the regEx pattern
+ * @access private
+ * @var string
+ */
+ var $_pattern;
+
+ /**
+ * field id that is used
+ * @access private
+ * @var string
+ */
+ var $_field;
+
+ private $value = 10;
+
+ public function __construct($params) {
+
+ parent::__construct();
+
+ extract($params);
+ $this->_pattern = $value;
+ }
+
+ /**
+ * prepare the rule
+ *
+ * @access public
+ * @param object patForms
+ */
+ function prepareRule(&$container) {
+
+ patForms_Rule::prepareRule($container);
+
+ $onChange = $container->getAttribute('onchange');
+ $newHandler = sprintf('pfr_%s.validate();', $this->_id);
+ $container->setAttribute('onchange', $newHandler . $onChange);
+
+ return true;
+ }
+
+ /**
+ * method called by patForms or any patForms_Element to validate the
+ * element or the form.
+ *
+ * @access public
+ * @param object patForms form object
+ */
+ function applyRule(&$element, $type = PATFORMS_RULE_AFTER_VALIDATION) {
+
+ if (preg_match($this->_pattern, $element->getValue()) == 0){
+ return true;
+ }
+
+ $this->addValidationError(1);
+ return false;
+ }
+
+ /**
+ *
+ *
+ * @access public
+ */
+ function registerJavascripts(&$form) {
+
+ parent::registerJavascripts($form);
+
+ $script = sprintf("pfr_%s.setValue(%s);\n", $this->_id, $this->_pattern);
+ $form->registerInstanceJavascript($script);
+ }
+}
diff --git a/3rd_party/php/propel/contrib/pat/patForms/Rule/ValidValues.php b/3rd_party/php/propel/contrib/pat/patForms/Rule/ValidValues.php
new file mode 100644
index 000000000..290ace0ed
--- /dev/null
+++ b/3rd_party/php/propel/contrib/pat/patForms/Rule/ValidValues.php
@@ -0,0 +1,182 @@
+
+ * @license LGPL, see license.txt for details
+ * @link http://www.php-tools.net
+ */
+class patForms_Rule_ValidValues extends patForms_Rule
+{
+ /**
+ * script that will be displayed only once
+ *
+ * @access private
+ * @var array
+ */
+ var $globalScript = array(
+ 'html' => "/* patForms::Rule::ValidValues */
+
+Array.prototype.inArray = function(value) {
+ var i;
+ for (i=0; i < this.length; i++) {
+ if (this[i] === value) {
+ return true;
+ }
+ }
+ return false;
+};
+
+function pFRC_ValidValue(field) {
+ this.field = eval('pfe_' + field);
+}
+
+pFRC_ValidValue.prototype.validate = function() {
+ value = this.field.getValue();
+ for (var i = 0; i < this.values.length; i++) {
+ if (this.values[i] === value) {
+ return true;
+ }
+ }
+ var msg = 'Please enter one of the following values: ';
+ for (var i = 0; i < this.values.length; i++) {
+ msg = msg + this.values[i];
+ if (i < this.values.length - 1) {
+ msg = msg + ', ';
+ }
+ }
+ alert(msg);
+}
+
+pFRC_ValidValue.prototype.setValues = function(values) {
+ this.values = values;
+}
+
+/* END: patForms::Rule::ValidValue */
+"
+ );
+
+ /**
+ * javascript that will be displayed once per instance
+ *
+ * @access private
+ * @var array
+ */
+ var $instanceScript = array(
+ 'html' => "var pfr_[RULE::ID] = new pFRC_ValidValue('[CONTAINER::NAME]');\n"
+ );
+
+ /**
+ * properties that have to be replaced in the instance script.
+ *
+ * @access private
+ * @var array
+ */
+ var $scriptPlaceholders = array(
+ 'RULE::SOURCE' => '_source',
+ );
+
+ /**
+ * name of the rule
+ *
+ * @abstract
+ * @access private
+ */
+ var $ruleName = 'ValidValue';
+
+ /**
+ * define error codes and messages for the rule
+ *
+ * @access private
+ * @var array $validatorErrorCodes
+ * @todo translate error messages
+ */
+ var $validatorErrorCodes = array(
+ "C" => array(
+ 1 => "Please enter one of the following values: [VALUES].",
+ ),
+ "de" => array(
+ 1 => "Bitte geben Sie einen der folgenden Werte ein: [VALUES].",
+ ),
+ "fr" => array(
+ 1 => "Please enter one of the following values: [VALUES].",
+ )
+ );
+
+ /**
+ * possible values
+ * @access private
+ * @var array
+ */
+ var $_values;
+
+ /**
+ * field id that is used
+ * @access private
+ * @var string
+ */
+ var $_field;
+
+ public function __construct($params) {
+
+ parent::__construct();
+
+ extract($params);
+ $this->_values = explode('|', $value);
+ }
+
+ /**
+ * prepare the rule
+ *
+ * @access public
+ * @param object patForms
+ */
+ function prepareRule(&$container) {
+
+ patForms_Rule::prepareRule($container);
+
+ $onChange = $container->getAttribute('onchange');
+ $newHandler = sprintf('pfr_%s.validate();', $this->_id);
+ $container->setAttribute('onchange', $newHandler . $onChange);
+
+ return true;
+ }
+
+ /**
+ * method called by patForms or any patForms_Element to validate the
+ * element or the form.
+ *
+ * @access public
+ * @param object patForms form object
+ */
+ function applyRule(&$element, $type = PATFORMS_RULE_AFTER_VALIDATION) {
+
+ if (in_array($element->getValue(), $this->_values)) {
+ return true;
+ }
+
+ $this->addValidationError(1, array('values' => implode(', ', $this->_values)));
+ return false;
+ }
+
+ /**
+ *
+ *
+ * @access public
+ */
+ function registerJavascripts(&$form) {
+
+ parent::registerJavascripts($form);
+
+ foreach ($this->_values as $value) {
+ $values[] = "'$value'";
+ }
+ $script = sprintf("pfr_%s.setValues(new Array(%s));\n", $this->_id, implode(', ', $values));
+ $form->registerInstanceJavascript($script);
+ }
+}
diff --git a/3rd_party/php/propel/contrib/pat/patForms/Storage/Propel.php b/3rd_party/php/propel/contrib/pat/patForms/Storage/Propel.php
new file mode 100644
index 000000000..f90c81dbb
--- /dev/null
+++ b/3rd_party/php/propel/contrib/pat/patForms/Storage/Propel.php
@@ -0,0 +1,146 @@
+peer = new $peername();
+ $this->peername = $peername;
+
+ $parts = explode('.', explode('.', $this->peer->getOMClass()));
+ $this->classname = array_pop($parts);
+
+ $this->setPrimaryField('Id');
+ }
+
+ private function getCriteria($values) {
+
+ $object = new $this->classname();
+ //$object->populateFromArray($values); //TODO use a workaround until we'll get phpNamed keys in populateFromArray()
+ $object = $this->populateObjectFromArray($object, $values);
+ return $object->buildPkeyCriteria();
+ }
+
+ /**
+ * get an entry
+ *
+ * This tries to find an entry in the storage container
+ * that matches the current data that has been set in the
+ * form and populates the form with the data of this
+ * entry
+ *
+ * @access public
+ * @param object patForms patForms object that should be stored
+ * @return boolean true on success
+ */
+ public function loadEntry(&$form) {
+
+ if (!$object = $this->_entryExists($form->getValues())) {
+ // entry does not exists (why return an array here??)
+ return array();
+ }
+
+ $form->setValues($object->toArray());
+ return true;
+ }
+
+ public function validateEntry(&$form) {
+
+ if (!$object = $this->_entryExists($form->getValues())) {
+ $object = new $this->classname();
+ }
+ //$object->populateFromArray($form->getValues()); //TODO use a workaround until we'll get phpNamed keys in populateFromArray()
+ $object = $this->populateObjectFromArray($object, $form->getValues());
+ $result = $object->validate();
+
+ if ($result !== true) {
+ $mapBuilder = $this->peer->getMapBuilder();
+ $dbMap = $mapBuilder->getDatabaseMap();
+ foreach ($result as $colname => $error) {
+ list($tablename, $colname) = explode('.', $colname);
+ $column = $dbMap->getTable($tablename)->getColumn($colname);
+ $element = $form->getElement($column->getPhpName());
+ $element->addValidatorErrorCodes(array(
+ 'C' => array(
+ 1 => $error->getMessage() . ' (occured in Storage)',
+ ),
+ ), 1000);
+ $element->addValidationError(1001);
+ }
+ return false;
+ }
+ }
+
+ /**
+ * adds an entry to the storage
+ *
+ * @param object patForms patForms object that should be stored
+ * @return boolean true on success
+ */
+ public function _addEntry(&$form) {
+
+ $object = new $this->classname();
+ //$object->populateFromArray($form->getValues()); //TODO use a workaround until we'll get phpNamed keys in populateFromArray()
+ $object = $this->populateObjectFromArray($object, $form->getValues());
+ $object->save();
+ return true;
+ }
+
+ /**
+ * updates an entry in the storage
+ *
+ * @param object patForms patForms object that should be stored
+ * @return boolean true on success
+ */
+ public function _updateEntry(&$form, $primary) {
+
+ $object = $this->_entryExists($form->getValues());
+ //$object->populateFromArray($form->getValues()); //TODO use a workaround until we'll get phpNamed keys in populateFromArray()
+ $object = $this->populateObjectFromArray($object, $form->getValues());
+ $object->save();
+ return true;
+ }
+
+ /**
+ * check, whether an entry exists
+ *
+ * @access private
+ * @param array
+ */
+ public function _entryExists($values) {
+
+ // This method gets called multiple times, e.g. when an existing
+ // object gets updated. We'll therefor cache results locally using
+ // a criteria string representation as hash.
+
+ static $objects;
+ $criteria = $this->getCriteria($values);
+ $hash = $criteria->toString();
+
+ if (isset($objects[$hash])) {
+ return $objects[$hash];
+ }
+
+ $objects[$hash] = $this->peer->doSelectOne($criteria);
+
+ if (empty($objects[$hash])) {
+ return false;
+ }
+ return $objects[$hash];
+ }
+
+ // this method is just a workaround
+
+ private function populateObjectFromArray($object, $values) {
+
+ foreach (array_keys($object->toArray()) as $key) {
+ if (array_key_exists($key, $values)) {
+ $object->{'set' . $key}($values[$key]);
+ }
+ }
+ return $object;
+ }
+}
diff --git a/3rd_party/php/propel/contrib/pat/patForms/res/form.dynamic.tpl b/3rd_party/php/propel/contrib/pat/patForms/res/form.dynamic.tpl
new file mode 100644
index 000000000..3935ea6c1
--- /dev/null
+++ b/3rd_party/php/propel/contrib/pat/patForms/res/form.dynamic.tpl
@@ -0,0 +1,94 @@
+Sorry, your input could not be saved for the following reasons:
+
+ * $tmpl = new patTemplate();
+ * $tmpl->readTemplatesFromFile( 'myfile.tmpl' );
+ * echo $tmpl;
+ *
+ *
+ * @access private
+ * @return string
+ */
+ function __toString()
+ {
+ return $this->getParsedTemplate();
+ }
+}
diff --git a/3rd_party/php/propel/contrib/pear/HTML_QuickForm_Propel/Propel.php b/3rd_party/php/propel/contrib/pear/HTML_QuickForm_Propel/Propel.php
new file mode 100644
index 000000000..6a51e84fa
--- /dev/null
+++ b/3rd_party/php/propel/contrib/pear/HTML_QuickForm_Propel/Propel.php
@@ -0,0 +1,909 @@
+.
+ */
+
+require_once 'HTML/QuickForm.php';
+
+define('HTML_QUICKFORM_PROPEL_NO_COLUMNS', 2);
+define('HTML_QUICKFORM_PROPEL_ALL_COLUMNS', 3);
+define('HTML_QUICKFORM_PROPEL_COLUMN_MADE_VISIBLE', 4);
+define('HTML_QUICKFORM_PROPEL_COLUMN_MADE_HIDDEN', 5);
+
+/* On large foreign table resultsets propel choked */
+# ini_set('memory_limit', '50M');
+
+/**
+ *
+ * NOTE: HTML_QuickForm_Propel extends HTML_QuickForm, so all QuickForm functionality is available.
+ *
+ * A fictive example:
+ *
+ * $className = 'book';
+ * $id = '7'; // existing item
+ * $id = null; // when no id is passed, it's assumed we are creating a new item
+ *
+ * $quickForm = new HTML_QuickForm_Propel($className, $id); // optionally pass it to the constructor
+ * $quickForm->setAction('/Bookstore/Form');
+ * $quickForm->addElement('header', '', 'HTML_QuickForm_Propel');
+ * $quickForm->setId($id);
+ * $quickForm->setClassName($className);
+ * $quickForm->setTarget('_self');
+ * $quickForm->setMethod('post');
+ *
+ * // use this to override the default behaviour for
+ * // foreign table select boxes, UserPeer::UNAME will be shown in the select list.
+ * // It defaults to the first string column in the foreign table.
+ *
+ * $quickForm->joinColumn(bookPeer::PUBLISHER_ID,UserPeer::UNAME);
+ *
+ * // default to all columns shown
+ * $quickForm->setColumnMode(HTML_QUICKFORM_PROPEL_ALL_COLUMNS);
+ * $quickForm->hideColumn('PASS');
+ *
+ * // or default to no columns shown
+ * $quickForm->setColumnMode(HTML_QUICKFORM_PROPEL_NO_COLUMNS);
+ * $quickForm->showColumn('NAME'); // column name without table prefix.
+ * $quickForm->showColumn('UNAME');
+ * $quickForm->showColumn('USER_INFO');
+ * $quickForm->showColumn('EMAIL');
+ * $quickForm->showColumn('FEMAIL');
+ * $quickForm->showColumn('URL');
+ * $quickForm->showColumn('PASS');
+ *
+ * // generate the form
+ * $quickForm->build();
+ *
+ * // after the form is build, it's possible to modify the generated elements
+ * $quickForm->getElement('NAME')->setSize(10); // manually tune this element
+ *
+ * if ($quickForm->validate()) {
+ * $quickForm->freeze();
+ *
+ * // save the object we have editted
+ * $quickForm->save();
+ * } else {
+ * $quickForm->toHtml(); // or any other QuickForm render option
+ * }
+ *
+ * TODO: map all creoleTypes to usefull formelements
+ *
+ * @author Rob Halff $message
'; + } + + private function priorityToColor($priority) + { + switch($priority) { + case Propel::LOG_EMERG: + case Propel::LOG_ALERT: + case Propel::LOG_CRIT: + case Propel::LOG_ERR: + return 'red'; + break; + case Propel::LOG_WARNING: + return 'orange'; + break; + case Propel::LOG_NOTICE: + return 'green'; + break; + case Propel::LOG_INFO: + return 'blue'; + break; + case Propel::LOG_DEBUG: + return 'grey'; + break; + } + } +} +}}} + +Tip: There is also a bundled `MojaviLogAdapter` class which allows you to use a Mojavi logger with Propel. + +== Debugging Database Activity == + +By default, Propel uses `PropelPDO` for database connections. This class, which extends PHP's `PDO`, offers a debug mode to keep track of all the database activity, including all the executed queries. + +=== Enabling The Debug Mode === + +The debug mode is disabled by default, but you can enable it at runtime as follows: + +{{{ +#!php +useDebug(true); +}}} + +You can also disable the debug mode at runtime, by calling `PropelPDO::useDebug(false)`. Using this method, you can choose to enable the debug mode for only one particular query, or for all queries. + +Alternatively, you can ask Propel to always enable the debug mode for a particular connection by using the `DebugPDO` class instead of the default `PropelPDO` class. This is accomplished in the `runtime-conf.xml` file, in the `