*/ class LSform { var $ldapObject; var $idForm; var $can_validate = true; var $elements = array(); var $_rules = array(); var $_postData = array(); var $_elementsErrors = array(); var $_isValidate = false; var $_notUpdate = array(); /** * Constructeur * * Cette methode construit l'objet et définis la configuration. * * @author Benjamin Renard * * @param[in] $idForm [required] string L'identifiant du formulaire * @param[in] $submit string La valeur du bouton submit * * @retval void */ function LSform (&$ldapObject,$idForm,$submit="Envoyer"){ $this -> idForm = $idForm; $this -> submit = $submit; $this -> ldapObject = $ldapObject; $GLOBALS['LSsession'] -> loadLSclass('LSformElement'); } /** * Affiche le formualaire * * @author Benjamin Renard * * @retval void */ function display(){ $GLOBALS['LSsession'] -> addJSscript('LSform.js'); $GLOBALS['LSsession'] -> addCssFile('LSform.css'); $GLOBALS['Smarty'] -> assign('LSform_action',$_SERVER['PHP_SELF']); $LSform_header = "\t\n\t\n\t\n"; $GLOBALS['Smarty'] -> assign('LSform_header',$LSform_header); $fields = array(); foreach($this -> elements as $element) { $field = array(); $field = $element -> getDisplay(); if (isset($this -> _elementsErrors[$element -> name])) { $field['errors']= $this -> _elementsErrors[$element -> name]; } $fields[] = $field; } $GLOBALS['Smarty'] -> assign('LSform_fields',$fields); if($this -> can_validate) { $GLOBALS['Smarty'] -> assign('LSform_submittxt',$this -> submit); } } /** * Défini l'erreur sur un champ * * @author Benjamin Renard * * @param[in] $attr [required] string Le nom du champ * @param[in] $msg Le format du message d'erreur à afficher (pouvant comporter * des valeurs %{[n'importe quoi]} qui seront remplacé par le label * du champs concerné. * * @retval void */ function setElementError($attr,$msg=NULL) { if($msg!='') { $msg_error=getFData($msg,$attr->getLabel()); } else { $msg_error=getFData(_("Les données pour l'attribut %{label} ne sont pas valides."),$attr->getLabel()); } $this -> _elementsErrors[$attr->name][]=$msg_error; } /** * Verifie si le formulaire a été validé et que les données sont valides. * * @author Benjamin Renard * * @retval boolean true si le formulaire a été validé et que les données ont été validées, false sinon */ function validate(){ if(!$this -> can_validate) return; if ($this -> isSubmit()) { if (!$this -> getPostData()) { $GLOBALS['LSerror'] -> addErrorCode(201); return; } //Validation des données ici !!! /// if (!$this -> checkData()) { $this -> setValuesFromPostData(); return; } debug("les données sont checkées"); $this -> _isValidate = true; return true; } return false; } /** * Vérifier les données du formulaire à partir des régles définis sur les champs * * @author Benjamin Renard * * @retval boolean true si toutes la saisie est OK, false sinon */ function checkData() { $retval=true; foreach ($this -> _postData as $element => $values) { if(!is_array($values)) { $values=array($values); } if ($this -> elements[$element] -> isRequired()) { if (!$this -> checkRequired($values)) { $this -> setElementError($this -> elements[$element],_("Champ obligatoire")); $retval=false; } } foreach($values as $value) { if (empty($value)) { continue; } if (!is_array($this -> _rules[$element])) continue; $GLOBALS['LSsession'] -> loadLSclass('LSformRule'); foreach($this -> _rules[$element] as $rule) { $ruleType="LSformRule_".$rule['name']; $GLOBALS['LSsession'] -> loadLSclass($ruleType); if (! call_user_func(array( $ruleType,'validate') , $value, $rule['options'])) { $retval=false; $this -> setElementError($this -> elements[$element],$rule['options']['msg']); } } } } return $retval; } /** * Vérifie si au moins une valeur est présente dans le tableau * * @author Benjamin Renard * * @param[in] $data array tableau de valeurs * * @retval boolean true si au moins une valeur est présente, false sinon */ function checkRequired($data) { foreach($data as $val) { if (!empty($val)) return true; } return; } /** * Verifie si la saisie du formulaire est présente en POST * * @author Benjamin Renard * * @retval boolean true si la saisie du formulaire est présente en POST, false sinon */ function isSubmit() { if( (isset($_POST['validate']) && ($_POST['validate']=='LSform')) && (isset($_POST['idForm']) && ($_POST['idForm'] == $this -> idForm)) ) return true; return; } /** * Récupère les valeurs postées dans le formulaire * * @author Benjamin Renard * * @retval boolean true si les valeurs ont bien été récupérées, false sinon. */ function getPostData() { foreach($this -> elements as $element_name => $element) { if( !($element -> getPostData($this -> _postData)) ) { $GLOBALS['LSerror'] -> addErrorCode(202,$element_name); return; } } return true; } /* * Ajoute un élément au formulaire * * Ajoute un élément au formulaire et définis les informations le concernant. * * @param[in] $type string Le type de l'élément * @param[in] $name string Le nom de l'élément * @param[in] $label string Le label de l'élément * @param[in] $param mixed Paramètres supplémentaires * * @retval LSformElement */ function addElement($type,$name,$label,$params=array()) { $elementType='LSformElement_'.$type; $GLOBALS['LSsession'] -> loadLSclass($elementType); if (!class_exists($elementType)) { $GLOBALS['LSerror'] -> addErrorCode(205,array('type' => $type)); return; } $element=$this -> elements[$name] = new $elementType($this,$name,$label,$params); if ($element) { return $element; } else { unset ($this -> elements[$name]); $GLOBALS['LSerror'] -> addErrorCode(206,array('element' => $name)); return; } } /* * Ajoute une règle sur un élément du formulaire * * @author Benjamin Renard * * @param[in] $element string Le nom de l'élément conserné * @param[in] $rule string Le nom de la règle à ajouter * @param[in] $options array Options (facultative) * * @retval boolean */ function addRule($element, $rule, $options=array()) { if ( isset($this ->elements[$element]) ) { if ($this -> isRuleRegistered($rule)) { $this -> _rules[$element][]=array( 'name' => $rule, 'options' => $options ); return true; } else { $GLOBALS['LSerror'] -> addErrorCode(43,array('attr' => $element,'rule'=>$rule)); return; } } else { $GLOBALS['LSerror'] -> addErrorCode(204,array('element' => $element)); return; } } /* * Définis comme requis un élément * * @author Benjamin Renard * * @param[in] $element string Le nom de l'élément conserné * * @retval boolean */ function setRequired($element) { if (isset( $this -> elements[$element] ) ) return $this -> elements[$element] -> setRequired(); else return; } /* * Détermine la valider de la règle * * Devra déterminer si la règle passez en paramètre est correcte * * @author Benjamin Renard * * @param[in] $element string Le nom de l'élément conserné */ function isRuleRegistered($rule) { $GLOBALS['LSsession'] -> loadLSclass('LSformRule'); $GLOBALS['LSsession'] -> loadLSclass('LSformRule_'.$rule); return class_exists('LSformRule_'.$rule); } /** * Retourne les valeurs validés du formulaire * * @retval mixed Les valeurs validés du formulaire, ou false si elles ne le sont pas */ function exportValues() { if ($this -> _isValidate) { return $this -> _postData; } else { return; } } /** * Retourn un élement du formulaire * * @param[in] string $element Nom de l'élement voulu * * @retval LSformElement L'élement du formulaire voulu */ function getElement($element) { return $this -> elements[$element]; } /** * Défini les valeurs des élements à partir des valeurs postées * * @retval boolean True si les valeurs ont été définies, false sinon. */ function setValuesFromPostData() { if (empty($this -> _postData)) { return; } foreach($this -> _postData as $element => $values) { $this -> elements[$element] -> setValue($values); } return true; } /** * Retourne le code HTML d'un champ vide. * * @param[in] string Le nom du champ du formulaire * * @retval string Le code HTML du champ vide. */ function getEmptyField($element) { $element = $this -> getElement($element); if ($element) { return $element -> getEmptyField(); } else return; } } ?>