developpeur
 24581 
|  Posté : 22-05-2006 23:59
Manuel d'utilisation de Sform
1: Les instructions
A placer dans le 'formulaire.php'
add_extra:
Les instructions add_extra permettent de rajouter directement des chaines de caractere dans le formulaire. On peut donc rajouter directement du code HTML dans ces champs, il sera transmis tel quel.
A noter qu'il semblerait que ces instructions ai un emplacement réservé en haut de la page de sorte qu'elles s'affichent toujours en haut de page, avant tout les autres champs.
==> attention SFORM manipule des tableaux pour sa présentation ... donc les add_extra doient tenir compte de cela (balise TD par exemple)
add_field:
1. Le premier champ de chaque instruction représente le nom de la variable sous la forme 'nomdevariable'.
2. Le 2eme champ représente la chaine de caractere qui sera affichée à l'écran. A noter qu'il faut séparer les différentes langues par des balises de la forme [french] [/french] suivant la langue dans laquelle est le texte saisi.
3. Ce champ comporte le nom de la variable sous la forme $nomdevariable
4. Ici est spécifié le type de variable saisie (text, textarea, ...)
5. La valeur "true", en 5eme position, signifie que le champ est obligatoire.
6. L'entier en 6eme position est la longueur maximale du champ (en caractere). Elle permet de se protéger des requetes SQL
7. utilisé dans les type TEXTAREA (ligne ou colonne je sais jamais ...)
8. Ce champ permet de délimiter les caracteres qui peuvent être utilisés. Par exemple, un "0_9" signifie que l'on ne pourra utiliser dans ce champ que des caractères qui sont compris entre 0 et 9 inclus.
remarque: les champs 6, 7 et 8 sont optionnels
add_comment:
Est utilisé pour rajouter des commentaires dans le code. Il semble qu'on puisse également y inclure des balises HTML, mais je n'ai pas bien compris le principe de fonctionnement.
add_radio:
Pour utiliser cette instruction, vous devez d'abord avoir créer une variable de type "array" qui comprendra les différents choix que vous voudrez avoir.
1: Le nom de la variable qui sera retournée par la fonction.
2: La chaine de caractère qui sera affichée avant le choix (généralement la question)
3: Le nom de la variable de type array que vous avez créé auparavant et qui comporte vos différents choix
4: Bolléen, True ou False afin de savoir si la case doit être cochée par défaut. (False pour qu'elle ne le soit pas)
add_select:
De la même facon que pour la fonction "add_radio", vous devez avoir créer une variable de type array pour utiliser cette fonction.
1: Nom de la variable qui sera retournée
2: Chaine de caractere qui sera affichée
3: Nom de la variable de type array que vous avez créé auparavant.
4: ?
5: Nombre de ligne qui sera affiché (si le champ n° 6 est a False)
6: ?
Instructions à placer dans le 'contact.php'
add_form_tittle:
Comme son nom l'indique, cette insctuction prend en paramètre une chaine de caratere, sous la forme "chaine", qui sera le nom du formulaire.
add_form_method:
Equivalent du tag method="" en HTML
add_form_check:
Permet de déterminer quelle bolleen permettra de désigner les champs obligatoires.
Par exemple, si on place un 'add_form_check("true")', tout les add_field qui auront en 6eme position le booléen 'true' seront vérifié, et si l'un d'eux n'est pas renseigné, le message entré dans le champ 'add_mess' sera affiché dans une boite de dialogue.
Si l'un de ces champs n'est pas rensigné, la page ne sera pas validée.
add_mess:
Prends en parametre une chaine de caractere qui s'affichera si l'un des champs spécifiés obligatoire n'est pas renseigné.
A noter que cette instruction est sujette à la même synthaxe que le 2eme champ de l'instruction add_field
add_submit_value:
Equiv alent du tag submit="" en HTML
add_url:
add_field:
2: Les variables
Sformret:
Cette variable est la valeur bolleenne du bouton de validation du formulaire. Je suppose pour le moment qu'elle vaut "true" lorsque le forumlaire est validé par l'utilisateur.
==> C'est en fait la même chose que dans un formulaire classique / ce n'est donc pas un booléen
PS : ta doc est globallement bonne mais demande à être relue ++ / Avec SFORM il y a quand même un PDF d'explication qui doit pouvoir servir de base de doc non ?
Bon boulot  |
