Formidable, le générateur de formulaires

Un générateur de formulaires facilement configurable pour les non-informaticiennes et facilement extensible pour les développeur⋅euses.

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).

Options possible comme troisième argument de #FORMULAIRE_FORMIDABLE
Nom de l’optionFonctionType
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 destinataires
formulaire_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)

Discussion

811 discussions

  • 1

    Bonjour,

    dans le but d’utiliser le formulaire comme un moteur de devis, peut-on à votre avis faire en sorte que les données soient converties dans un PDF ?

    Merci :)

    • Aucune idée, je ne me suis jamais amusé encore à générer du PDF à partir d’un site, mais il y a des plugins pour ça sur Contrib et SPIP-Zone, donc après tu fais ce que tu veux dans les squelettes qui génèrent ça.

      Par exemple il y a cette librairie qui est un logiciel libre pour faire du PDF à partir de PHP :
      http://contrib.spip.net/FPDF

      Mais je ne sais pas moi-même comment ça s’utilise.

    Répondre à ce message

  • 7
    Philippe B

    Bonsoir,

    Je suis en train de migrer mon site sous SPIP 3 et je voudrais utiliser le plugin Formidable.
    J’ai fait un 1er formulaire que j’appelle depuis un squelette.
    Mais je rencontre pas mal de difficultés avec des messages d’erreurs qui s’affichent en haut de l’écran, et que je n’arrive pas à analyser.
    Le 1er message devait être lié à un essai de masque dans un champ texte (je voulais faire saisir une heure).
    J’ai supprimé le masque, j’ai obtenu un autre message d’erreur.
    J’ai supprimé ce champs Heure, le message a changé, et maintenant j’obtiens celui-ci :

    Strict Standards : Non-static method Facteur::html2text() should not be called statically in U :\Documents\.....\SPIP 304\plugins\formidable_1_0\traiter\email.php on line 109

    Je pense qu’il est lié à 1 champ d’adresse email, mais je n’en suis pas certain, et je ne vois pas ce que je peux faire.

    Quelqu’un a-t-il des idées pour corriger cela ?

    Merci par avance

    Philippe

    • Non c’est juste que tu as installé ton SPIP sur du PHP4 alors que ce n’est plus supporté depuis fort SPIP 3 (et obsolète depuis bien plus longtemps).

      Il faut regarder la doc de ton hébergeur pour activer PHP5 (souvent une ligne dans le .htaccess).

    • Philippe B

      Un complément à mon message :
      Comme je pensais que le champ d’adresse email était celui concerné par le message d’erreur que j’ai cité, je l’ai enlevé.
      Mais manque de chance, j’ai toujours le message d’erreur, ce n’est donc pas cela !

    • Philippe B

      Bonsoir,

      Merci pour cette réponse très rapide que je n’ai même pas vue alors que je postais un complément !

      Par contre, les essais que je fais sont en local, et j’utilise easyPHP 12.1.

      Je vais voir comment faire.

      Merci encore !

      Philippe

    • Philippe B

      Bonsoir,

      Merci pour cette réponse très rapide que je n’ai même pas vue alors que je postais un complément !

      Par contre, les essais que je fais sont en local, et j’utilise easyPHP 12.1 et la version de php est la 5.4.6.

      Donc ça devrait marcher, non ?

    • Ben tu parles de plusieurs erreurs différentes qui n’ont peut-être (sûrement) aucun rapport, donc je ne sais pas...

      Pour le truc de Facteur, ce genre d’erreur apparaît d’habitude quand on est dans une vieille version de PHP qui n’a pas le langage objet comme les récentes. Je ne reproduis pas pour l’instant en tout cas.

      Pour les autres erreurs, sans URL pour voir (le mieux, comme l’indique le lien « les choses à faire avant de poser une question ») ou sans la copie des messages d’erreurs, je ne peux pas inventer de réponse. :)

    • Philippe B

      Bonsoir,

      Oui, je me doute bien que les différentes erreurs que j’ai rencontrées n’ont rien à voir entre elles, mais à chaque fois que je voulais enlever un champ pour vérifier qu’il était lié au message d’erreur que je rencontrais, j’en obtenais un autre, et ainsi de suite.

      Il me semblait donc qu’il y avait sans doute un problème global expliquant toutes ces erreurs.

      Quoi qu’il en soit, je me suis aperçu que l’erreur sur la méthode Facteur se produit quand je saisis un destinataire supplémentaire pour l’envoi du résultat du formulaire (je voudrais faire un formulaire de réservation).

      Merci de ton aide !

      Philippe

    • Philippe B

      Bonsoir,

      Je viens de pouvoir mettre en ligne le site sur lequel je compte utiliser le plugin Formidable et je n’ai plus d’erreur ; c’est donc effectivement sans doute un problème à la configuration en local.

      Le principal étant que ce soit OK en opérationnel !

      Merci pour ce plugin !

      Philippe

    Répondre à ce message

  • 1

    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.

    L’y modifier à ma guise, c’est beaucoup dire !

    Comment peut-on agir sur l’affichage des champs/valeurs ?
    Par exemple :
    -  un champs est vide, le visiteur ne l’a pas rempli : peut-on ne pas afficher ce champ ni son compère « sans réponse » ?
    -  ça affiche le champ, ça saute une ligne, puis on a la valeur : pourrait-on par exemple afficher la valeur sur la même ligne que le champ ?
    -  les champs sont affichés en gras, et les valeurs en normal : pour moi ce qui est important, c’est la valeur et nom pas le nom du champ, comment peut-on réaliser cela ?
    -  etc.

    Ce que je demande, Rasta, c’est où se trouve la partie de code où les résultats d’un questionnaire sont mis en page pour les mails de notification et de accusé réception ? Dispose-t-on d’une méthode pour bricoler, même modestement, la fabrication du mail, comme par exemple on peut le faire avec la fabrication du sujet du mail de notification ? Y compris en ajoutant des traitements pour y parvenir.

    Ce plugin est tellement génial qu’on est presque triste qu’il ne fasse pas le café.

    Yanic

    • où se trouve la partie de code où les résultats d’un questionnaire sont mis en page pour les mails de notification et de accusé réception

      Dans « notifications/ » du plugin. Ces squelettes utilisent en fait exactement la même méthode que dans l’espace privé pour générer la vue d’une réponse : #VOIR_SAISiES{une liste de saisies, une liste de valeurs} qui génère l’ensemble des vues (une par une donc) d’un tableau listant des saisies.

      C’est donc du tout-en-un qui génère tout en une fois, puisque c’est générique, on ne peut pas savoir à l’avance le nombre de champs, leur type (une ligne ou plusieurs, etc).

      Si on veut faire des choses différentes, ça demande du bidouillage. Actuellement c’est un peu compliqué mais on pourrait imaginer quelques balises supplémentaires qui faciliterait un peu la tâche.

      Tout comme les saisies elles-mêmes, les vues sont gérées une par une dans des squelettes dédiés, dans le dossier « saisies-vues ». Un squelette par défaut « _base.html » est appelé en amont, qui affiche soit directement la vue, soit appelle une personnalisation pour un type de saisie précis si elle existe (par exemple « checkbox.html »).

      Tu peux donc surcharger ces squelettes si tu le veux, mais dans ce cas, ça le fera pour toutes les vues de ces saisies, pas juste pour un formulaire et pas juste pour un email, aussi dans l’espace privé.

    Répondre à ce message

  • 1

    Bonjour,
    y-a-t-il un moyen de récupérer l’adresse e-mail saisie dans mon formulaire, pour y envoyer un accusé réception généré dans le plugin TRANSACTION de paiement en ligne
    (mon formulaire aboutit sur la procédure de paiement en ligne TRANSACTION, avec appel à l’API de la banque ; et je voudrais envoyer un accusé réception à la personne qui a fait le paiement, avec le récapitulatif de son paiement. Mais je ne sais pas comment récupérer toutes les variables de mon formulaire, parmi lesquelles l’adresse e-mail saisie)

    Merci
    Saporito

    • Il y a un traitement « envoyer par email » pour ça, et dans la code juste au-dessus il y a une explication du nom du squelette que tu peux utiliser pour personnaliser l’accusé de réception pour un formulaire précis (avec son identifiant). Le squelette par défaut se contente d’afficher une vue de chacun des champ rempli. Après pour personnaliser plus finalement, ça dépend du besoin.

    Répondre à ce message

  • 3

    Bonjour,

    Je rencontre un problème avec l’export des données au format CSV : l’@ est remplacée par une espace dans les emails.

    URL utilisée pour l’export : ecrire/ ?exec=formulaires_reponses&action=exporter_formulaires_reponses&arg=8&hash=364ec9cb21998d73dbcce11998a3d2a0a093ff8a

    • Les exports pur l’instant n’ont pas deux modes brut/formaté, mais sont toujours traduits en vues des saisies bien formatés.

      N’aurais-tu pas un filtre activé quelque part dans |propre qui vire ces @ sur ton site pour les histoires de robots ? Et comme les données sont formatées, ça l’utilise.

      Si ce n’est pas le cas, je ne sais pas quoi pour l’instant. :)

    • Effectivement, j’ai la lame du CS mailcrypt.

      Je vais poster chez l’impétrant.

    • Ben ça va rien changer non ? Lui il s’insère dans propre, il peut pas savoir dans quel contexte et l’activer ou pas, je pense.

      Faudrait surtout un mode « brut » qui ne formate pas les vues, justement pour faire des sorties plus orientées machine car le tableur permet de traiter aussi en masse pour tel ou tel besoin.

    Répondre à ce message

  • 4

    Bonjour,

    Le plugin Formidable a un comportement très gênant sur un de mes sites en SPIP 3.0.5.

    En effet il force à remplir les champs obligatoires dans l’espace privé et pas seulement une fois rendu sur l’espace public. En d’autres termes je ne peux pas modifier de champ dans l’interface d’administration si je n’ai pas rempli tous les champs obligatoires du formulaire au préalable.

    Ça rend les modification ultra laborieuses. Comme si les vérifications étaient actives partout.

    Il s’agit de la dernière version de SPIP avec tous les plugins à jour. J’ai aussi les plugins : Agenda, couteau suisse, zpip, crayons, spip-bonux, mini bando et mini calendrier.

    Des pistes ? Quelqu’un d’autre rencontre ce problème ?

    • Si, plusieurs fois reporté dans ce forum et sur la liste de discussions des plugins.

      Récemment : http://thread.gmane.org/gmane.comp.web.spip.zone/29309/focus=29560

      Avec en prime une solution temporaire en javascript par Suske. Faudrait faire la même chose mais en PHP pendant la génération.

    • La solution de placer :

      <script type="text/javascript">
      $(document).ready(function(){
      $('*').removeAttr('required');
      });
      </script>

      dans le fichier formidable/prive/contenu/formulaire_edit.html

      Je viens d’essayer, vider le cache... Sous Firefox et Chrome, le contrôle du navigateur semble toujours opérant.

      Dans mon cas l’astuce ne semble donc pas fonctionner... :-\

    • Grmpf, j’ai omis de revenir préciser, sorry : http://permalink.gmane.org/gmane.co....

      Avec l’ajax, lors des modifications, le (document).ready n’est pas activé du coup j’ai ajouté :

      $('.bd').hover(function(){
      $('*').removeAttr('required');
      });

      En fait ce seul code suffit du coup, je pense.

      Ce sera inclus dans la v. 1.3.4 du plugin... (dispo vers 18h)

    • Bravo pour la réactivité :) !

      J’essaye ça demain.

    Répondre à ce message

  • 4

    Bonjour,
    J’ai installé formidable est ses dépendances sur plusieurs sites sans problème.

    Mais sur l’un deux j’ai un soucis avec 6 erreurs
    donc voici la capture ci-dessous.

    Pouvez-vous m’aider à ce sujet ?

    Merci

    Jérôme

    • Le plugin ne s’est pas installé puisqu’il n’y a pas les tables. Tu trouveras moult message de ce forum avec la même erreur. Apparemment ça vient du fichier de déclaration des tables (dans base/) qui a des fins de ligne windows pourries qui ne sont pas reconnues chez certains hébergeurs. Du coup ça fait comme si tout le fichier était en une seule ligne, donc n’importe quoi.

      C’est avec la version pour SPIP 2.1 ?

    • En effet, le problème est réglé. Vraiment merci pour ce suivi rapide et efficace...
      Je vais pouvoir poursuivre le développement du site.

    • Euh, juste signalé un soucis entre cette nouvelle version de formidable et le plugin formitable.

      au niveau de formitable/traiter/table.php on line 2

      En désactivant formitable, plus de soucis.

    Répondre à ce message

  • 1

    Bonsoir,
    Sous Spip 2.1.19 avec Formidable 0.6.6 (et tout ce qui va autour).

    Quand je configure un formulaire pour afficher « les valeurs saisies » après validation, cela m’affiche (comme indiqué dans ce message) « sans réponse » à chaque champ alors qu’ils ont tous été bien renseignés.

    Plus gênant : quand une erreur de saisie est commise (oubli d’un champ obligatoire, valeur non admise par un champ), le message d’alerte s’affiche bien, mais l’ensemble des saisies du formulaire disparaît, il faut donc tout ressaisir ce qui est rédhibitoire pour l’usager...

    Est-ce que ces dysfonctionnements sont connus, est-ce moi qui ait mal configuré mon formulaire ?...

    Merci,
    Luc

    • Non ce n’est pas normal. Je ne connais pas les options pour changer ce qui est affiché après la validation, vu que ce n’est pas moi qui ait ajouté ça et que je ne l’utilise pas pour l’instant, donc je ne saurais dire. Il faudrait que je teste chez moi pour voir.

    Répondre à ce message

  • 1

    Bonjour

    J’essaie de faire fonctionner le plugin formidable avec le plugin transaction, et je n’arrive pas à récupérer le montant saisi. Autrement dit, je n’arrive pas à me débrancher sur l’écran de choix du mode de paiement du plugin transaction( chèque CB, virement.)
    En fait,, mon problème vient du fait que je ne sais pas quel nom du fichier
    mettre dans l’adresse de redirection du formulaire formidable, qui prend en compte le montant saisi ;
    Merci de votre aide.
    Patrick

    • affaire réglée, je viens de trouver mon erreur, il ne fallait justement pas mettre d’adresse de redirection
      Patrick

    Répondre à ce message

  • 3

    bonsoir
    j’ai installé Formidable depuis peu sur un site d’école en vue de créer un formulaire permettant à des élèves de créer des fiches de lecture.
    Le formulaire s’affiche, la saisie des données et ok, MAIS :
    -  après validation, le message prévu s’affiche avec le titre des champs accompagnés de « sans réponse »
    -  comment faire apparaître instantanément sur le site public les contenus de ces formulaires ?

    pour l’instant je fais des copier-coller des résultats en espace privé dans un article dédié. C’est propre mais fastidieux.
    voir ici : http://ecole.cadou.free.fr/spip.php?article321

    merci !

    • - après validation, le message prévu s’affiche avec le titre des champs accompagnés de « sans réponse »

      Pas normal, tu as sélectionné quoi dans la config du formulaire pour ce qui doit être affiché après validation ?

      - comment faire apparaître instantanément sur le site public les contenus de ces formulaires ?

      Il y a un modèle pour afficher les réponses. Dans un squelette tu peux donc faire une boucle sur les réponses à ce formulaire et utiliser ce modèle en lui donnant l’identifiant de chaque réponse.

    • bon, j’ai viré l’affichage après saisie du formulaire puisque j’obtiens des « sans réponse » ou un truc du genre.
      Par contre, dans l’espace privé, mes résultats de formulaire apparaissent comme « publié en ligne ».
      Je veux bien, mais où ?
      Où se trouve le modèle pour l’affichage dont tu parles ?
      une petite ligne de code serait la bienvenue pour démarrer les fameuses boucles sur les réponses car là, vraiment, je ne sais plus faire.

      merci, merci, merci d’avance !

    • http://zone.spip.org/trac/spip-zone/browser/_plugins_/formidable/trunk/modeles/formulaires_reponse.html

      <BOUCLE_formulaire(FORMULAIRES){identifiant=truc}>
          <BOUCLE_reponses(FORMULAIRES_REPONSES){id_formulaire}>
               #INCLURE{modeles/formulaires_reponse, id_formulaires_reponse}
          </BOUCLE_reponses>
      </BOUCLE_formulaire>

    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 :

  • Désactiver tous les plugins que vous ne voulez pas tester afin de vous assurer que le bug vient bien du plugin X. Cela vous évitera d’écrire sur le forum d’une contribution qui n’est finalement pas en cause.
  • Cherchez et notez les numéros de version de tout ce qui est en place au moment du test :
    • version de SPIP, en bas de la partie privée
    • version du plugin testé et des éventuels plugins nécessités
    • version de PHP (exec=info en partie privée)
    • version de MySQL / SQLite
  • Si votre problème concerne la partie publique de votre site, donnez une URL où le bug est visible, pour que les gens puissent voir par eux-mêmes.
  • En cas de page blanche, merci d’activer l’affichage des erreurs, et d’indiquer ensuite l’erreur qui apparaît.

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.

Qui êtes-vous ?
[Se connecter]

Pour afficher votre trombine avec votre message, enregistrez-la d’abord sur gravatar.com (gratuit et indolore) et n’oubliez pas d’indiquer votre adresse e-mail ici.

Ajoutez votre commentaire ici

Ce champ accepte les raccourcis SPIP {{gras}} {italique} -*liste [texte->url] <quote> <code> et le code HTML <q> <del> <ins>. Pour créer des paragraphes, laissez simplement des lignes vides.

Ajouter un document

Suivre les commentaires : RSS 2.0 | Atom