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
- Passez la souris sur « Edition » puis cliquez sur l’icône « Formulaires et sondages » ;
- Cliquez sur « Créer un nouveau formulaire » ;
- 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 ;
- 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.
- 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 :
-
- ligne de texte crée un champ de saisie sur une seule ligne
- texte crée un champ de saisie sur plusieurs lignes
- 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) »
- 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.
- choix unique insère un choix entre autant d’item que l’on souhaite de style « bouton radio » un seul bouton pourra être coché.
- 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.
- fichier à télécharger permet à l’utilisateur de joindre un fichier. Le concepteur du formulaire fixe la taille maxi en ko du fichier.
- 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.
- 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 »
- 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'>
<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ées qui viennent d'è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ées saisies:</strong><br> <BOUCLE_reponses2(FORMS_DONNEES){par id_donnee}> Ré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 !
Discussions par date d’activité
332 discussions
Bonjour et Merci pour ce plugin.
Afin de faire migrer un site d’une adresse vers une autre, j’ai sauvegardé puis restauré une base de données, en prenant soin d’y incorporer le plugin Forms et de l’activer sur son nouvel emplacement... Malheureusement les formulaires créés sur le site d’origine n’ont pas suivi ! Où se cachent-ils ? Dans quel dossier ? Existe-t-il une astuce ?
Répondre à ce message
Bonjour, meilleurs vœux de santé et de contributin à tout l’équipe,
1000 bravos pour ce plugin !
- Toujours néophyte, j’aimerai savoir comment dès l’envoi d’un formulaire celui-ci pourrait-être transformé automatiquement en un article qui ne contiendrait que certains champs de la réponse (pour conserver l’anonymat) et auquel serait joint un formulaire d’évaluation pour des lecteurs.
ex ici.
- Y-a-t-il moyen d’avoir un compteur de mots sur un champs texte ?
Merci 1000 fois.
Ah mais pour ca il faut utiliser la nouvelle version Forms&Tables justement.
Plus besoin d’exporter dans un article, les données des forms sont facilement affichable dans un squelette.
Tu peux utiliser la moderation a priori ou a posteriori pour que les reponses soient tout de suite publiées ou seulement proposées, et tu peux spécifier quels champs sont publics ou non, et seuls les champs publics seront affichés par la boucle FORMS_CHAMPS
Il y a un modele donnee dans le plugin (assez complexe il est vrai car il prend en compte une problematique microformats)
Tu peux faire facilement dans un squelette :
pour afficher toutes les valeurs de tous les champs publics
Et si tu as besoin des champs privés aussi il suffit de mettre le critere tout
Bonsoir,
pourrait-on mettre ’forms_exporte_reponse_article.php’ quelque part quand le formulaire est valide (au niveau du texte « Votre saisie a été enregistrée. ») pour que l’article soit publié dans ma rubrique n°3 en ne laissant que les rubriques publiques (titre et texte) et en prenant le n° d’id de la réponse au formulaire
Si je ne me trompe en l’incluant dans forms.html à la ligne 12 ? mais uniquement pour le formulaire ’<’form1’>’ ? (pas facile de ne pas inclure le formulaire ex à ma réponse ! )
Merci
salut Charlot
J’ai faillis recopier intégralement ton message tellement il correspond a mon problème.
pourrais tu me dire comment tu a réussi a le surmonté. C’est a dire afficher automatiquement les réponses postés dans un formulaire. dans mon cas je cherche a créé une galerie de photo ou chaque utilisateur peu y déposé les siennes (sous forme de Doc) et quelle s’affiche en temps réel.
Merci d’avance
Répondre à ce message
bonjour et bravo pour ce plugin ! une prise en main facile, des fonctionnalités complètes, etc, quoi demander de plus ?!? et ben justement, j’ai un petit souci, moi nun petit peu nouveau dans la sphère SPIP et moi pas savoir comment, une fois le formulaire validé, retourner sur la page même du formulaire afin d’en remplir un nouveau. bref comme dans l’exmple décrit dans l’article.
merci à tous pour vos réponses !
Répondre à ce message
bonjour
bravo pour ce plug il me parait resoudre plusieurs de mes soucis.
malheureusement j’avais laisse spip vers sa version 1.7 et la j’avoue que maintenant je m’y perds !
je souhaiterai une precision :
j’utilise le plug forms&tables pour 1.9.1 et spip 1.9.2 beta3 vers.8159(j’utilise cette beta pour pouvoir utiliser le plug auteurs_complets
mon but est de faire remplir un formulaire auteur puis grace à forms&tables,faire ajouter un fichier a telecharger.
et lier ensuite les 2(c’est de la tambouille je sais mais on fait avec ses moyens . si il existe un autre moyen merci de m’indiquer la procedure).
tout ceci se passe dans l’espace public apres inscription et je ne veux pas que les redacteurs puissent acceder a l’espace prive.
malheureusement je n’arrive pas a faire apparaitre les resultats de mon formulaire dans une boucle.malgre la lecture de l’article " sur spip.net « formulaires ».
et je ne veux pas non plus faire apparaitre les resultats dans un article.
je me retrouve donc avec 2 formuilaires.
pour que le redacteur logge puisse voir ses donnes
il faut que je puisse faire apparaitre sur l’espace public(apres authentification) le formulaire de l’auteur et le fichier qu’il a attaché dans le second formulaire
j’essaie avec les modeles fournis dans le plug mais soit je ne sait pas correctement ecrire l’adresse dans le navigateur, soit je ne les place pas au bon endroit ?
merci de votre aide
Répondre à ce message
Super plugin qui offre de nombreuses possibilités.
Je n’ai rien à redire sur ce plugin, mais je cherche des informations sur un plugin qui se sert de celui-ci pour fonctionner, je veux parler du plugin ECARD. Si quelqu’un peu me donner des informations sur comment le mettre en oeuvre, j’en serais heureux.
Je vous remercie d’avance pour votre aide.
Et souhaite à tous un joyeux noël.
Xavier
Répondre à ce message
Le plugin bloque à l’étape 4 (de cette doc), donc pas de d’affichage des divers éléments du formulaires, pas de table crée ... travaille dans le vide quoi !
Il faut une version PHP, MySQl, particulière ? Il faut valider une fonctionnalité dans SPIP ? charset ? ... ?
dans l’url ... la valeur de ’retour’, est en symboles cabalistiques.
J’utilise la version 0.22 de la zone (_plugins_/_stable_/forms/1.9.1), sous spip 1.9.1. 7502 !
Merci d’avance.
Répondre à ce message
Bonjour,
D’abord bravo pour le boulôt !!
Corollaire de la puissance et de l’intérêt de ton truc !!! :-D
L’utiliser pour créer des petites annonces !!!
Si Si !!
Comment bien maitriser l’affichage des données entrées ?
Merci
Pas moyen d’utiliser le fichier DEMO pour lire les contenus des réponses au formulaire...
J’ai dû râter une marche !! o secours !!
Répondre à ce message
Bonjour
Bravo pour ce plugin intéressant.
Une petite remarque tout de même qui rejoint celle sur les dates (amha c’est le même problème). Dans les QCM, apparemment les réponses possibles sont classées par ordre alphabétique. Or en général on propose « choix1 », « choix2 » et enfin « autre » pour parer à toute éventualité. Mais du fait de ce classement, « autre » se trouve en première place, ce qui ne me semble pas très logique. Peut-on conserver l’ordre qui était celui de la création du formulaire ?
Merci
Comme pour les articles et rubriques, mets un numéro devant le choix possible, spip se chargera de le faire disparaître et les items seront bien classés.
Bonjour,
Mea Culpa, je n’y avais pas pensé. Ca marche.
Cependant trois petites remarques esthétiques (encore !) :
- est-il possible ou comment sauter une ligne entre chaque champ pour aérer un peu le formulaire ; j’ai essayé une ligne de commentaire vide mais ça ne marche pas,
- est-il possible d’avoir le champ en gras pour le distinguer des choix multiples,
- mes espaces réservés aux réponses débordent du cadre de l’article, peut-on limiter la largeur de ces espaces (ou faire en sorte qu’ils ne prennent que la largeur disponible).
Trois fois merci.
Bonjour, les champs prennent en compte les balises HTML. Donc pour mettre en gras tu fais ton texte. Pour passer une ligne tu mets un
à la fin de ta dernière ligne ou tu insère un champ d’explication ou tu insère le code.
Par contre j’ai du mal a faire la mise en page pour tout aligner les choix simples ou multiples à la ligne ou définir des espaces ou tableau. Cette bidouille devient trop complexe... quelqu’un a une idée ?
oops les msgs prennent le HTML aussi lol donc balise B pour mettre en gras sans oublier de la fermer et balise BR pour passer une ligne.
Bonjour,
Merci pour les réponses (rapides).
L’intérêt de SPIP n’est-il pas justement d’éviter de taper du code HTML quand on rédige un article ?
Une évolution du plugin ne serait-elle pas d’intégrer au moins un mini éditeur basique (comme celui dont je dispose quand je rédige ce post) , ou mieux un éditeur WYSIWYG, afin de rendre plus aisée la rédaction d’un formulaire.
L’insertion d’un champ d’explication avec la balise pour sauter une ligne n’est pas très naturelle pour qui ne pratique pas le HTML tous les jours, elle n’est pas très rapide non plus.
Cela dit on ne rédige pas un formulaire tous les jours...
Il faut prendre mes remarques comme des critiques constructives, je suis vraiment content que ce plugin existe, mais je me place du point de vue de l’utilisateur newbie (que je suis un peu).
—
Patrick
J’ai été confronté au même genre de problèmes.
Il y a une feuille de style dédiée aux formulaires livrée ave le plugin (spip_forms.css).
La solution logique - et pour moi satisfaisante - est d’adapter la feuille de style afin que tous les formulaires s’intègrent au site et respectent la charte graphique définie. Je ne partage l’idée d’un éditeur WYSIWYG. J’apprécie justement la philosophie spip qui permet de traiter séparément le fond et la forme.
Je ne partage pas l’idée de devoir connaitre la « mécanique » html quand on est rédacteur.
Mais tu as raison, l’admin bricole le style et les rédacteurs rédigent sans se soucier de la mise en forme.
Ta solution me convient.
— Patrick
Répondre à ce message
Bonjour,
merci pour ce très beau travail.
J’ai un soucis :
j’utilise ce plugin sur un site d’établissement scolaire et, les élèves sont très joueurs, je reçois des réponses bidons, voire malsaines.
J’aimerais bien qu’une fois le formulaire rempli, celui-ci soit impérativement validé par la personne qui l’a envoyée via l’adresse mail qu’elle a fourni (comme l’inscription au site spip). En fait, je croyais que l’option « Confirmer la réponse par mail avec : » servait à cela, mais non.
Y a-t-il un moyen de contourner ce problème ?
Est-il possible de rajouter cette fonctionnalité ? car j’ai peur que les robots finissent par polluer aussi ce genre de formulaire....
merci, à bientôt
Répondre à ce message
Les réponses sont donc stockées dans une table (associée à une table de champs).
Existe-t-il une manière de corriger ces données sans passer par l’écriture directe dans la table (à la miin ou par une commande php) ?
Autrement dit, peut-on avoir, par exemple pour les administrateurs ou avec un code spécifique, moyen de faire changer ces informations par une personne qui n’a pas besoin de tripatouiller la table ?
Par exemple, si on utilise ce système pour gérer une liste de personnes, comment changer un champ (e-mail par exemple) de manière simple ?
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 :
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.
Suivre les commentaires :
|
