plugin Forms : création de formulaires

Documentation basique du plugin Forms pour son volet création de formulaires.

Il y a d’autres usages et possibilités (sondages et code avec unserialize), qui seront détaillés dans d’autres articles.

Installation et activation du plugin

Comme pour tous les plugins (voir Les plugins), vous avez installé ce plugin par ftp puis vous l’avez activé dans l’interface de gestion des plugins (Configuration > Gestion des Plugins > cocher la case « Formulaires ») :

Initialisation du formulaire

  1. Passez la souris sur « Edition » puis cliquez sur l’icône « Formulaires et sondages » ;
  2. Cliquez sur « Créer un nouveau formulaire » ;
  3. Donnez un titre, éventuellement un descriptif, et indiquez une adresse email où seront envoyées les réponses au formulaire rempli en ligne par vos utilisateurs ;
  4. choisissez « Ce formulaire n’est pas un sondage » (c’est le seul exemple abordé dans ce document) puis validez ; La validation initialise la création du formulaire. Vous pourrez ensuite aborder la seconde phase, celle de la définition des champs du formulaire.
  5. la même page s’affiche donc apres la validation, mais en bas vous trouverez un sélecteur des types de champs que vous pourrez afficher dans votre formulaire.

Création des champs de saisie

Choisissez les champs dont vous avez besoin, nommez les, puis ajoutez chaque élément, un par un ; voici le détail des champs possibles :

    1. ligne de texte crée un champ de saisie sur une seule ligne
    2. texte crée un champ de saisie sur plusieurs lignes
    3. adresse mail crée un champ de saisie d’adresse mail avec la mention « Veuillez entrer une adresse e-mail valide (de type vous@fournisseur.com) »
    4. adresse web crée un champ de saisie d’adresse web avec la mention "Veuillez entrer une adresse Web valide (de type http://www.monsite.com/...)". D’autre part, on peut choisir de vérifier la validité du site.
    5. choix unique insère un choix entre autant d’item que l’on souhaite de style « bouton radio » un seul bouton pourra être coché.
    6. choix multiple insère les classiques choix à cocher avec possibilités de plusieurs choix (cases carrées). Pour ces deux derniers types de champs, le changement est proposé après la création du champ pour transformation d’un type vers l’autre.
    7. fichier à télécharger permet à l’utilisateur de joindre un fichier. Le concepteur du formulaire fixe la taille maxi en ko du fichier.
    8. mots-clés ajoute automatiquement une liste de cases à cocher de type « choix multiples » correspondants à tous les mots-clés d’un groupe de mots-clés. Le choix entre les groupes de mots-clés est proposé au concepteur du formulaire. ex : j’ai un groupe de mots-clés nommé « Thématiques ». En choisissant ce groupe lors de la création du formulaire, j’insère automatiquement une série de cases à cocher avec tous les mots-clés de ce groupe, soit Communauté, Culture, Développement, Licences libres, Logiciels libres.
    9. nouveau bloc de questions crée un nouveau cadre qui entourera tous les champs qui suivront jusqu’à l’insertion d’un autre champ « bloc de questions »
    10. message d’explication insère un texte de votre choix, donc par exemple pour écrire vos questions ou commenter votre formulaire.

Il est possible de modifier l’ordre des champs en cliquant sur les flèches « monter » ou « descendre » en vis à vis de chacun.
Un apercu du formulaire est visible dans le cartouche, en cliquant sue le petit triangle devant APPARENCE DU FORMULAIRE

Lorsque vous avez intégré tous les composants souhaités , cliquez sur « Retour » en haut de la page. Votre formulaire est créé. Pour le publier il faut maintenant l’inclure dans un article

Vous insérez donc ce formulaire dans un article, à la manière d’une insertion d’image : lorsque vous créez ou modifiez un article, vos formulaires se trouvent à gauche de votre article et vous n’avez qu’à coller le code du formulaire voulu dans le corps de votre article (comme pour une image <img1>)
Ex : Dans ce site, <form1> inséré dans un article donnera le formulaire comme ceci : <form1>

Afficher un formulaire dans un squelette

Vous pouvez également afficher un formulaire directement dans les squelettes en utilisant la notation suivante :

