Index du Forum » » SFORM

Auteur

Un vrai tuto Sform
Anonyme
19853  

  Posté : 18-05-2006 16:06

Pour le moment j'en suis a ca, si y'a des trucs faut, corrigez moi, et si vous avez les réponses sur les "?" que j'ai laisser, je les veux bien aussi




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.
            
        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. ?
            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.
            
            remar que: 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 tpye 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:
            Equiv alent 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.




Cet article provient de NPDS

http://www.npds.org/viewtopic.php?topic=19965&forum=19