Cette documentation est valable à partir de la version 6.1.0 de Formidable.
Introduction
Historiquement, deux plugins avaient déjà été développés précédemment pour gérer des formulaires :
- Forms &Tables, qui n’a pas été complètement porté pour SPIP 2.
- et spip-formulaire créé par artego mais qui n’était plus maintenu.
La question s’est donc posée : construire sur la base d’un des deux plugins ou repartir de zéro ?
Form &Table, très complet pour les utilisateurs, présentait l’inconvénient d’avoir un côté « fourre-tout » qui le rendait difficilement modifiable et difficile à personnaliser par les dévs.
Il a finalement été décidé de repartir de zéro pour proposer quelque chose :
- de plus facile à utiliser pour les utilisateurs d’une part,
- mais aussi de plus facile à personnaliser pour les développeur⋅euses.
Avec le parti pris de se baser de préférence sur plusieurs petits plugins spécialisés et de tirer parti de la nouvelle norme CVT.
Interface utilisateur
L’utilisation basique de l’interface est abordée dans ce screencast : Mon premier formulaire pas à pas : c’est Formidable !
Appeler mon formulaire
Vous devez appeler le formulaire ayant le nom « formidable », en lui passant en paramètre l’identifiant de votre formulaire.
Dans un contenu
Utilisez le modèle <formulaire>
classique : <formulaire|formidable|id=34>
ou bien <formulaire|formidable|id=contact>
Dans un squelette
#FORMULAIRE_FORMIDABLE{34}
ou bien #FORMULAIRE_FORMIDABLE{contact}
Afficher les résultats du formulaire
Dans un contenu
Utilisez le modèle <formulaire_analyse|id_formulaire=34>
Pré-remplir dynamiquement les champs d’un formulaire
À noter, vous avez la possibilité de surcharger dans l’appel, les valeurs par défaut des champs de votre formulaire. Pour cela, vous devez passer un tableau de nom=>valeur
en deuxième paramètre. Vous pourrez trouver les noms de vos champs dans l’aide-mémoire situé sur la page de configuration des traitements.
Dans un contenu
Le tableau de valeurs dans un paramètre defaut sous forme d’une suite de chaînes « clé,valeur » séparée par des virgules :
<formulaire|formidable|id=contact|defaut=hidden1,valeur,input_5,autrevaleur>
Dans un squelette
Le tableau en deuxième paramètre :
#FORMULAIRE_FORMIDABLE{contact, #ARRAY{nom_du_champ, Ma valeur}}
C’est particulièrement utile pour remplir un champ caché avec une valeur dynamique venant du squelette :
#FORMULAIRE_FORMIDABLE{contact, #ARRAY{hidden_1, #ID_DOCUMENT}}
Autres options utilisable dans le squelette
Il est possible de passer des options comme troisième argument du formulaire, sous forme de tableau (#ARRAY
).
Nom de l’option | Fonction | Type |
---|---|---|
forcer_modif |
Permet de forcer la modification d’une réponse, même si non autorisé | Booléen |
id_formulaires_reponses |
Identifiant de la réponse à modifier | Entier |
no_ajax |
Désactiver l’ajax sur le formulaire | Booléen |
traiter_email_destinataires |
Destinataires pour le traitement | Tableau (#ARRAY ) d’emails ou liste d’emails séparés par des virgules |
traiter_email_destinataires_methode |
Indique si traiter_email_destinataires doit remplacer les emails déjà configurés dans le traitement ou les ajouter |
Au choix 'remplacer' ou 'ajouter' (valeur par défaut) |
url_redirect |
Url de redirection | Chaine |
Exemple d’un formulaire Formidable dont l’identifiant est contact_libre et dont l’email destinataire est dans le champ email de la table de votre objet #EMAIL de la table spip_contacts …
.
<div class="ajax">
#FORMULAIRE_FORMIDABLE{contact_libre,'',#ARRAY{traiter_email_destinataires,#EMAIL}}
</div>
Case unique
Pour rendre obligatoire la réponse oui à une case unique (pour la validation de conditions d’utilisation par exemple), il faut simplement rendre le champ obligatoire.
Courriels de notification
Une option des traitements proposés permet d’envoyer un mail de notification automatiquement, à chaque saisie d’un formulaire.
Le squelette par défaut employé pour la mise en forme de ces mails est plugins/formidable/notifications/formulaire_email.html
. Vous pouvez le copier dans le répertoire ’notifications’ de votre squelette et l’y modifier à votre guise. Cette modification vaudra pour tous les formulaires.
Pour utiliser un squelette spécifique pour les mails de notification de l’un seulement des formulaires définis avec Formidable, il suffit d’ajouter son squelette dans le répertoire ’notifications’ de votre dossier squelettes, mais en ajoutant l’identifiant.
IDENTIFIANT étant l’identifiant du formulaire défini dans Formidable, les squelettes doivent se nommer :formulaire_IDENTIFIANT_email.html
pour le mail aux destinatairesformulaire_IDENTIFIANT_accuse.html
pour l’accusé de réception du visiteur
Conservation des IP
Les adresse IP des personnes répondant aux formulaires sont stockées en base de donnée. Depuis la version 1.5 (SPIP 3) / 0.7 (SPIP < 3), elle sont automatiquement hashé, de manière à ce que l’IP ne soit plus reconnaissable, au bout de 124 jours (environ 4 mois).
Pour changer ce délai, vous pouvez redéfinir la constante _CNIL_PERIODE
dans votre fichier mes_options.php
.
Par exemple :
define('_CNIL_PERIODE', 24*3600);
permet de hasher les IP toutes les 24 heures.
Si vous voulez désactiver le hashage, mettez la valeur à 0.
Envoi de fichiers
Lire l’article complémentaire : Envoyer des fichiers avec un formulaire Formidable.
Mise en forme des saisies
Le plugin ne prévoit aucun réglage de mise en forme des saisies : c’est à chaque squelette d’avoir ses styles. Il respecte cependant la convention d’écriture des formulaire SPIP. Il permet d’ajouter des classes spécifiques sur les saisies.
Affichage des réponses sous forme de tableau
Le plugin Formidable Tablesorter permet d’afficher sous forme de tableau les réponses, dans l’espace privé, avec possibilité de tri et de filtre.
Voir aussi sur le wiki
- Complément de doc et exemples sur les boucles et balises de formidable
- Exemples de stylage CSS d’un formulaire Formidable
- todoFormidable
- Formidable, présentation aux Grottes (2010)
Discussions par date d’activité
812 discussions
Bonjour,
Votre plugin est vraiment utile et conçu de façon très pratique et très ergonomique. Pour moi, il ne lui manque vraiment que la possibilité d’envoyer une pièce jointe. Je sais que d’autres plugins le font, mais avec vous, je sais d’avance que l’intégration de cette fonctionnalité sera élégante et pas trop « prise de tête ».
Votre tutoriel vidéo est très clair. Vous parlez d’un tutoriel pour la partie « enregistrement dans une base ». Est-ce qu’il existe déjà ? Sinon, est-ce vous l’envisagez ?
D’avance, merci.
Nope pas d’autres screencast pour l’instant. Et pour les fichiers c’était prévu, c’est toujours prévu, mais toujours aussi dur de trouver du temps, malheureusement.
Merci pour votre réponse.
J’espère que vous trouverez le temps pour les pièces jointes car ce serait sacrément utile.
Idem, j’attends plus que « l’ajout de pièces jointe » pour passer sur votre plugin. Bon boulot !
Répondre à ce message
Bonjour et merci pour ce plugin que j’utilise conjointement avec champs Extras3 et le plugin transaction, le tout avec SPIP3 pour un site de dev.
Question :
J’aimerais utiliser Formidable pour créer un formulaire de paiement en ligne et faire en sorte que les champs Nom, Prénom, Identifiant, Mot de passe, Email soient aussi enregistrés dans la table Spip_auteurs au traitement du formulaire étant entendu que d’autres informations seraient destinées à figurer naturellement dans les tables du formulaire... Avec l’option de configuration des traitements, le plugin permet d’enregistrer les données en base mais ne permet pas de choisir les tables... Auriez-vous des suggestions, pour me permettre d’obtenir le résultat visé ?
Merci d’avance !
Répondre à ce message
Bonjour !
J’ai un petit soucis avec Formidable, les dates et le pop-up ne s’affichent pas sur le site : http://www.les-escales.fr/francais/articles/article/reservations-hotels-restaurants
Quelqu’un a-t’il une idée ?
Erreur Javascript. Mais ce n’est pas propre à Formidable, c’est le dateur fournit par SPIP normalement, en tout cas en SPIP 3 et utilisé par la saisie « date » du plugin Saisies Il manque peut-être des librairies JS pour l’utiliser dans le public, genre le core de jquery UI. Je ne sais pas trop, j’ai jamais eu à utiliser cette Saisie.
Je confirme ! En chargeant Jquery UI sur la page ça fonctionne ! Merci pour la piste ;)
@escales, V. m’avait dit que le site avait avancé. Belle réussite.
Pour revenir au problème ci-dessus, le calendrier ne s’affiche pas sur Firefox ni IE
Il s’affiche sur Chrome.
Sur Safari, on voit la date du jour s’afficher, mais en mode AAAA-MM-JJ
Répondre à ce message
Bonjour,
le plugin GIS fournit une « saisie » : http://zone.spip.org/trac/spip-zone...
Je ne vois pas comment l’utiliser dans un formulaire ?
MErci,
Sylvain
Pour qu’une saisie soit reconnu par le constructeur de formulaire, il faut qu’elle soit décrite en YAML, sur le modèle des autres.
Attention, la saisie « carte » ne fournit aucun champ, mais permet en cliquant sur une carte à la souris de pré-remplir d’autres champs dans la page. Il faut donc que ces champs existent, notamment latitude, longitude et zoom (et possiblement l’adresse, ville, etc).
ok, merci.
comment faire en sorte que les champs latitude etc. soient remplis par le clic sur la carte ? Est-ce qu’on le configure dans le yaml carte.yaml ?
Y a-t-il une doc explicitant l’utilisation de yaml dans le cadre de formidable ?
Ya des noms de champs par défaut dans la saisie « carte », que l’on peut passer en paramètre pour les changer (pour mettre « latitude » à la place de « lat » par exemple).
Et non je ne crois pas qu’ily ait de doc pour le YAML, doc qui serait dans Saisies, pas dans Formidable, car le constructeur de formulaire est dans Saisies et est utilisé aussi autre part.
Répondre à ce message
Bonjour,
je viens de déballer un spip 3.0.3 tout neuf [19675] avec formidable 1.1.1
Voilà quelques soucis que je rencontre
- Configuration du formulaire : à la question « Affiche ensuite » je sélectionne « Rien du tout ». Et si je valide tel quel, j’ai un avertissement me demandant de remplir le champ « Adresse de redirection après validation », alors qu’il est précisé « Laissez vide si vous souhaitez rester sur la même page ». Je contourne le problème en mettant un blanc dans ce champ.
- Configuration des champs : je rencontre le même problème que cité ici concernant le caractère obligatoire d’un champ : le formulaire est ensuite inéditable
- à l’inclusion du formulaire dans un article, le formulaire n’est pas reconnu si j’utilise un identifiant textuel . commençant par un chiffre. Avec son identifiant numérique, pas de souci. EN le faisant commencer par une lettre, pas de souci non plus.
- Après soumission du formulaire, il s’affiche « Votre réponse a bien été envoyée, mais aucun traitement n’a été défini pour ce formulaire. Il ne fait donc rien. :) », alors que j’ai pourtant bien configuré le traitement (enregistrement des résultats). Si je remplis le champs « Message de retour », j’ai bien le bon message qui s’affiche.
- Impossible de remplir un champ « Date ». J’ai systématiquement l’erreur « Il y a des erreurs dans les champs ci-dessous, veuillez vérifier votre envoi » : « Le format de la date n’est pas accepté ». Alors que j’utilise le sélecteur de date. Et si je n’utilise pas le sélecteur, le formulaire convertit immédiatement mon format de saisie en jour/mois/année. D’ailleurs ce serait bien que dans le BO on puisse configurer le format de saisie.
- Pour finir, je m’associe à ceux qui souhaiteraient voir un upload de fichier. C’est réellement bloquant pour passer à spip 3. Je n’ai pas encore osé tester F&T sous spip 3, mais je sens ça très bancal.
je reste à votre disposition pour effectuer des tests complémentaires.
Répondre à ce message
Bonjour,
Je ne vois pas de champ de formulaire pour joindre un fichier. Est-ce qu’il faut faire quelque chose en plus de Formidable pour ça ?
merci
dd
oui, en plugin séparé et pour spip 2.1 : formulaireupload
la doc
téléchargement
Quel rapport avec Formidable ?
Non il n’y a pas de champ fichier pour Saisies/Formidable. C’est compliqué de coder ça proprement, et tu peux voir que c’est dans le fichier « todo » du plugin depuis le début.
OK merci.
je vais attendre alors.
J’utilise Forms et table sur des sites que j’aimerais passer en SPIP 3.
dd
Répondre à ce message
Bonjour,
J’aimerais ajouter un « type » de champ GIS (point géolocalisé) dans un formulaire formidable. Je sais qu’il existe déjà un formulaire d’édition de point dans le plugin GIS2, auquel on peut rajouter des champs avec le plugin champs extra 3, mais j’aimerais utiliser les fonctionnalités de formidable (gestion de mails, stockage...). Est-ce que c’est possible ?
Je suis novice, je ne sais pas trop par où commencer.
Je te renvoie à cette réponse : http://contrib.spip.net/Formidable-le-generateur-de-formulaires#forum459659
Répondre à ce message
Bonjour
Je travaille à un blog associatif dans lequel j’intègre des formulaire pour pouvoir échanger des paniers hebdomadaires. Aucun problème pour créer le formulaire et l’intégrer dans un article via le modèle. Mais c’est ensuite que ça coince : je voudrais récupérer les résultats et les afficher dans la partie publique du site, de manière à ce que tout le monde puisse voir qui propose d’échanger (offreur ou demandeur). Un peu sur le principe du plugin Agenda, où on peut s’inscrire à un événement et où les résultats apparaissent sous le formulaire.
Est-ce possible ?
Comme c’est un plugin générique, les réponses sont « abstraites », on peut pas pas préjuger des questionnaires, donc les réponses ne sont pas enregistrées de la même façon qu’un objet éditorial classique, qui a sa table et ses champs.
Le but de ce plugin est avant tout de faire des questionnaires, sondages, et form de contact, les utilisations « détournées » sont un peu plus complexes.
Chaque réponse a une ligne dans la table « spip_formulaires_reponses » et chacun de ses réponses a autant de ligne que de champs dans la table « spip_formulaires_reponses_champs ».
Il y a quelques critères pour faciliter les requêtes (cf le fichier
public/formulaires_criteres.php
) et il y a le modèle pour afficher une réponse comme petit exemple (mais il est générique donc il suit bêtement dans l’ordre). Si t’as pas besoin d’affichage particulier, le modèle déjà présent suffit peut-être d’ailleurs. Tu boucles sur les réponses et tu appelles le modèle avec l’identifiant d’une réponse.Je crois que je n’ai pas tout compris.
J’ai actuellement un formulaire, qui a le numéro 1, et que j’ai appelé dans un article avec le modèle
Pour l’instant, ce formulaire compte deux réponses. Je voudrais afficher ces réponses dans le même article. Mais je ne sais pas avec quel modèle les appeler. J’ai essayé
et formulaire|analyse|id=1>, sans aucun résultat.
Zut, les balises ne sont pas affichées. Je remplace les < par des ".
Je reprends : j’ai appelé le formulaire avec le modèle « formulaire|formidable|id=1 » et je voudrais afficher dans le même article les réponses à ce formulaire (j’en ai pour l’instant deux).
J’ai essayé « formulaire|reponse|id=1 » et « formulaire|analyse|id=1 », mais rien ne s’affiche.
Comment appeler le modèle qui affiche les réponses ?
Essaye plutôt
<formulaire1|analyse>
(= normalement appelle du modèle « formulaire_analyse.html » avec « id_formulaire=1 » alors que toi tu appelais avec « id=1 »).Quand au modèle pour une réponse, c’est pour afficher 1 réponse, donc l’identifiant de la réponse :
<formulaires_reponse12>
par exemple.Pour faire la liste de toutes les réponses, là il faudrait ajouter un autre modèle.
OK, je viens d’essayer, ça marche. Le modèle analyse n’a pas d’intérêt pour moi. Le modèle réponse correspond à ce que je cherche à faire, mais évidemment il ne traite qu’une réponse à la fois.
Pour afficher toutes les réponses à un formulaire, ne serait-il pas possible d’utiliser le fichier exporter_formulaires_reponses.php ? Puisqu’apparemment il est dit dedans que le rôle de ce fichier est « d’exporter toutes les réponses d’un formulaire »...
Ceci étant, même si j’arrive à créer un modèle me permettant d’afficher toutes les réponses du formulaire1, par exemple, quid des réponses du formulaire 2 ? Il faudrait dans la balise du modèle que le numéro de formulaire soit indiqué, ce qui n’est pas le cas pour l’instant...
Bonjour
Je n’arrive toujours pas à créer un modèle qui appelerait toute les réponses d’un formulaire donné. Si quelqu’un peut m’aider, en m’indiquant quoi modifier à partir du modèle « formulaires_reponse.html » ?
Merci d’avance.
Bonjour
La possibilité de faire afficher les réponses dans un article m’aiderait bien également : toutes les réponses et pas seulement une seule.
Si quelqu’un a une réponse, ça m’aiderait bien !
Merci
Ah ben si c’est pour faire pareil que formulaire_reponse mais avec toutes, c’est plus simple hein. Il suffit de reprendre exactement le même code mais en changeant la boucle racine, qui dans le modèle au singulier ne va chercher qu’une réponse précise, pour dans votre cas aller chercher toutes les réponses d’un formulaire.
Et c’est tout.
Merci pour la réponse, mais je n’y arrive pas.
J’ai commencé par dupliquer le fichier formulaires_reponse.html, en modifiant la ligne 1 avec id_formulaire=1, puisque je veux afficher toutes les réponses du formulaire n°1.
Je n’ai pas modifié les lignes 4 et 10 où il y a id_formulaire.
Je nomme le nouveau fichier formulaire1_reponse.html.
Ensuite, dans mon article j’appelle le modèle par la balise
<formulaire1_reponse>
.Mais rien ne s’affiche.
Il doit y avoir une erreur quelque part, mais où ?
Merci Rasta, ça fonctionne effectivement.
J’ai deux autres questions :
- comment intégrer un champ pour l’upload de fichier dans formidable ? je ne l’ai pas trouvé comme il existe dans fors&tables2 ?
- Quand je choisis dans la conf du formulaire Après validation, afficher à la place du formulaire : lles valeurs saisies après la validation du formulaire par la personne, les données ne s’affichent pas, il met par exemple :
« Votre message a bien été envoyé par courriel.
Prénom
Sans réponse
Nom
Sans réponse »
alors que l’enregistrement se fait correctement dans la bdd et qu’il s’affiche dans la partie formulaires réponses...
Ya pas d’upload pour l’instant, c’est toujours en gestation, mais je suis un peu débordé.
Ce n’est pas moi qui ait ajouté l’option « après validation », et je ne l’ai encore jamais utilisé, du coup je ne sais pas trop comment ça marche, je n’ai pas lu le code qui a été ajouté pour ça. Du coup pour l’instant je peux pas trop aider sur ce point.
autre petite remarque par rapport à la ligne à modifier : dans ton exemple tu as mis le nom de la boucle avec un s à la fin de reponse : BOUCLE_reponses ,
pensez à ajouter le s aussi pour fermer la boucle en fin de code...
Merci pour la précision, Aude. Je profite des échanges avec Rastapopoulos, puisqu’il te répond à toi ;-)
Juste pour savoir, quand tu appelles le modèle dans un article, à quoi ressemble la balise ? Et est-ce que le squelette du modèle doit bien s’écrire formulaire1_reponse.html ? (Pour le formulaire 1 s’entend).
Bonjour, je vois que certains ont réussi à publier toutes les réponses avec cette boucle : .
J’ai essayé plusieurs « trucs » mais je n’y arrive pas. Faut-il l’insérer dans le code de l’article ou bien faut-il faire un autre modèle ?
Merci de bien vouloir m’aider.
Répondre à ce message
Bonjour,
bug rencontré sur deux site Internet :
SPIP 3.0.3 [19675] + Formidable 1.1.1 - dev
Lors de la création de formulaire, si je met un champ en obligatoire, on ne peux plus éditer le formulaire. On se retrouve avec l’obligation de remplir le formulaire dans l’espace privé, sinon on a le message d’erreur qui nous indique qu’on ne peut pas laisser le champs vide.
une idée ?
J’ai le même souci...
Répondre à ce message
Bonjour,
J’ai un problème sur le « dateur » (qui apparaît dans l’espace public après qu’on clique sur l’îcone calendrier d’un champ date).
Aucun des .css ne semble pris en compte, du coup le dateur qui apparaît est... plutôt pas beau.
Suis-je le seul dans ce cas ? (pour information, SPIP 3.0.3 et FORMIDABLE 1.1.1)
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 : |