*/ class LSformElement { var $name; var $label; var $params; var $values = array(); var $_required = false; var $_freeze = false; var $attr_html; var $fieldTemplate = 'LSformElement_field.tpl'; var $template = 'LSformElement.tpl'; var $fetchVariables = array(); /** * Constructeur * * Cette methode construit l'objet et définis sa configuration de base. * * @author Benjamin Renard * * @param[in] &$form [required] LSform L'objet LSform parent * @param[in] $name [required] string Le nom de référence de l'élément * @param[in] $label [required] string Le label de l'élément * @param[in] $params mixed Paramètres supplémentaires * * @retval true */ function LSformElement (&$form, $name, $label, $params,&$attr_html){ $this -> name = $name; $this -> label = $label; $this -> params = $params; $this -> form = $form; $this -> attr_html = $attr_html; return true; } /** * Définis la valeur de l'élément * * Cette méthode définis la valeur de l'élément * * @author Benjamin Renard * * @param[in] [required] string or array La futur valeur de l'élément * * @retval boolean Retourne True */ function setValue($data) { if (!is_array($data)) { $data=array($data); } $this -> values = $data; return true; } /** * Définis la valeur de l'élément à partir des données * envoyées en POST du formulaire * * Cette méthode définis la valeur de l'élément à partir des données * envoyées en POST du formulaire. * * @author Benjamin Renard * * @param[in] [required] string or array La futur valeur de l'élément * * @retval boolean Retourne True */ function setValueFromPostData($data) { if (!is_array($data)) { $data=array($data); } $this -> values = $data; return true; } /** * Exporte les valeurs de l'élément * * @retval Array Les valeurs de l'élement */ function exportValues(){ return $this -> values; } /** * Ajoute une valeur à l'élément * * Cette méthode ajoute une valeur à l'élément * * @author Benjamin Renard * * @param[in] [required] string or array La futur valeur de l'élément * * @retval void */ function addValue($data) { if (is_array($data)) { $this -> values = array_merge($this -> values, $data); } else { $this -> values[] = $data; } } /** * Test si l'élément est éditable * * Cette méthode test si l'élément est éditable * * @retval boolean */ function isFreeze(){ return $this -> _freeze; } /** * Freeze l'élément * * Rend l'élément non-editable * * @retval void */ function freeze() { $this -> _freeze = true; } /** * Défini la propriété required de l'élément. * * param[in] $isRequired boolean true si l'élément est requis, false sinon * * @retval void */ function setRequired($isRequired=true) { $this -> _required = $isRequired; } /** * Test si l'élément est requis * * Cette méthode test si l'élément est requis * * @retval boolean */ function isRequired(){ return $this -> _required; } /** * Retourne le label de l'élement * * @retval void */ function getLabelInfos() { if ($this -> isRequired()) { $return['required']=true; } $return['label'] = $this -> getLabel(); if (isset($this -> params['help_info'])) { $return['help_info']=$this -> params['help_info']; } return $return; } /** * Recupère la valeur de l'élement passée en POST * * Cette méthode vérifie la présence en POST de la valeur de l'élément et la récupère * pour la mettre dans le tableau passer en paramètre avec en clef le nom de l'élément * * @param[] array Pointeur sur le tableau qui recupèrera la valeur. * * @retval boolean true si la valeur est présente en POST, false sinon */ function getPostData(&$return) { if($this -> isFreeze()) { return true; } if (isset($_POST[$this -> name])) { $return[$this -> name]=array(); if(!is_array($_POST[$this -> name])) { $_POST[$this -> name] = array($_POST[$this -> name]); } foreach($_POST[$this -> name] as $key => $val) { if (!empty($val)) { $return[$this -> name][$key] = $val; } } return true; } else { $return[$this -> name] = array(); return true; } } /** * Retourne le label de l'élement * * Retourne $this -> label, ou $this -> params['label'], ou $this -> name * * @retval string Le label de l'élément */ function getLabel() { if ($this -> label != "") { return $this -> label; } else if ($this -> params['label']) { return $this -> params['label']; } else { return $this -> name; } } /** * Le champ est-il a valeur multiple * * @retval boolean True si le champ est à valeur multiple, False sinon */ function isMultiple() { return ($this -> params['multiple'] == true); } /** * Retournne un template Smarty compilé dans le contexte d'un LSformElement * * @param[in] string $template Le template à retourner * @param[in] array $variables Variables Smarty à assigner avant l'affichage * * @retval string Le HTML compilé du template */ function fetchTemplate($template=NULL,$variables=array()) { if (!$template) { $template = $this -> template; } return LSsession :: fetchTemplate( $template, array_merge_recursive( $variables, $this -> fetchVariables, array( 'freeze' => $this -> isFreeze(), 'multiple'=> $this -> isMultiple(), 'value' => '', 'values' => $this -> values, 'attr_name' => $this -> name, 'noValueTxt' => _('Aucune valeur definie'), 'fieldTemplate' => $this -> fieldTemplate ) ) ); } /** * Retourne le code HTML d'un champ vide * * @retval string Code HTML d'un champ vide. */ function getEmptyField() { return $this -> fetchTemplate($this -> fieldTemplate); } } ?>