Formidable, le générateur de formulaires

Publié le : 23 janvier 2012 – Dernière modification le 19 mars 2024 – par Maïeul, RastaPopoulos – 3519 commentaires

1
2
3
4
5
199 votes

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

5 ans 1 an 3 mois Sans limite
par date
Filtrer

812 discussions

  • 7
    paolo

    Bonsoir !
    Personnaliser le mail en utilisant formulaire_IDENTIFIANT_email.html marche très bien. Mais je ne trouve pas comment isoler une réponse particulière du formulaire et l’insérer dans le texte de l’email. Je me dis que cela doit être possible avec la boucle DATA ? Ou est-ce autrement qu’il faut faire ?

    • RastaPopoulos

      Isoler la réponse à une seule des questions du formulaire c’est ça ?

      Dans le squelette tu as déjà le tableau de toutes les valeurs dans #ENV*{valeurs} mais il faut l’afficher correctement avec #VOIR_SAISIES sauf que pour cette balise il ne faut pas passer toutes les saisies mais seulement celle que tu veux.

      [(#REM) Récupérer la saisie "input_2" uniquement et l'encapsuler dans un tableau (en SPIP 3) ]
#SET{ma_saisie, #LISTE{#ENV*{saisies}|saisies_chercher{input_2}}}

#VOIR_SAISIES{#GET{ma_saisie}, #ENV*{valeurs}}

      Je crois que ça devrait marcher. :)

    • paolo

      RastaPopoulos, c’est très bien. Merci ! Est-ce que j’ajoute ces infos dans l’article ? Je pense qu’elles peuvent être utiles à d’autres (ou est-ce trop compliqué) ?

      Et, en même temps, puis-je demander de m’aider encore un pas plus loin ?

      La réponse que j’obtiens avec #VOIR_SAISIES ressemble à :
      nom du champ
      réponse

      J’aimerais encore nettoyer cela de deux points de vue. D’abord je ne veux pas le nom du champ du tout. Deuxièmement, le champ en question ce sont des boutons radio. Et je souhaite récupérer la clé, non pas la valeur montrée au visiteur. Est-ce faisable ?

      (Le but : construire un message qui dit : SUBSCRIBE ou UNSUBSCRIBE pour l’abonnement/désabonnement à une liste.)

    • RastaPopoulos

      Aaaaaah ok ben dans ce cas là c’est encore plus simple ! Puisque c’est juste le tableau #ENV*{valeurs} qui contient les valeurs classées par leur nom de champ.

      Donc juste : [(#ENV*{valeurs/input_2})] (en SPIP 3 toujours) ou bien avec table_valeur en SPIP 2. Là tu n’auras donc que la valeur « brute » pas joliment présentée avec les « vues » des saisies.

      Pour info, pour avoir les vues jolies mais sans le label des champs, il faut ajouter le paramètre valeur_uniquement=oui à #VOIR_SAISIES.

    • paolo

      [(#ENV*{valeurs/input_2})] - c’est exactement ce qu’il me fallait. Merci bcp. RastaPopoulos !

      Par contre,
      #VOIR_SAISIES{#ENV*{saisies}, #ENV*{valeurs},valeur_uniquement=oui} et
      #VOIR_SAISIES{#ENV*{saisies}, #ENV*{valeurs}}
      donnent exactement le même résultat (avec label).

    • RastaPopoulos

      Effectivement, je crois qu’il y a un manque dans le code de la fonction saisies_generer_vue() qui ne récupère pas ce paramètre s’il n’y a que ça.

      Par contre en forçant la prise en compte de tout l’environnement ça devrait le prendre : ..., valeur_uniquement=oui, env}

    • paolo

      Non. Ça ne marche pas non plus. Mais, pour ce qui me concerne maintenant, ce n’est pas grave.

    • DesignWeb

      Bonjour,

      Pour SPIP 2, voici ce qu’il faut écrire pour avoir la valeur brute :

      [(#ENV*{valeurs}|table_valeur{input_2})]

      Merci RastaPopoulos !

    Répondre à ce message

  • 2
    guilaind

    J’ai un problème récurrent depuis que je suis en spip 3 et que je pensais voir se régler avec les dernières maj du plugin. Quand je veux modifier un champ obligatoire existant, tous les champs obligatoires s’entourent de rouge et le message « Veuillez compléter ce champ » s’affiche : voir image.

    Pour pouvoir créer un formulaire rapidement, je suis obligé de le créer sous une ancienne sauvegarde en spip 2, de l’exporter depuis spip 2 pour l’importer en spip 3. Corriger un commentaire ou une simple faute prend des allures d’expédition...

    Mon site est en SPIP 3.0.5. Tous les plugins sont à jour :
    API 0.1.16
    Autorité 0.0.12
    Cache Cool 0.2.5
    CFG 3.0.0
    Champs extras 3.2.1
    Champs extras (interface) 3.1.0
    Comments 3.0.14
    Crayons 1.13.8
    Edition directe 3.2.5
    Facteur 2.2.6
    Formidable 1.3.2
    Couteau suisse 1.8.98
    menu jquery superfish 0.5.3
    menus 1.2.4
    nospam 1.0.3
    Notation 2.0.4
    Notifications 2.1.4
    piwik 0.5.1
    Polyhierarchie 2.0.4
    Pub banner 1.30.2
    Saisies 1.26.6
    Spip bonux 3.0.3
    Tip a friend 1.6.2
    Yaml 1.5.0

    Quelqu’un aurait-il une piste ?

    • RastaPopoulos

      Je pense que tu as activé HTML5, et donc le plugin Saisies ajoute un attribut required qui fait du coup un test client. Formidable n’a pas été modifié pour HTML5 pour l’instant.

    • guilaind

      Merci RastaPopoulos. En désactivant le html5, je peux effectivement modifier mon formulaire. J’avais regardé ceci, mais le texte sur la page ecrire/ ?exec=configurer_avancees ne parlait que de l’interface publique :

      Vous pouvez demander à SPIP de produire, sur le site public, du code compatible avec la norme HTML4, ou lui permettre d’utiliser les possibilités plus modernes du HTML5.

      Il serait peut judicieux d’ajouter que le html5 est aussi bien sur la partie publique que la partie privée

    Répondre à ce message

  • Mehdi

    Bonjour,

    Bug à remonté

    En passant mon site en HTLM5, l’affichage des champs date BUG, l’icone du petit en forme de callendrier.

    Plus grave, il est impossible de d’éditer, d’ajouter ou de supprimer un champs d’un formulaire

    Répondre à ce message

  • jlg13

    J’aimerais rajouter un champ où depuis l’espace public, un utilisateur puis uploader une image (pour un cv).
    Comme ce module pour les questions où je peux ajouter un document...

    Répondre à ce message

  • 2
    fd

    bonjour,

    Je cherche une solution pour effectuer des sondages. Est ce que ce plugin permet cela ? Si oui comment dois je procéder ? Merci

    • RastaPopoulos

      Oui ce plugin le permet. Il suffit pour cela de choisir le traitement pour enregistrer les résultats en base, et d’interdire de répondre plusieurs fois.

      L’administrateur peut alors voir les résultats enregistrés mais aussi une analyse d’ensemble des réponses, cad une addition pour chaque réponse possible.

      Dans la dernière version du plugin (pour SPIP 3) c’est même encore plus simple et le plugin fait des petits graphiques au lieu de juste afficher les chiffres.

    • fd

      wow merci ! je vais commencer à tester tout ça très bientôt alors, merci !

    Répondre à ce message

  • 2
    Claude Bureau

    Version Spip 3.0.4 pour un site chez Free (http://graver.maintenant.free.fr).
    (PHP 5.1.3RC4-dev et MySQL 5.0.77).
    Dans le plugin « Formidable » mis à jour le 9/9/2012, l’importation des formulaires sauvegardés en Yaml produit l’affichage du message suivant : « Fatal error unsuported operand types in /.../.../formulaires/formidable.php on line 54 ».
    Que faire ?
    Merci d’avance

    • Claude Bureau

      J’ai édité le fichier « formidable.php »
      Dans la ligne 54, il y avait le signe + devant le signe =, je l’ai supprimé.
      De même dans la ligne 48, il y avait le signe + devant le signe =, je l’ai supprimé.
      Sauvegarde puis transfert du fichier « formidable.php » dans mon site.
      Miracle, tout fonctionne.
      Formidable est formidable.
      Je suggère que ce fichier soit corrigé de même dans la version zippée 1.3.1 (ou 1.3.2).
      Mais, cela je sais pas faire.
      Formidable merci pour ce plugin.

    • RastaPopoulos

      L’addition de deux tableaux est totalement licite, il s’agit d’une union, en gardant l’indexation des clés. Il ne me semble pas que ce soit quelque chose de récent en PHP (donc pas un problème de version). Mais peut-être est-ce parce que dans un cas particulier, ça essaye d’additionner deux choses de type différent : un tableau et autre chose par exemple.

      Ah voilà, en vérifiant : http://fr2.php.net/manual/fr/function.array-fill-keys.php cette fonction n’est disponible qu’à partir de PHP 5.2.

    Répondre à ce message

  • 6
    skol

    Spip 2.1.16
    PHP Version 5.1.3RC4-dev
    Formidable : Version : 0.6.6 [65153]
    API de vérification Version : 0.1.16 [65373]
    facteur : Version : 1.8.9 [60363]
    Saisies : Version : 1.26.6 [65607]
    Bonux : Version : 2.3.0 [61354]
    YAML : Version : 1.5.0 [63998]
    jQueryUI : Version : 1.8.19 [63872

    Bonjour,

    Voilà le petit souci.. tout se passe bien dans la création du questionnaire. Je peux répondre au questionnaire et le recevoir mais uniquement si je suis dans l’espace privé et dans l’espace « modifier l’article » .. autrement dit impossible de visualiser en privé et en public le formulaire. Merci si vous avez une idée. Merci aux contributeurs qui aident ;-).

    skol

    • RastaPopoulos

      Oui mais ça affiche quoi dans le site alors ? Du vide ou une erreur ?

    • skol

      du vide et je me suis trompée, cela marche uniquement dans la partie de conception du formulaire..

      merci encore..

      skol

    • RastaPopoulos

      Et quel est le code que tu mets dans tes articles ?

    • skol
      <?php include_once("/opt/nursit/sys/home/nursit/matrice/public/4.2/07/spip/ecrire/balise/formulaire_.php"); if ($lang_select = "fr") $lang_select = lang_select($lang_select); inserer_balise_dynamique(balise_FORMULAIRE__dyn(arguments_balise_dyn_depuis_modele('FORMULAIRE_PRECONVENTION')), array('', '', '', '', 'fr', '1')); if ($lang_select) lang_select(); ?>

      preconvention est l’identifiant du formulaire

      formulaire|preconvention

      INCROYABLE si je mets les < > .. le code ne s’affiche pas dans CE message !

    • RastaPopoulos

      Il n’y a rien d’incroyable, du code doit être entouré de la balise <code>

      À part ça, le code que tu insères n’a rien à voir avec celui indiqué par la doc, donc ça ne risque pas de marcher.

      <formulaire|truc> c’est pour insérer le formulaire CVT (fournit par SPIP ou un plugin) nommé « truc ». Correspondant à #FORMULAIRE_TRUC dans un squelette.

      Pour Formidable, la doc est juste au-dessus de ce forum, dans le chapitre « Appeler mon formulaire ». :)

    • skol

      Je suis con-fuse ... merci ;-)

    Répondre à ce message

  • 2
    grp

    Bonjour,

    je me sers de ce plugin pour mettre en place des annonces sur mon site, et, dans l’affichage public des réponses (affichage réponse par réponse), la mise en forme (saut de ligne et puces notamment) n’est pas respectée alors qu’elle l’est dans l’interface privée.

    J’ai regardé le code de l’affichage des réponses dans l’interface privée et je ne trouve pas comment faire pour conserver la mise en forme...

    merci

    • RastaPopoulos

      Le HTML généré est le même à priori, donc c’est juste que tu n’as pas les bons styles CSS. À toi de faire en sorte que le thème de ton site affiche ce HTML comme tu l’entends, mais le plugin ne fournit (et n’a pas à fournir) de CSS.

    • Bonjour,

      j’affiche mes réponses champ par champ, individuellement car certaines réponses n’ont pas vocation à être sur le site public. Dans les boucles je n’avais pas ajouté le filtre |propre. Du coup maintenant cela fonctionne correctement.

    Répondre à ce message

  • 3
    Francky

    Bonjour

    Petit bug sous spip 2.1.17 et 3.0.4
    PHP 5.2.17
    Lorsque l’on fait l’appel du formulaire dans un article, et quand dans porte plume l’on clique sur « voir »

    Le formulaire n’apparait pas, mais à la place, il y a (pour un formulaire ayant comme identifiant « inscription » )
    http://spip.pastebin.fr/24044

    Et cela qu’il s’agisse de la création d’un article ou de la modification d’un article déjà en ligne.
    Cordialement, Franck

    • RastaPopoulos

      Avec tous les plugins non nécessaires désactivés ?

    • Francky

      Oui
      PHP 5.2.17

      J’ai activer que les plug suivant :

      SPIP 3.0.4 [19781]
      API de vérification 0.1.16 SVN [65373]
      Facteur 2.2.5 SVN [65621]
      Formidable 1.3.0 SVN [65633]
      Saisies 1.26.6 SVN [65607]
      Bonux 3.0.3 SVN [65597]
      Yaml 1.5.0 SVN [63998]

      SPIP 2.1.17 [19782]
      API de vérification 0.1.16 [65373]
      Facteur 1.8.9 [60363]
      Formidable 0.6.6 [65153]
      jQuery UI 1.8.19 [63872]
      Saisies 1.26.6 [65607]
      Bonux 2.3.0 [61354]
      Yaml 1.5.0 [63998]

    • RastaPopoulos

      Je confirme sur un SPIP 3. Ça viendrait plutôt de la prévisu du porte-plume, parce que pour ce qui est du modèle d’insertion ça ne vient pas du tout de ce plugin, mais du modèle <formulaire|truc> de base fourni par SPIP.

    Répondre à ce message

  • jlg13

    Yop yop,

    j’ai un formulaire (fait avec formidable) dans un article, j’aimerais que l’on puisse le remplir et passer sur un autre article et que le formulaire y soit repris avec les champs déjà complétés.

    Des idées ?

    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