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é
811 discussions
Bonjour,
J’ai voulu créer une page SPIP pour éditer la réponse n°42 du formulaire
form1
. Cela marche avec ce code#FORMULAIRE_FORMIDABLE{form1,#ARRAY,42}
On est sur la version 4.15.5 du plugin sur SPIP 3.2.14.
Est-ce que c’est ce qu’il fallait faire ? Car on compte migrer vers SPIP4 et utiliser la dernière version du plugin pour plus tard.
Peut-être qu’il faudrait mettre à jour la documentation ? En le lisant, j’avais fait
#FORMULAIRE_FORMIDABLE{form1,#ARRAY{id_formulaires_reponses,42}}
. Mais ça ne marche pas.Merci
l’idée est que l’utilisateur puisse rééditer sa réponse.
Dans un article, j’ai fait
<formulaire|formidable|id=form1|vlrs|42|/|forcer_modif=true>
Lorsque l’on soumet le formulaire, ça quitte la page.
Oui, alors la première syntaxe est la plus ancienne, elle sera toujours supportée, mais la seconde syntaxe est à préférer à partir de la dernière version du plugins (5.2.0) seulement. C’est un peu compliqué d’avoir une doc qui permette de connaitre les syntaxes pour toutes les versions, et comme SPIP 3.2 ne sera bientot plus supportés...
Répondre à ce message
Bonjour,
On utilise la version 4.15.5 du plugin sur SPIP 3.2.14. On a coché l’option « Poster par courriel le résultat du formulaire à une liste de destinataire ». On a bien le mail, mais le message est comme ceci
Formulaire « XXX » posté le 24/06/2022 à 10:01:21 (modifiant la réponse envoyée le 09:59:01 à 09:59:01)
On a l’heure mais pas la date.
Merci
Serveur Debian avec php7
Oui, c’est corrigé hier en https://git.spip.net/spip-contrib-extensions/formidable/commit/a61dc66e8cb0da73dc6e423665aa95e4500dd762 (pour la version 5 pour SPIP 4). Je n’ai pas releasé, car c’est vraiment une correction mineure.
Pour la version 4 pour SPIP 3, je vais reporter et releasé dans la foulée, car elle ne bouge plus beaucoup.
Répondre à ce message
Bonjour,
Tout d’abord, merci pour cet excellent plugin.
Je ne sais pas si je suis au bon endroit pour signaler cela : je pense avoir identifié un problème dans le code du plugin, dans la fonction
formulaires_formidable_verifier_dist()
où il semblerait manquer une ligne que j’ai retrouvée dans d’anciennes versions du plugin :Sans cette ligne, j’ai constaté que la variable
$erreurs
reste vide en retour de fonction, lorsque des champs obligatoires n’ont pas été saisis dans le formulaire Formidable !SB
1. Idéalement les rapports de bug sont plutot à rapport dans l’espace de gestion des tickets, dont le lien est mis à droite de la présente page. On peut demander un compte dans « S’inscrire pour contribuer ».
2. Je viens de tester avec formidable 5.1.2 et saisies 4.3.6, et mes champs obligatoire sont bien vérifier.
3. La ligne est question est bien manquante, car désormais c’est saisies qui s’occupe d’effectuer les vérifications, via le pipeline formulaire_verifier
4. Il faudrait que tu passe par la page de gestion des plugins, puis resteste. Si cela ne marche toujour pas, revient vers nous et on essaierai de creuser.
Bonjour Maïeul,
Merci pour votre retour rapide. Je vais suivre vos consignes et je vous fais un retour dans l’espace de gestion des tickets.
Jusqu’à présent, les tests ont été faits sous SPIP 3.2.13, Formidable 4.15.5 et 3.55.3.
SB
Répondre à ce message
Bonjour
j’ai formulaire qui ne fonctionne plus avec SPIP 4.0.1 & 4.0.2, Formidable 5.1.0
Pré-remplir dynamiquement les champs d’un formulaire :
Champ vide une idée de ou vient le problème ?
Merci pour votre aide si vous y trouvez quelque chose...
Tu pourrais m’envoyer un export .yaml de ton formulaire, à
monprenom@monprenom.net
?je me demande si cela vient pas tout simplement du fait que la saisie date, qui s’appuie sur le core, n’attend pas autre chose désormais en entrée...
Le problème vient du fait que tu étais dans un modele. Le commit https://git.spip.net/spip/spip/commit/419912dcd6fcdc02e0a8990c558a5759fcd83bd4 (qui est bien !) casse la prise en compte du get dans ce cas là.
la solution est
1. Dans ton modèle faire
<INCLURE{fond=modeles/inclure/gly_saisie,env}>
2. Créer un squelette modeles/inclure/gly_saisie.html, et y mettre le code original de ton modele
Tous fonctionnent, merci.
J’avais le même problème,
merci beaucoup !!
Répondre à ce message
Bonjour !
Chez moi (spip 4.1) dans le sélecteur de date il ya le lien « aujourd’hui » (en bas), mais il fonctionne pas, au clic rien se passe , est-ce normal ?
Merci
Au revoir ! ;-)
c’est coté privé ou côté public ? quelles versions du plugin saisies ?
eh bien j’ai Saisies pour formulaires 4.0.3 et j’ai testé côté public
Répondre à ce message
Horreur, j’ai fait la migration spip 4.1 sans regarder que Formidable soit migré compatible dans cette version. Est-ce prévu ? Si oui rapidement ?
Par avance, merci !
Haha à toi de tester et dire. :p
À peu près aucun plugin n’est marqué compatible pour l’instant hein, c’est marqué dans l’annonce :)
Et c’est même marqué :
Ya peu de changement en 4.1 donc la version pour 4.0 doit marcher pareille à priori.
Oui, entre temps je suis retourné sur la page de migration et ai vu la commande : cela foncitonne bien. Ouf et merci !
Répondre à ce message
Bonjour,
Merci encore pour la réactivité et les corrections.
Cordialement
Répondre à ce message
Merci beaucoup pour la réponse et la suggestion.
Cordialement
Pour info, les 2 bugs que tu avais signalé (sur le multiétape + sur le IN) ont été corrigée dans la dernière version du plugin saisies, qui sera prochainement disponible pour mise à jour dans SPIP.
Répondre à ce message
Bonjour,
J’ai créé pour un champ un affichage conditionnel si la valeur du champ précédent est une des trois premières d’une liste.
La condition est donc : @radio_5@ IN « choix1,choix2,choix3 »
Dans ce cas, le 2e champ s’affiche bien et il est possible de le renseigner mais il disparait lors de la validation du formulaire.
Est-ce que la condition est bonne ?
Par ailleurs, est-il possible de récupérer, dans « valeur par défaut », la valeur d’une réponse déjà enregistrée dans un autre formulaire ?
Merci pour votre aide.
SPIP 3.2.12 + Sarka-SPIP 4.5.11
Formidable 4.15.4
Saisies pour formulaires 3.54.10
PHP 7.4.8
1. Il me faudrait un export .yaml de ton formulaire (monprenom@monprenom.net)
2. Non, on ne pas récuperer directement les valeurs d’une réponse d’un formulaire dans un autre formulaire. Après c’est possible avec un « pre remplissage dynamique » des champs de formulaire, mais il faut écrire son propre squelette.
HUM. Alors c’est une affaire complexe.
Comme le précise la documentation
IN
est prévue, au départ, pour le cas où la saisie testée renvoie un tableau. Pas du coup pour teste qu’une valeur monoévoluée appartient à un ensemble.Mais
1. On voudrait éventuellement le faire évoluer dans ce sens
2. Et surtout, il y a un bug : côté Javascript, on permettait deja cela, mais pas côté PHP. Ce qui explique la dissonnance que tu a constaté.
Et donc
a. J’ai fait une proposition d’évolution pour résoudre ce bug MAIS je ne sais pas encore si on l’acceptera ou pas, car c’est un sujet complexe (le sens de
IN
est vraiment confusionnant). A priori, on pourrait aller dans le sens que tu a utiliséb. Mais en attendant, je te suggère de remplacer ton
@radio_5@ IN 'choix1,choix2'
par@radio_5@ == 'choix1' || @radio_5@ == 'choix2
.Répondre à ce message
Bonjour,
J’ai construit avec Formidable un formulaire d’adhésion pour une association. Cependant, je rencontre deux difficultés :
- j’ai créé 6 groupes de champs et activé la gestion multi-étapes dans la configuration des options globales ; mais, à l’affichage des étapes, la numérotation commence à 2, puis 4... pour 13 étapes au total ;
- je souhaite qu’un champ ne s’affiche que si la case du précédent est cochée ; j’ai donc saisi, dans l’affichage conditionnel, @checkbox_2@==« oui » mais, lorsque je valide la case, le champ suivant reste caché.
D’autre part, les réponses au formulaire sont envoyée par courriel au trésorier de l’association. Comme il y a beaucoup de champs, ce courriel a plusieurs pages. Je souhaiterais donc que les réponses soient sur la même ligne que les questions. Sur quel fichier agir ?
Merci pour votre aide
Cordialement
SPIP 3.2.12 + Sarka-SPIP 4.5.11
Formidable 4.15.4
Saisies pour formulaires 3.54.10
PHP 7.4.8
1. Pour le premier problème, il faudrait m’envoyer à monprenom@monprenom.net un export .yaml du formulaire
2. Pour une case cochée, la valeur prise est ’on’, pas ’oui’. Mais vous pouvez simplement mettre
@checkbox
, ca marchera tout aussi bien3. Dans le fichier
mes_options.php
, mettredefine('_SAISIES_AFFICHAGE_COMPACT', true);
Merci pour votre réponse rapide.
Je vous envoie le fichier .yaml
Cordialement
Pour le premier problème, c’est un bug qui a été signalé hier soir et corrigé ce matin :p. C’est parce que votre dernière explication se trouve hors groupe de champs.
Deux solutions :
- vous la mettez dans un groupe de champs
- vous utiliser la version v3 de dev (je ne vais pas releaser tout de suite, j’ai d’autres projets), qui est disponible ici https://git.spip.net/spip-contrib-extensions/saisies/archive/v3.zip, mais attention dans ce cas le champ se retrouvera dans toutes les étapes.
Merci pour la réponse rapide et pour le conseil concernant la mention « obligatoire ».
Cordialement
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 : |