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

  • 2
    Marco

    Bonjour et merci pour ce Formidable plugin.

    J’ai une petite question d’ordre philosophique. Je plaisante...
    Comment pourrais-je faire, dans un champ caché, pour additionner les « valeurs » (en terme de formulaire) pendant le saisie.

    J’ai radio_1, radio_2 et radio_3 par exemple avec des valeurs (ou clé) comme cela :
    4|Pas du tout d’accord
    3|Pas d’accord
    2|D’accord
    1|Tout à fait d’accord

    Comment avoir hidden_1 = radio_1 + radio_2 + radio_3 ? par exemple 6 si d’accord pour les trois.

    Merci de votre attention.

    • RastaPopoulos

      Si c’est pendant la saisie, c’est forcément en Javascript (donc il faut savoir coder en JS ou connaître quelqu’un qui sait). En testant dès que ces champs changent et en remplissant le hidden dès que c’est le cas.

    • Marco

      Merci pour ta réponse rapide.

      Questions complémentaires.
      C’est possible après la saisie ?

      Sinon, comment récupérer cette valeur numérique dans une boucle ?

      Merci encore.

    Répondre à ce message

  • 2
    pgiron

    Bonjour,
    Je souhaiterai savoir s’il est possible de créer un article à partir de la réponse à un formulaire ? Je ne vois pas trop comment faire... :-/
    Cordialement,
    Philippe

    • pgiron

      Je précise que je suis en SPIP 3.

    • RastaPopoulos

      Ben tu peux t’amuser à faire des novueaux traitements qui font ce que tu veux, si tu sais coder en PHP (ou si tu connais quelqu’un). Mais ce n’est pas du tout fait pour ça à la base (et on peut parfaitement utilisé #FORMULAIRE_EDITER_ARTICLE dans la partie publique ou des variations). Et je ne connais pas de sous-plugins qui font ce genre de chose.

    Répondre à ce message

  • 4
    François Schreuer

    Bonjour,

    Merci encore pour ce plugin effectivement formidable, qui permet de faire tant de choses (là, je l’utilise pour gérer les souscriptions à une revue que nous lançons à Liège et ça marche parfaitement).

    J’ai deux besoins particuliers,

    * Est-il possible de demander une validation de l’adresse courriel avant de prendre en compte le contenu du formulaire ?

    * Est-il possible de conditionner l’affichage d’un champ à deux valeurs d’un autre et non à une seule (j’ai essayé des choses comme @mon_champ@="val1|val2" mais ça ne fonctionne pas).

    Merci

    François

    • RastaPopoulos

      Pour le premier point je ne vois pas de solution simple immédiate à part n’autoriser à voir le formulaire que pour des personnes ayant un compte utilisateur sur le site (en leur faisant créer d’abord un compte utilisateur visiteur, puis en mettant le formulaire sur une page où seuls les utilisateurs peuvent le voir).

      Pour le deuxième point à priori il n’y a pas de blocage, il s’agit de code javascript classique, donc c’est plutôt « == » et non pas « = », et avec des « and » ou « or » :

      @champ@ == "valeur1" or @champ@ == "valeur2"

      Un truc de ce genre là. Enfin si mes souvenirs sont bons il me semble bien que c’est interprété et transformé en javascript (ce n’est pas moi qui ait ajouter cette fonctionnalité dans Saisies).

    • François Schreuer

      Merci pour la réponse.

      Pour ce qui du premier point, mon idée était d’utiliser ce plugin comme substitut aux pétitions de SPIP (qui ne proposent qu’un nombre très limité de champs).

      Pour ce qui est du deuxième point, j’ai testé la formule proposée (et quelques variantes), mais ça ne fonctionne pas (et ça neutralise les autres affichages conditionnels du formulaire).

      François

    • SB

      Bonjour,

      Concernant la possibilité de conditionner l’affichage d’un champ à plusieurs valeurs d’une autre, j’ai testé car j’étais aussi intéressé par cette fonctionnalité et cela fonctionne de mon côté en utilisant des parenthèses et les opérateurs « && » (à la place de « and ») et « || » (à la place de « or »).

      Exemple :

      (@nom_champ_1@=="valeur1" && @nom_champ_2@=="valeur2")

      Cordialement.

      Sébastien.

    • RastaPopoulos

      Ah super merci. Du coup ça veut dire qu’il y a peut-être une amélioration à trouver pour que ça protège déjà tout seul avec des parenthèses par défaut, sans avoir à les mettre dans le champ.

    Répondre à ce message

  • 2
    Franck MATIGNON

    Bonjour,

    Ayant réussi à alimenter les champs par url avec #EMV (merci RastaPopoulos) j’aimerais savoir s’il est possible de verrouiller certains champs.

    Ce que j’aimerais c’est d’avoir un champ que je peux préremplir avec #EMV mais pas modifiable par l’utilisateur.

    Merci d’avance de votre aide.

    Franck

    • RastaPopoulos

      Tu peux utiliser des champs de type=« hidden » (champ caché), et les pré-remplir de la même manière (attention #ENV et non pas #EMV). Ou alors tu pourrais éventuellement aussi utiliser un champ de texte type=« text » classique, mais avec l’option « readonly ».

      Cela dit, que ce soit « text » ou « hidden », dans tous les cas un visiteur averti pourra modifier le contenu avec un inspecteur HTML, comme dans tous les navs modernes, Firefox, Chrome, etc.

    • franck

      merci.

      J’ai pu mettre faire ce que je voulais avec #ENV (dsl faute de frappe) et le readonly.

      Le formulaire sera utilisé pour envoyer des liens de paiements pour des factures traditionnelles. Si les utilisateurs modifient le montant ou quoi que ce soit cela aboutira juste a ce qu’il n’aient pas payé complètement leur facture :)

      Merci encore. Tout est OK maintenant pour moi.

    Répondre à ce message

  • DjackO

    Bonjour,

    Il me semble que j’avais déjà poser la question, il y a quelques temps (mois ou années). Dans « Configurer les traitements », j’ai mis dans le sujet du message : Enregistrement Garantie @selection_4@ . Lors de la réception du mail, dans le sujet au lieu d’avoir la valeur | label, j’ai la clé. Il me semble que j’avais déjà eu le problème, que cela avait été corrigé et voilà que ça revient.

    Autre chose, quand je demande à afficher de nouveau le formulaire après validation, car dans mon cas, un utilisateur peut enregistrer plusieurs produits, cela affiche effectivement le formulaire avec les données précédemment saisies au lieu d’avoir un formulaire vide. Ce qui me semblerait logique.

    Répondre à ce message

  • 8
    Franck

    Bonjour,

    j’essaie de remplir un formulaire par l’URL avec méthode GET mais rien n’y fait, je n’arrive pas à récupérer les variables.

    quelqu’un pourrait t’il m’aider ?

    • RastaPopoulos

      Ça n’existe pas ça. Enfin si tu parles de pré-remplir les champs, ça peut se faire avec l’appel en squelette (pas le modèle d’insertion dans un contenu). En utilisant le paramètre tableau comme décrit dans la documentation ci-dessus.

    • Franck

      disons que j’ai un formulaire numéro 1 avec un seul champ. Je veux pouvoir dans l’url mettre ?nom=DUPONT et récupérer DUPONT directement dans le champ.

      J’ai essayé pas mal de chose y compris ça :
      #FORMULAIRE_FORMIDABLE1, #ARRAYinput_1, #GETnom

      mais rien n’y fait :(

      une autre solution ?

    • RastaPopoulos

      #GET c’est pour récupérer les valeurs d’un #SET hein. Tu devrais peut-être d’abord te familiariser avec le langage des squelettes de SPIP avant toute chose. :)

      Pour récupérer une variable d’environnement du squelette, c’est #ENV, et pour récupérer ce qui vient de l’URL, il faut soit que ce soit dans le squelette général « racine », soit si c’est un squelette inclus (ou multi-inclus en cascade) que la valeur ait été passée en paramètre des diverses inclusions.

    • Franck

      En fait je dois faire un formulaire simple avec 4 champs et le remplir par l’url afin d’aboutir à une page de paiement. Ca sera la seule page du site.
      Je ne maitrise pas le langage web (php ou autre)

      Peut être pourrais tu m’aider à mettre cela en place ?
      franck at es2icaraibes.com

    • Franck

      J’ai oublié de préciser que tout travail mérite salaire :) je ne demande pas d’aide gratuite.

      Si quelqu’un d’autre peut m’assister la dessus je veux bien

    • Franck

      J’ai enfin pu faire passer mes variables url dans mon formulaire en utilisant la méthode suivante si cela peut aider quelqu’un.

      <?php 
$societe = $_GET['societe'];
$mail = $_GET['mail'];
$doc = $_GET['doc'];
$solde = $_GET['solde'];
$image = $_GET['image']; 
?>

      #FORMULAIRE_FORMIDABLE1, #ARRAYinput_1, #ENVsociete,input_4, #ENVmail,input_2, #ENVdoc,input_3, #ENVsolde

    • RastaPopoulos

      Ben oui, avec #ENV, c’est ce que j’ai dit tout à l’heure.

      Mais le code PHP qui précède ne sert absolument à rien par contre. Et il est même très très très fortement conseillé de ne jamais mettre du PHP dans les squelettes de SPIP.

    • Franck

      Effectivement, aussi simple que cela

      pourriez vous me contacter par email franck at es2icaraibes.com ?

    Répondre à ce message

  • sebas

    test de reponse formulaire

    Répondre à ce message

  • 4
    pgiron

    Bonjour,
    Un petit bug dans Formidable (v 2.9.1), sauf erreur de ma part ?
    J’ai voulu dans un formulaire introduire deux champs « Explication » : il m’est impossible depuis de les retirer les boutons d’édition n’apparaissent pas quand on passe la souris.
    Voir document joint.
    Merci d’avance !

    Répondre à ce message

  • 2
    Kingrise

    J’ai cette erreur qui apparait lors de la validation du formulaire...
    Fatal error : Call to undefined function facteur_mail_html2text() in /var/www/vhosts/.../.../plugins/auto/formidable/traiter/email.php on line 114

    • RastaPopoulos

      Tu dois pas être à jour dans le plugin Facteur, si la fonction n’est pas trouvée du tout.

    • Kingrise

      Ok, c’était le plugin facteur qui n’était pas à jour... et la lame « mise à jour automatique » du plugin « couteau suisse » ne me l’avait pas signalé ;-)

      Bonne continuation et merci de nous écrire de si bons plugins !!

    Répondre à ce message

  • 1
    ierpe

    Bonjour,

    y’aurait-il par hasard un repo avec des formulaires « type » (contact, newsletter, don, etc) au format yaml à télécharger, genre templates ?

    • RastaPopoulos

      Non ça n’existe pas, mais c’est une bonne idée, ça pourrait être tout simplement sur un article en plus dans cette rubrique de doc du plugin.

    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