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,
étrange comportement du plugin lorsqu’on le désactive (je ne parle pas de désinstallation), et qu’on le réactive :
- les formulaires semblent toujours actifs (ils apparaissent dans l’espace public, et les champs de la BDD sont manifestement toujours renseignés)
- dans l’espace privé, par contre, les formulaires ne s’affichent pas (donc impossible de les modifier)
— > auriez-vous une solution pour « retrouver » la main sur ces formulaires ? En vous remerciant...
C’est très bizarre en fait, ça ressemble à un bon gros bug. Mais là comme ça je ne sais pas encore d’où cela pourrait venir (car juste la désactivation ne touche à rien dans la base normalement).
Bonjour RastaPopoulos,
Il s’avère que cette erreur est récurrente (absence des formulaires dans le site privé, mais qui s’affichent correctement dans le site public).
Plus étrange encore, des erreurs apparaissent dans le site privé lors de la première requête sur TOUS les formulaires (voir image ci-dessous), 6 erreurs qui disparaissent après rafraîchissement de la page, page qui alors indique qu’il n’y a pas de formulaires.
Même chose si on veut produire un nouveau formulaire : 2 erreurs sont affichées, qui disparaissent après rafraîchissement... Mais impossible d’ajouter le nouveau formulaire, retournant le message « Warning : Invalid argument supplied for foreach() in ecrire/inc/modifier.php on line 67 ».
En espérant que cela pourra amener à une résolution...
C’est dans SPIP 3 tout ça ? J’avais commencé une branche, qui fonctionnellement marchait chez moi mais n’étais pas adapté encore à la nouvelle manière de faire les pages privées, mais il y a eu récemment des modifs par d’autres personnes (Teddy je crois ?). Donc ces erreurs de squelettes viennent peut-être de là. Je peux pas voir pour l’instant, la zone est morte.
Bon ben non, là que ce soit dans la branche v0 ou dans le trunk, ya bien un critère pagination dans la boucle de ce squelette, donc le bug affiché n’a rien de logique.
Les sites (car l’erreur se répète sur 2 sites) sont sous SPIP 2.1.12, et j’avoue ne rien comprendre du tout à ce problème, ni à la façon dont je pourrais le contourner. Si je vois une solution (je ne parle pas d’une résolution du problème ;-)), je poste.
Pour l’instant, je me contente de changer directement les données via la BDD, mais ce n’est pas très pratique ;-)
Et ça fait ça dès l’installation ? T’as essayé en supprimant tout et en réinstallant ? Et surtout as-tu bien désactivé tous les autres plugins non nécessaire pour bien tester que ça vient bien que de ce plugin-là ?
J’ai exactement le même problème que celui décrit par benolaos
SPIP 2.1.12
Sarka-SPIP 3.1.0
J’ai essayé de désactiver certains plugins (en particulier Sarka et Accès Restreint), cache vidé à chaque fois. Message d’erreurs toujours le même. Je peux cliquer sur « créer un nouveau formulaire » mais rien ne s’enregistre.
J’ai désinstallé plugin par plugin, et, à la fin, bug dans l’espace privé :
Fatal error : Call to undefined function lire_config() in xxx/xxx/ecrire/public/composer.php(49) : eval()’d code on line 77
Aïe. Il semble que je sois maintenant coincé...
Cette erreur ci-dessus peut être corrigée en vidant tout le dossier tmp/cache. On peut ainsi reprendre la main sur le back-office.
Pour autant, je n’arrive toujours pas à reprendre la main sur les formulaires.
Plus étrange encore, en refaisant l’installation de tout le site sur le serveur distant (fichers + BDD), je continue d’avoir les mêmes problèmes... j’en perds mon latin (et mon spipien ;-))
Mais est-ce qu’il y a bien tout dans la base ? Ya bien toutes les tables de créées lors de l’installation ?
RastaPopoulos,
oui, toutes les tables sont là.
Mais voilà l’info qui peut peut-être faire avancer le schmillblick : en local, tout fonctionne (duplication du site, duplication de la base, désactivation et désinstallation du plugin formidable, etc...). En local, TOUT fonctionne parfaitement.
J’ai donc fait une batterie d’essais et il semble que les problèmes soient causés lors de l’intégration sur le serveur distant (5 réinstallations complètes sans que rien ne change...). C’est LA que tout coince. Une idée de là où ça pourrait venir ?
Version de PHP, version du serveur SQL ?
je suis sur OVH (PHP5) htaccess chargé de SetEnv PHP_VER 5
En tout cas ce n’est donc pas un bug du plugin mais un problème lié à ton installation particulière. Donc il faut trouver ce qu’il y a de particulier justement.
C’est bien là le problème : j’installe sur OVH les dernières versions de :
SPIP, Vérifier, Facteur, Yaml, Bonux, Saisies (et uniquement ça). Puis .htaccess avec PHP5. Tout est neuf, sans données, propre donc.
Mais si l’installation des plugins se déroule correctement, voici ce qui se passe :
1) les 4 tables de Formulaire ne se créent pas (d’où erreur lorsqu’on veut créer son premier formulaire).
2) je crée donc manuellement les tables, mais erreur :
Warning : Invalid argument supplied for foreach() in xxx/xxx/ecrire/inc/modifier.php on line 67
Je crée donc mon premier formulaire : la table spip_formulaires voit alors une ligne se rajouter, avec des NULL (identifiant, descriptif et url_redirect), et rien pour le titre (alors que, pourtant, renseigné lors de la tentative de création).
3) je mets en distant des données tirées de mon site en local. Je vide les caches, et tmp/cache. Mais rien n’y fait et je retombe sur l’erreur première (que j’ai postée en image).
— > Il y a manifestement quelque chose qui cloche quelque part ;-)
Quelles informations supplémentaires te seraient nécessaires pour nous aider à trouver ce qui semble un gros bug, non ?
En te remerciant pour ton aide et tes lumières.
Si dès la toute première installation ya déjà pas les tables qui se créent, ça ressemble plutôt à une erreur SQL. Donc il faudrait que tu fouilles les logs de SPIP tmp/*.log pour trouver cette ou ces erreurs SQL, du genre mauvaise syntaxe dans la déclaration des tables par rapport à ta version du serveur (MySQL ?).
Bonjour RastaPopoulos,
Franchement, SQL n’est pas ma partie, mais du tout.
Et avouons que le comportement du plugin est bien étrange, et ne devrait idéalement ne pas requérir de trifouiller ainsi dans des logs et des SQL...
Puisqu’il ne semble pas que j’aie le choix, pourrais-tu m’indiquer plus précisément ce que je suis censé chercher/réparer ?
En te remerciant.
PS : comment se fait-ce que les formulaires s’affichent parfaitement dans l’espace public et qu’on ait tant de problèmes dans l’espace privé ? Voilà une question qui m’interpelle ;-)
Ben non. Si ya un BUG, c’est que ce n’est PAS le comportement normal du plugin, et que donc forcément il faut fouiller dans les logs pour trouver d’où peut venir le bug...
Une personne sur IRC avait apparemment le même problème, et en me montrant ses logs il est apparu que lors de l’activation du plugin, ça ne reconnaissait même pas les fonctions PHP du plugin. Il y avait des phrases du genre « fonction formidable_declarer_tables_principales() inconnue ». Et donc forcément sans la déclaration des tables, ça ne risque pas d’installer quoi que ce soit. Mais je n’ai pas compris encore pourquoi ça ne trouvait pas les fonctions.
Tu peux déjà chercher si t’as le même genre de phrases, juste après la première activation (et donc l’installation) du plugin.
Répondre à ce message
Bonjour,
Dans le cas d’un champs « menu déroulant », est-ce normal que la valeur générée dans le CSV lors de l’exportation des données soit le « label » et non la « clé » ? À quoi sert la « clé » ?
De plus, dans le fichier CSV, les accents ne s’affichent pas comme il faut. Quelqu’un a une idée de ce qui est mal configuré ?
Merci !
La génération du CSV n’est pas forcément pour de l’analyse automatique, donc par défaut ce sont les labels lisibles humainement qui sont intégrés. Mais en vrai il faudrait que ce soit une option : générer soit les trucs humains soit les clés analysables plus facilement. À code, donc...
Sinon chez moi j’ai pas vu de problème d’accents.
Répondre à ce message
Bonjour,
J’ai créer un formulaire avec des vérifications et lorsque qu’un champ comporte une erreur le formulaire se réaffiche mais sans conserver les données dans les champs qui sont correct... Y’a t-il une fonction à cocher pour que les données ne soient pas effacées ?
De plus j’ai un souci avec l’envoi de mail qui fonctionne bien pour hotmail, gmail ou autre mais qui apparemment ne poste pas sur les adresses yahoo, orange ou wanadoo... Une piste ?
Merci pour ce plugin très pratique
Répondre à ce message
Groupe de champs
Comment supprime t’on un « Groupe de champs », je ne vois pas de boutons pour ça, si j’ai créé par erreur une telle zone ?
Il y a un bouton supprimer comme pour tous les autres types de champ.
Répondre à ce message
Bonjour,
Ce plugin m’a sauvé la vie, je suis fan !
Cependant j’aimerais savoir si il est possible d’insérer dynamiquement une image dans un champ « explication » (ou autre), un logo d’article par exemple. J’ai essayé avec les paramètres #ARRAY, je n’arrive à rien...
Merci
Tu peux mettre un appel à n’importe quelle image des documents de SPIP.
<img1234>
Et dynamiquement non, pas dans un champ explication. Le tableau à passer concerne les valeurs de champ, or les explications ne sont pas des champs. Donc pour l’instant ce n’est pas possible.
Oui mais justement je ne veux pas mettre de numéro d’image, je veux que ce soit dynamique.
En gros mon formulaire est dans un squelette « article.html » et je veux que selon l’article sur lequel on est, ca affiche le logo de celui-ci, ou une image qui serait liée à cet article.
Si ce n’est pas possible tant pis, je mettrai mon image en dehors du formulaire, je suis déjà très contente de mon formulaire :)
J’avais pas vu ta dernière réponse. Je me doutais bien qu’on pouvait pas mettre de données dynamiques dans le champ explication, j’avais essayé avec un texte simple, ca ne faisait rien non plus. J’ai essayé avec un champ texte, mais du coup ca affichait le code source de l’image, donc pas bon non plus.
Je vais mettre mon image en dehors du formulaire, tant pis !
Merci d’avoir répondu ! :)
Répondre à ce message
Bonjour,
Je viens d’installer formidable et j’ai un message d’erreur en lien avec la base (voir document joint). Il semblerait qu’il s’agit d’un cas première fois. Que puis-je faire ?
Cordialement.
Versions :
PHP 5.3.10
MySql 5.1.61-log
spip 2.1.12
Formidable 0.6.6 - stable
jQuery UI 1.8.16
Saisies pour formulaires 1.24.3
API de vérification 0.1.13
Facteur 1.8.5
YAML 1.5.0
Répondre à ce message
Bonjour,
Est-il possible d’envoyer via un champs caché, id_auteur pour un auteur enregistré ?
J’ai essayé avec #ID_AUTEUR, et le formulaire me renvoie #ID_AUTEUR (il y a une forme de logique, mais je voudrais le contenu).
Cdlt
GG
Dans un appel venant d’un contenu ce n’est pas possible (sauf si tu programmes toi-même un modèle en squelette, qui lui appellera le formulaire).
En squelette on peut passer ce genre de paramètre avec le deuxième argument, comme expliqué dans la doc (un tableau de valeurs).
Répondre à ce message
Bonjour,
Existe-t-il une option « dépendance » pour formidable ?
Je souhaite qu’un formulaire ne s’affiche qu’à partir du moment où un autre a été rempli avant.
C’était une option de F&T que je n’ai jamais fait fonctionner correctement, mais qui me serait bien pratique ...
A+ et merci pour le travail déjà fait.
cordialement
GG
Non cela n’existe pas pour le moment. Tu peux peut-être essayer de le simuler en faisant des tests en amont dans tes squelettes avant d’afficher un formulaire. Tu testes si le visiteur actuellement connecté a une réponse enregistré dans un autre formulaire et seulement si oui tu affiches le deuxième, un truc dans ce genre.
Répondre à ce message
Bonjour,
j’ai un problème avec le champ « explication » je peux l’ajouter à un formulaire mais ensuite pas moyen de le modifier ou de le supprimer (vu sur 2 sites).
dd
Répondre à ce message
Bonjour,
Le plugin fonctionne bien avec l’insertion du modèle standard par
. Mais je souhaiterais aligner les différents champs et ne trouve pas la localisation des CSS utilisées par le modèle standard.
Ou mettre le style « .formulaire_formidable label » ? J’ai essayé de balader « spip_formulaires.css » avec l’ajout de ces styles de partout, mais cela n’apporte rien.
Merci de vos réponses, Olivier
Précision,
Le plugin fonctionne bien avec l’insertion du modèle standard par formulaire|formidable|id=1.
Le code d’appel avec les balises avait disparu du message...
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 : |