[(#MODELE{form}{id_form=1})]

Afficher un sondage dans un squelette

Pour afficher un sondage, il faudra procéder en deux étapes et utiliser un <INCLURE> pour bien gérer le cache.

1) Créer un squelette par exemple sondage.html

#CACHE{0}
[(#MODELE{form}{id_form=1})]

2) Inclure ce squelette ou vous voulez (disons sur la page d’accueil)

<INCLURE{fond=sondage}>

Vous pouvez consulter les réponses que vos utilisateurs ont envoyées :

  • En consultant l’interface privé : en passant votre souris sur « Forum », puis sur « Suivi des réponses » (les réponses sont sur le même mode que les signatures des pétitions).
  • En recevant les réponses par email : Si vous avez indiqué une adresse mail dans la configuration de votre formulaire (plus haut), vous recevrez également le contenu du formulaire par mail (pour autant que votre serveur vous autorise à envoyer des mails).
  • En Exportant les réponses au format CSV : Vous avez également la possibilité de télécharger le fichier des données collectées au format csv pour excel. Sur la page Edition > Formulaire et sondage > Votre Formulaire : une fois que votre formulaire est publié et que vous avez collecté des réponses, apparait à gauche de l’interface de modification du formulaire, un bloc de consultation des réponses
    • > voir les réponses (consultation modération cf forum) -> télécharger les réponses (récupération de l’ensemble des données sous forme d’un fichier csv pour excel)

Récupérer les informations du formulaire dans une boucle

Vous pouvez récupérer les infos générales de vos formulaires en utilisant la boucle suivante :

<BOUCLE_formulaire(FORMS)>
#TITRE
</BOUCLE_formulaire>
  • Soit « FORMS » = le nom de la table
  • #TITRE = le titre du formulaire

Un exemple complet de l’utilisation des boucles de formulaires est visible dans le plugin, dans le squelette de génération du formulaire (formulaires/forms.html)

Les balises disponibles sont #DESCRIPTIF, #SONDAGE (attention ne sera plus supporté dans forms2), #EMAIL (données serialisées, non utilisable simplement), #CHAMPCONFIRM (nom du champ email dont la valeur est utilisee pour envoyer un mail de confirmation), et #TEXTE (texte pour l’envoi du mail de confirmation)

Pour accéder aux informations concernant les champs des formulaires, 2 autres boucles sont utilisées :

La boucle FORMS_CHAMPS permet d’acceder aux infos d’un champ :

<BOUCLE_champs(FORMS_CHAMPS){id_form}{par cle}>
[(#TYPE|=={ligne}|?{' ',''})
	<input type='text' name='#CHAMP' id='#CHAMP' value="" 
		class='[(#OBLIGATOIRE|=={oui}|?{forml,formo})]' size='40' />
]
</BOUCLE_champs>

Cet exemple simplifie issu de formulaires/forms_structure.html affiche l’input des champs de type ligne d’un formulaire

La boucle FORMS_CHAMPS_CHOIX permet d’acceder aux choix possibles pour un champ etendu de type choix multiple ou unique. Voici un autre exemple simplifié, issu de formulaires/forms_champs_multiple.html

<BOUCLE_f(FORMS){id_form}>
<BOUCLE_champs(FORMS_CHAMPS){id_form}{cle}> 
	<BOUCLE_choix(FORMS_CHAMPS_CHOIX){id_form}{cle}{par num titre,titre}>
	<span class='spip_form_choix_multiple'>
	&nbsp; <input type='checkbox' name='#CHAMP[]' id='#CHOIX' value='#CHOIX' />
	<label for='#CHOIX'>[(#TITRE|supprimer_numero)]</label>
	</span>
	</BOUCLE_choix>
</BOUCLE_champs>
</BOUCLE_f>

Récupération des données des formulaires créés via des boucles

Les réponses au formulaire sont elles stockées dans la table spip_reponses et spip_reponses_champs. Pour une réponse donnée, vous avez un enregistrement dans spip_reponses, associé a n enregistrements de spip_reponses_champs ayant le meme id_reponse. Donc vous pouvez éventuellement récupérer les réponses par des boucles sur ces tables. Toutefois, les données des champs de type choix ne sont pas stockées en clair mais en tant que numero de choix (à peu de choses près), et il faut utiliser les boucles decrites ci-dessus pour les interpreter.
Un exemple de squelette affichant une réponse en clair est fourni avec le plugin (forms_reponse.html, a la racine du plugin).
Ces boucles sont d’un niveau d’utilisation avancées du fait de leurs interdependances.

Exemple : afficher les données lors du retour de validation d’un formulaire
Dans cet exemple on cherche à afficher les données d’un formulaire dans une page article lorsque l’utilisateur vient de valider un formulaire intégré dans un article avec le modèle <formXX>.
Pour cela on modifie le squelette article.html en ajoutant à l’endroit où doivent apparaître les résultats (par ex. juste après la balise #TEXTE l’un des deux exemples suivant :

  • Premier exemple : afficher les données qui viennent d’êtres saisies par l’utilisateur :
    <BOUCLE_feinte(ARTICLES){0,1}>[(#ENV{ajout_reponse}|?{' ',''})]</BOUCLE_feinte>
    <br><strong>Affiche les donn&eacute;es qui viennent d'&egrave;tres remplies:</strong><br>
        <BOUCLE_reponses(FORMS_DONNEES){id_donnee}>
            <BOUCLE_champs(FORMS_CHAMPS){id_form}{par rang}>
            #TITRE : <span class='#_reponses:EDIT{#CHAMP}'>#LESVALEURS{','}</span>
            </BOUCLE_champs>
        </BOUCLE_reponses>
    </B_feinte>
  • Deuxième exemple : afficher l’ensemble des données saisies pour ce formulaire :
    <BOUCLE_feinte(ARTICLES){0,1}>[(#ENV{ajout_reponse}|?{' ',''})]</BOUCLE_feinte>
    <br><strong>Affiche l'ensemble des donn&eacute;es saisies:</strong><br>
        <BOUCLE_reponses2(FORMS_DONNEES){par id_donnee}>
            R&eacute;ponse #ID_DONNEE:<br>
            <BOUCLE_champs2(FORMS_CHAMPS){id_form=#ENV{ajout_reponse}}{par rang}>
            #TITRE : <span class='#_reponses:EDIT{#CHAMP}'>#LESVALEURS{','}</span><br>
            </BOUCLE_champs2>
            <br>
        </BOUCLE_reponses2>
    </B_feinte>

    Note : dans les 2 cas on utilise une BOUCLE_feinte qui permet de tester la présence du critère d’environnement ajout_reponse pour n’afficher les résultats que si la page est chargée en retour d’une validation du formulaire. Pour plus d’infos sur les boucles feintes, voir le paragraphe « Parties optionnelles des balises » dans cet article : http://www.weblog.eliaz.fr/article6...

Utiliser la fonctionnalité de liaison (dépendance) entre plusieurs formulaires

Il est possible de rendre un formulaire dépendant du remplissage d’un autre formulaire : c’est le rôle du champ « Formulaires obligatoires pour la saisie de celui-ci » de l’onglet Propriété d’un formulaire.
Cette fonctionnalité permet typiquement de faire quelque chose du style :

  • l’utilisateur arrive sur un article qui présente un premier formulaire (<form1> pour cet exemple) : il le rempli et le valide.
  • une fois cette validation faite, l’article se ré-affiche avec un deuxième formulaire (<form2> par ex.) qu’il peut alors remplir (le premier formulaire n’est plus visible).
  • une fois celui-ci validé, un troisième formulaire s’affiche (<form3>).

Mode opératoire :

  • créer les 3 formulaires
  • dans le champ Formulaires obligatoires pour la saisie de celui-ci de <form2>, on indique 1 (le numéro du formulaire de l’étape 1).
  • dans le champ Formulaires obligatoires pour la saisie de celui-ci de <form3>, on indique 1,2 (le numéro du formulaire de l’étape 1 et de celui de l’étape 2, séparés par une virgule).
  • Créer l’article qui contiendra l’enchaînement de ces 3 formulaires (un seul article), et mettre dans le texte de celui-ci <form3> uniquement !
    L’idée c’est que pour que <form3> s’affiche, il sera nécessaire d’avoir rempli <form1> puis <form2>, qui seront automatiquement insérés à la place de <form3> l’un après l’autre. Il ne faut donc pas faire d’appel direct au modèles <form1> et <form2>.

Remarques

  • si vous voulez que vos tests fonctionnent, il est nécessaire de vider les données saisies liées à votre compte utilisateur pour les 2 premiers formulaires et de supprimer les cookies spipcookie_form_1 et spipcookie_form_2 avant chaque essai (installez firecookie en plus de Firebug dans votre FireFox afin de simplifier cette opération).
  • apparament il doit y avoir un léger problème dans la prise en compte de l’étape qui vient d’être validée puisqu’en réalité, lorsque l’article est réaffiché à la validation d’un formulaire, il est nécessaire de recharger la page pour que le formulaire suivant apparaisse (recalcul pas nécessaire, simplement rechargement de la page)... Et cela même avec un #CACHE{0} dans le squelette de l’article qui contient les formulaires.
    Si vous avez des infos pour contourner ce problème, merci de laisser un message dans le forum attaché à cet article !

La version pour spip 1.9.1 est disponible en telechargement sur la zone.

Spip 1.9.2

La nouvelle version du plugin s’appelle forms&tables. Elle est compatible 1.9.1 & 1.9.2, et est en téléchargement ici

Spip 2.0

Une nouvelle version du plugin pour SPIP 2.0 est désormais disponible : Forms&Tables 2.0

Discussion

332 discussions

  • salut,
    un p’tit mot pour dire qu’interface.js qui est intégré au "plugin spip" forms&tables rentre en conflits avec d’autre "plugins « que » jQuery" (Tooltips "seul" par expl, Tabs et History idem) a+ had

    Répondre à ce message

  • Je confirme, il y a une erreur avec spip 1.9.2 (alors que ca fonctionnait sous 1.9.1). Au moment de l’ajout d’un formulaire rien ne se passe : rien ne s’ajoute. Il n’est plus possible de créer d’autre formulaire. On peux choisit tout les options du form, mais il n’apparait jamais dans la liste.

    Répondre à ce message

  • 6

    Bonjour,
    super plugins bien pratique !
    Par contre il ne semble pas fonctionner sur la version 1.9.2 de spip :-(

    • Si bien sur, ce plugin fonctionne parfaitement sur les versions 1.9.1 et 1.9.2.

      Attention cependant, avec SPIP 1.9.1 il faut le plugin jQuery, mais pas avec SPIP 1.9.2 car jQuery est inclus dans SPIP 1.9.2

    • j’ai peut être faux quelque part...
      je vais tester ça avec une installation toute fraiche de spip 1.9.2

    • je confirme ça ne fonctionne pas sur spip 1.9.2 (en tout cas chez moi)

    • on peut continuer longtemps comme ca :)
      Je te confirme que le plugin marche et doit marcher en SPIP 1.9.2.

      Si il y a un probleme chez toi, il ne suffit pas de dire ’ca marche pas avec 1.9.2’ puisque il est concu pour marcher avec, et qu’il ya des preuves.

      Il faut chercher la cause. En commencant par enlever tous les autres plugins pour verifier que ca ne vient pas d’un autre plugin activé. Et sinon envoie moi un détail de ta configuration, et les symptomes exacts, car pour faire un correctif, encore faut il savoir ce qui ne fonctionne pas. Envoie moi ca par mail, pas la peine de polluer le forum avec ca, tu pourras toujours mettre un résumé une fois résolu

    • ziolive

      Idem pour moi. 1.9.1 ok et en 1.9.2 [8782] la création de formulaire ne se valide pas.
      J’essai d’en créer un, quand je fait « valider », ya rien qui se passe.

      cela concerne le plugin « Formulaires (SPIP 1.9.1 +) »,
      J’ai :
      -  supprimé tous les autres plugins,
      -  vérifié les droits sur les fichiers du plugin,
      -  testé en local et en ligne...

      Rien à faire

      le plugin « Formulaires&Tables (SPIP 1.9.1+) » marche beaucoup mieux mais il me fait une erreur PHP « Warning : implode() : Bad arguments » pour le fichier « inc/forms.php on line 753 ».
      Ceci est peut-être dût à ma version de PHP/4.4.2-1.1 ?

    • Hmmmm .. je te trouve un brin énervé.
      J’ai l’impression qu’on est un certain nombre à rencontre le même problème de ce type :

      Fatal error : Call to undefined function : calculer_action_auteur() in /home.10.6/shaolint/www/plugins/Forms/inc/forms.php on line 479

      Et ce, malgrès la désactivation de tous les autres plugins... :-(

      Bien dommage pour un plugin si utile et bien fait .

    Répondre à ce message

  • 1
    wisegolem

    J’utilisai forms1_9 sans problèmes. Etant passé hier sous SPIP1.9.2, j’ai désinstallé le plug-in (décochage puis suppression du repertoire par FTP) et réinstallation de forms1_9_1 (installation par FTP puis cochage).

    Lorsque je veux me rendre sur formulaires et sondages, j’obtiens

    Fatal error : Call to undefined function : spip_create_table() in /home/fdfr/www/plugins/forms_1_9_1/base/forms_temporaire.php on line 92

    Merci de m’aider à retrouver ce plug-in si utile !

    • wisegolem

      Petite précisions peut être utiles :

      seul le plug-in « Archives » était installé. J’ai testé en désactivant ce plug-in (mais pas en le désinstallant) : même message d’erreur.

    Répondre à ce message

  • Bonjour,
    merci pour ce plugin,
    j’ai traduit le fichier de langue en occitan (languedocien) pour adapter le plugin à mon site,
    mais quand le visiteur renseigne le formulaire et valide, il obtient

    Vòstra responsa es registrada. Un messatge de confirmacion se manda a blabla@blabla.org validation de la saisie

    je ne sais pas où modifier ce message « validation de la saisie »

    Répondre à ce message

  • J’ai fait la mise à jour de spip 1.9.2 et depuis mes formulaires n’apparaissent plus dans l’admin.

    Depuis le site si je réponds au formulaire j’ai la réponse suivante

    calculer_action_auteur() plugins/forms/inc/forms.php on line 474

    Merci pour votre aide ....

    Répondre à ce message

  • Bonjour,

    l’utilisation de ce plugin est un véritable bonheur pour les grands débutants. Merci.

    Juste un pb : depuis son activation, les forums de chaque article ne fonctionnent plus (y compris lorsqu’il n’y a pas de formulaires insérés). J’ai l’affichage d’un message d’erreur : Fichier inc/safehtml introuvable.

    Est-ce qqn aurait rencontré ce pb et pourrait m’aider ?

    Merci

    Répondre à ce message

  • 1

    Bonjour,

    je n’arrive plus à le faire fonctionner. Je désactive le plugin, le réactive, je l’ai même supprimer de la BDD, mais je n’arrive pas à revenir à la solution initiale, càd une table sql sans « forms ». Quels sont les fichiers à effacer, modifier, remplacer pour retrouver ma bdd spip de départ ?

    • Jérémy Lecour

      Bonjour,

      Je ne connais pas encore à fond ce super plugin, mais je suis habitué aux bases de données. Ce n’est pas en supprimant un fichier que tu supprimeras des champs dans une base.
      Pour cela il faut qu’il y ait une commande SQL qui soit envoyée au serveur afin qu’il supprime ces champs/tables.
      C’est toute la difficulté des systèmes de plugins qui savent souvent se détruire eux-mêmes mais pas toujours détruire ce qu’ils ont ajouté dans les bases. D’ailleurs c’est pas toujours souhaitable, donc au moment de désinstaller il faudrait pouvoir choisir si on supprime aussi les champs/tables dans les bases ou non, ... bref un joyeux bordel.

    Répondre à ce message

  • Tout simplement un excellent plugin, sinon petite question : est-il possible d’inserer le formulaire dans une page rubrique ?
    Merci

    Répondre à ce message

  • JM Carton

    Bonjour
    Bravo pour ce très bon plugin qui rend bien des services.. Un petit problème... J’utilise la dernière version 1.9.1 ... Quand je suis dans l’interface privée et que je clique sur le bouton « Afficher » du plugin, j’ai le message d’erreur suivant :
    Fatal error : Call to undefined function : autoriser() in /home/apache/htdocs/www.ien-conflans.ac-versailles.fr/plugins/forms_et_tables_1_9_1/exec/template/tables_affichage.php on line 106

    Quand j’ouvre le susdit fichier j’obtiens à lal ligne 106 ceci :
    if (autoriser(’administrer’,’form’,$id_form))
    $retour = urlencode(self()) ;

    Je ne peux donc que récupérer les données par téléchargement au format csv. Dans la version précédente j’avais accès à l’affichage des données. Merci pour les pistes possibles.

    Répondre à ce message

Ajouter un commentaire

Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :

  • Désactiver tous les plugins que vous ne voulez pas tester afin de vous assurer que le bug vient bien du plugin X. Cela vous évitera d’écrire sur le forum d’une contribution qui n’est finalement pas en cause.
  • Cherchez et notez les numéros de version de tout ce qui est en place au moment du test :
    • version de SPIP, en bas de la partie privée
    • version du plugin testé et des éventuels plugins nécessités
    • version de PHP (exec=info en partie privée)
    • version de MySQL / SQLite
  • Si votre problème concerne la partie publique de votre site, donnez une URL où le bug est visible, pour que les gens puissent voir par eux-mêmes.
  • En cas de page blanche, merci d’activer l’affichage des erreurs, et d’indiquer ensuite l’erreur qui apparaît.

Merci d’avance pour les personnes qui vous aideront !

Par ailleurs, n’oubliez pas que les contributeurs et contributrices ont une vie en dehors de SPIP.

Qui êtes-vous ?
[Se connecter]

Pour afficher votre trombine avec votre message, enregistrez-la d’abord sur gravatar.com (gratuit et indolore) et n’oubliez pas d’indiquer votre adresse e-mail ici.

Ajoutez votre commentaire ici

Ce champ accepte les raccourcis SPIP {{gras}} {italique} -*liste [texte->url] <quote> <code> et le code HTML <q> <del> <ins>. Pour créer des paragraphes, laissez simplement des lignes vides.

Ajouter un document

Suivre les commentaires : RSS 2.0 | Atom