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 utilisateurtrice
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_reponse |
Identifiant de la réponse à modifier | Entier |
no_ajax |
Désactiver l’ajax sur le formulaire | Booléen |
traiter_enregistrement_desactiver_modif_instituer_prop |
Permet de désactiver au cas par cas l’option de configuration « Lorsque l’internaute modifie la réponse, son statut redevient « proposée » » | 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 by date of activity
844 discussions
Bonjour Maïeul
Je ne vois pas la possibilité de créer des boutons radios.
Cette option a disparu ou c’est moi qui doit consulter mon ophtalmo ?
Non c’est toujours possible. C’est meme la première possibilité dans la catégorie des “choix restreint”. Cf capture d’ecran,
Arf, moi je vois ça
Je précise que je suis avec spip 4.4.6 et Formidable 7.1.4
J’ai trouvé.
Bizarrement le fichier radio.yaml était devenu radio.php et inversement.
Heu... tu a fais des manipulations perso là dessus ?
Non, je ne sais pas ce qu’il s’est passé.
Reply to this message
Bonjour,
est il possible de faire apparaitre une image dans un formulaire, qui apparaitrait lorsque l’on sélectionne un champ input ?
Bonjour.
Non pas de possibilité de faire apparaître une image à la sélection d’un input. Par contre on peut insérer une images, via les modèles habituels de SPIP, dans un champ de type “commentaire”
Reply to this message
Bonjour,
Sur un site multilingue, est-il possible de traduire le formulaire dans chaque langue du site ?
Merci
Bonjour,
Oui en utilisant les blocs multilingues.
Reply to this message
Bonjour à tous !
J’ai installé SPIP 4.4.5. J’ai mis le plugin FORMIDABLE v7.1.3; J’ai aussi mis Saisies pour formulaires 5.16.1., Champs Extras 4.3.0 Champs Extras (Interface) 4.3.0.
Je suis bloqué lors de la création d’un formulaire ou de l’ajout d’un champ.extra lorsque je veux paramétré mes champs. J’ai le msg suivant qui apparait : Oups. Une erreur inattendue a empêché de soumettre le formulaire. Vous pouvez essayer à nouveau..
Pourquoi. Je suis bloqué sur les deux plugins.
Avez-vous une idée une solution j’ai terriblement besoin de ces plugins ??
Merci de votre aide.
Il y avait un bug avec saisies 5.16.1 ; saisies v5.16.2 corrige le souci. Donc mettez à jour dans les prochaines jeures le plugin et ca ira.
Grand merci à vous ! C’était la dernière partie de mon site à valider... ouf je termine
Reply to this message
Bonjour,
J’aimerais ajouter une validation des adresses mail pour un formulaire de contact.
Elles sont du type prenom.nom@ac-lyon.fr ou prenom.nom1@ac-lyon.fr 1 pouvant varier de 1 à 9.
En principe, il me semblait que l’expression régulière suivante permettait de faire le tri :
^[a-zA-Z]+(-[a-zA-Z]+)*\.[a-zA-Z]+(-[a-zA-Z]+)*[0-9]?@ac-lyon\.fr$
Mais cela ne fonctionne pas. Les bonnes adresses sont aussi rejetées.
Un peu d’aide ?
Merci d’avance.
Je pense qu’il manque les caractères encadrants utilisés par PHP.
Par exemple mettez un
/en début et en fin d’expression régulière et ca devrait marcher.Reply to this message
Bonjour,
J’ai un problème avec le plugin Formidable 7.1.1 dans mon site en Spip 4.4.4 (https://www.keraluc.com).
Régulièrement, je suis averti par mon hébergeur (IONOS) de la présence d’un fichier malveillant dans le répertoire
.../tmp/cvtupload/formidable_pRSvHK
Avez-vous une explication ?
Merci
Ce dossier
tmp/cvtupload/formidable_pRSvHKest lié à un formulaire qui envoi des fichiers. Probablement qu’un de vos formulaire le permette et que des spams envoi des fichiers. Mais qu’entend Ionos par “fichioer malveillant” ? Il se pourrait qu’il s’agisse de fichiers légitimes mais non reconnus comme tel du fait que leur nom sont chiffrés / modifiésBonjour,
Il faudrait poser la question au robot d’IONOS ;-)
mais je doute d’avoir une réponse claire.
Je supprime, au cas où, ces fichiers dits malveillants pour ne pas avoir de soucis avec mon hébergeur, mais cette précaution est peut-être inutile.
Bah la question que je me pose d’abord c’est : si vous avez ces fichiers, c’est que vous avez un formulaire formidable permettant d’envoyer des fichiers.
Et donc : est-ce que les fichiers envoyés via ce formulaires sont problématiques ?
Reply to this message
Bonjour
Avec SPIP 4.4.4 et Formidable 7.1.1
J’ai un champ @date_1@, et un champ @date_2@ pour lequel je choisis une validation par comparaison avec @date_1@.
Je définis la comparaison pour que @date_2@ soit supérieure ou égale à @date_1@.
Mais ça fonctionne de façon aléatoire :
Date 1 = 01/09/25 et Date 2 = 02/09/25. Validation KO.
Avec 01/09/25 en Date 1, c’est à partir du 21/09/25 en Date 2 que la validation devient OK.
Et si la Date 2 passe au mois d’octobre, c’est aussi à partir du 21 que la validation devient OK.
La validation par comparaison ne fonctionne pas pour des champs “date” ?
Merci.
Effectivement il est très probable que les verifications ne fonctionnent pas avec les dates
Reply to this message
toute petite remarque également pour avis, au sujet d’un plugin qui pourrait bien être incompatible avec formidable : le plugin “Recommander”
qui ajouterait une seconde remarque qui me semble avoir été déjà vue dans les commentaires : la présence de deux formulaires “formidable” sur une même page semble poser également des problèmes (mais pas les mêmes) : ils se synchronisent.
appel aux/à l’expert
de toutes façons : quelle merveille ce plugin in qui porte si bien son nom!
Cela veut dire quoi “ils se synchronisent” ?
et “qui pourrait bien être incompatible avec formidable : le plugin « Recommander »” : en quoi cela serait incompatible ?
bonjour Maîeul,
j’ai passé un bon moment pour comprendre ce qui mettait en rose la page publique dans laquelle j’avais placé un formulaire formidable, signalant 1 erreur dans le squelette sans trop comprendre ce qui était écrit en rouge. J’ai fait un certain nombre d’essais et j’allais même me demander si je n’allais pas être obligée de réinstaller le site.
j’ai décidé finalement de commencer par supprimer 1 à 1 les inclusions (inclure ..., et les ajouts pour voir lequel posait problème le cas échéant.
Le premier était l’inclusion de “recommander à un ami” (plugin recommander) #RECOMMANDER #TITRE,#URL_ARTICLE,#TEXTE avec ses accolades.
Résultat immédiat : plus de fond rose avec ses caractère rouge et le “1 erreur dans le squelette” avait disparu. Bingo!
Mais j’avais déjà eu un problème en ayant mis 2 formulaires formidable dans la même page (je ne me souviens plus si c’était ou non deux mêmes formulaires), du coup j’ai du les retirer et m’arranger autrement.
Il s’agissait de deux pavés côte à côte pour deux activités (de canoë) avec chacun un bouton de réservation faisant apparaître le formulaire de réservation.
et si on remplissait un de ces deux formulaires, l’autre suivait idem (pas très explicite mais je n’ai pas très envie de renouveler l’expérience ...)
du coup, j’en ai conclu qu’il valait mieux ne pas mettre deux formulaires dans la même page.
Pour le second point, c’est résolu avec les dernières versions de formidable
Et du coup pour le premier point, probablement que votre syntaxe d’inclusion était mauvaise, et que cela n’avait rien à voir avec formidable.
Reply to this message
Bonjour,
Avec un formulaire 7.1.0 sous SPIP 4.4, si on désire ne pas mettre de label à l’adresse email (juste un placeholder), cette alternative n’apparait pas quand on doit sélectionner le champ contenant l’adresse de la personne qui remplit le formulaire. Il faudrait soit afficher le placeholder si le label n’existe pas, soit rendre le label de l’email obligatoire...
Ne pas mettre de label est une mauvaise pratiqe en terme d’accessibilités. Nous n’encouragerons donc pas cette possibilité.
Pour aller plus en détail, le placeholder n’a pas de rapport avec le label, il ne sert pas à le remplacer. Il sert à y mettre *un exemple* de remplissage possible, mais pas à indiquer le nom du champ (qui ne doit pas disparaitre quand on est en train de remplir).
Bonjour à vous,
Merci pour votre réponse rapide, oui, je comprends très bien qu’il faille de préférence associer un label pour les champs, mais ce label n’étant pas obligatoire, on peut être tenté de ne pas le renseigner.
Ainsi, si on ne renseigne pas le label de l’email, on est confronté à un problème d’affichage des alternatives pour le traitement du formulaire, champ “contenant l’adresse de la personne”. C’est juste déroutant (on pense alors à un bug).
Ah oui. Bon bah ca apprendra aux gens à avoir des droles d’idées.
Bon j’ai ouvert une MR en ce sens, mais j’ai encore un peu de doute.
https://git.spip.net/spip-contrib-extensions/saisies/-/merge_requests/523
Reply to this message
bonjour
après de premeirs essais de formulaires simples type contact ou pétition, je veux créer un questionnaire (15 questions en 5 thèmes) et en faire une présentation soignée avec des images...
je vois qu’on peut ajouter des documents spip dans le questionnaire, mais mes essais sont infructueux, je crée un document, je choisis une image dans la médiathèque de mon site, mais il ne semble pas l’enregistrer ...
D’autre part, je me demande comment le positionnement d’une image peut être gérée en affichage... il faut entrer dans le css ?
existe-t-il une doc plus détaillée sur ce sujet ?
merci d’avance
Bonjour,
pour insérer une image au milieu d’un formulaire, il faut utiliser la saisie
explicationet insérer dans le texte de celle-ci le raccourci d’insertion d’image comme pour l’insertion d’une image dans un article (<docxx>).Reply to this message
Add a comment
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.
Follow the comments:
|
