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
Forcer les valeurs des champs
Bonjour
Pendant la création d’un formulaire, il est possible d’indiquer une valeur par défaut à un champs de type texte.
Comment faire pour que cette valeur soit le résultat d’un calcul ?
J’ai un plugin perso qui fait des calculs à partir de données saisies dans FORMIDABLE. C’est le résultat du calcul que j’aimerai forcer dans un champ.
MERCI
Répondre à ce message
encore moi...
Je viens de me rappeler pourquoi j’avais mis tant de temps pour migrer de Forms&Table à FORMIDABLE. Ce dernier n’offre pas la possibilité d’uploader des fichiers.
Or la majorité de mes formulaires F&T permettent de charger des images. Je ne peux donc passer à FORMIDABLE et donc à SPIP3 puisque F&T n’est pas dispo pour SPIP3.
Cela fait une semaine que je bosse à la migration de mes sites sous SPIP3. Pour rien. DAMNED !
Est-il prévu d’intégrer cette fonctionnalité à plus ou moins court terme ?
Bonjour Rastapopoulos
J’ai commencé à modifier SAISIES et FORMIDABLE pour intégrer la fonctionnalité d’upload, selon les recommandations que tu avais mentionnées dans ce fil : http://www.mail-archive.com/spip-zo...
Je commence à obtenir qq résultats.
Mais peux-tu me contacter ASAP ? j’ai besoin de ta lumière pour progresser.
PS : j’ai commité sur la liste SPIP-ZONE pour te contacter mais mon message ne passe pas.
Si si, ton mail est bien arrivé sur la liste spip-zone. Mais là je suis au boulot en train de travailler sur autre chose, donc difficile de répondre en profondeur et en détail sur le comment du pourquoi je voyais les choses.
Ya deux grandes méthodes, on peut faire ça « cradement » à part, enfin uniquement pour le besoin de formidable, en tant qu’extension à celui-ci, le truc très spécifique à comment c’est géré dans ces formulaires.
Et on peut (ce que je voudrais) essayer de trouver une méthode générique d’upload de fichiers compatible avec CVT (cad sans perdre le fichier). Possiblement utilisable avec Saisies ensuite, mais pas que, donc vraiment générique.
Pour tout dire, le but de mes tests avec CVTUpload c’est de pouvoir l’intégrer dans le core de SPIP lorsque ce sera au point.
Au point c’est-à-dire le plus simple possible, générique, et le moins intrusif possible (ça doit pas changer tout seul des trucs dans le formulaire mais ça doit fournir les infos nécessaires pour le faire).
Voilà pour faire rapide.
Bonjour, je suivais votre fil et me demandais, Bruno, si vous étiez parvenu à une solution fonctionnelle pour l’upload de docs ? Bien cordialement.
Bonjour Luc
C’est en cours d’implémentation. J’espère que l’on pourra déposer une nouvelle version avant la fin de l’année.
Merci pour votre réponse, je me réjouis de voir ça.
Rastapopoulos
J’essaye de joindre sur ton mail perso (mais en @spip.org) depuis plusieurs jours. Mais apparemment, tu ne reçois pas ?
Répondre à ce message
Bonjour.
Sur un site en spip 2.1.19, j’affiche un calendrier (datePicker)) dont le click sur une date provoque l’ouverture d’un formulaire généré par formidable via fancyBox. Malheureusement, je n’arrive pas a afficher le champ Date (un autre datePicker) dans ce formulaire alors que dans l’espace privé, il apparait bien.
Y a t-il un conflit entre les plugins FancyBox,et Formidable( voire Jqueryplugin) car j’ai beaucoup de mal a rendre inter-opérables ces 3 modules ?
Pour info, les versions :
Facteur : 1.8.9
Fancybox : 0.6.1
Formidable 0.6.7
Yaml : 1.5.0
Bonux : 2.3.0
Verifier : 0.1.18
Saisies :1.26.7
Répondre à ce message
Bonjour,
J’ai mis en œuvre mais suis confronté à un problème d’encodage de caractères.
Dans l’interface privé ou publique les caractères spéciaux type accents sont mal convertis quand je les utilise dans un formulaire.
Je n’ai pas ce type de problème avec SPIP.
J’ai contourné le problème en attendant en encodant ces textes en html mais dès édition du formulaire, je perds mes réglages.
merci de vos conseils
Répondre à ce message
Bonjour,
Ce plugin est vraiment formidable. Je sais que l’ajout de documents joint n’est pas encore pris en compte mais j’aimerai savoir si quelqu’un sait comment l’ajouter, ça m’aidera beaucoup car j’aimerai joindre des CV à mes formulaires.
Exactement la même nécessité ici, je suis également preneur...
Personne pour nous aider ?
Bonjour,
Pour un formulaire unique de candidature, j’ai opté pour le plugin « Formulaire de contact avancé », qui, avec le plugin facteur, permet l’ajout de pièces jointes.
Répondre à ce message
Merci de votre réponse rapide. J’ai moi aussi du mal à comprendre.
J’ai essayé de tout réinstaller, avec un spip neuf, une base de données nouvellement créee, la réinstallation des plugins et l’erreur se reproduit.
La version de saisies est la 1.27 et elle semble s’être installée correctement.
Le spip est installé sur un intranet (Linux, Xamp 1.7.3, Apache 2.2.14). La base est en mysql (5.1.41).
Je teste une installation en local avec les mêmes versions.
E. Boissinot
Formidable fonctionne finalement en local avec easyphp 12.1, avec installation auto des plugins. Après recopie de l’installation locale sur le serveur intranet (sans acces internet), l’erreur de squelette à l’insertion de champ se reproduit, mais les formulaires créés en local fonctionnent.
Donc situation gérable finalement, mais pas d’explication claire de cette erreur, probablement un problème de version (php, Apache, mysql ?)
E. Boissinot
Répondre à ce message
re-re-bonjour (bourrage du forum aujourd’hui, désolé)
Dans la boucle FORMULAIRES_REPONSES, la balise #DATE est systématiquement vide alors que les autres balises fonctionnent (#COOKIE, #IP, etc..)
RastaPopoulos, peux-tu me confirmer qu’il s’agit d’un bug ?
Possible oui, ya un ’NOW()’ dans le code de traiter/enregistrement.php et je pense qu’il l’échappe parce que c’est « insertq ». Il faudrait donc plutôt remplacer par date(’Y-m-d H:i:s’).
OUPS, la date était à 00:00:00 dans la base. Donc normal que cela renvoit 0.
Il s’agit d’un problème lors de l’importation de données issues de Forms&Table.
Désolé pour le dérangement.
Répondre à ce message
Re-Bonjour
Existe t’il un critère de boucle « recherche_donnee » pour la boucle FORMULAIRES_REPONSES, comme cela existait pour Forms&table ?
Merci
Je me réponds :
J’ai trouvé dans le code du plugin : recherche_reponse
Répondre à ce message
Importation de formulaire Forms&Table
Bonjour
Si le fichier XML est en charset UTF-8 (ou autre que ANSI), l’importation échoue et il n’y a pas de message d’erreur.
Il faut convertir le XML en charset ANSI avant de faire l’import.
Il serait souhaitable que cette conversion soit prise en compte automatiquement par le plugin. Dans une prochaine évolution peut-être ?
Répondre à ce message
Migration SPIP 3
Bonjour
Après avoir migré mon site en SPIP 3, les formulaires FORMIDABLE ne s’affichent plus dans la partie publique.
Pourtant :
- j’ai bien accès aux déf. des formulaires dans l’espace privé (Editions - Formulaires)
- et le formulaire s’affiche correctement dans la prévisu de l’article dans l’espace privé,
Mais dans l’espace public, RIEN.
On voit bien que le modèle
<formulaire|formidable|id=dim_1>
est bien traité car dans le code html on voit à la place un<div><span class="base64....
Mais à l’intérieur du span, rien du tout.
Je cherche depuis un moment et là je sèche.
Chezmoiçamarche. ©
Clique sur « Les choses à faire avant de poser une question » au-dessus du champ de commentaire. :)
Ca marche chez moi aussi sur mon serveur dédié
mais pas en local avec EASYPHP
J’ai désactivé tous les plugins pas indispensables pour FORMIDABLE
version de SPIP : SPIP 3.0.5 [19905]
version FORMIDABLE : 1.3.4
version BONUX : 3.0.3
version YAML : 1.5.0
version API vérif : 0.1.18
version Facteur : 2.2.6
version SAISIES : 1.27.0
a priori, ce sont les dernières versions de ces plugins.
version de PHP : 5.3
EasyPHP : 5.3.8.0
Bonjour
Je n’ai toujours pas réglé le problème.
Je vais passer au debuggeur
Pourrais-tu m’indiquer où se fait l’insertion du formulaire dans le code du plugin ?
J’y mettrai un point d’arrêt pour voir ce qui se passe.
L’insertion ? Quelle insertion ? C’est juste un modèle, comme tous les autres modèles de SPIP, le plugin ne fait rien de spécial. Et même le modèle ne vient pas de ce plugin puisque c’est le modèle
<formulaire>
fournit par SPIP qui permet d’appeler n’importe quel form CVT depuis un contenu texte.J’ai progressé mais c’est bizarre. Il s’agit d’un problème de #TEXTE** et de filtre dans mon squelette article.html :
- Si je laisse #TEXTE** (avec deux étoiles), ça marche sur serveur (le formulaire s’affiche) mais pas en local (ligne vide)
- Si je mets #TEXTE* (une étoile), ça marche en local (le formulaire s’affiche) mais sur serveur il s’affiche à la place du formulaire
Je ne comprends pas ???
Je me suis un peu embrouillé. Il ne s’agit pas d’une différence entre mon serveur local ou distant mais d’une différence entre SPIP2 et SPIP3 :
- en SPIP2, je dois laisser #TEXTE**
- en SPIP3, je dois enlever une *
Je crois que le problème est réglé comme ça. Mais j’aimerai comprendre la différence de traitement entre SPIP2 et 3 ?
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 : |