Formidable, le générateur de formulaires

Published : 23 January 2012 – updated on 19 March 2024 – by 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 years 1 year 3 months Without limit
par date
Filter

812 discussions

  • 2
    SB

    Bonjour,

    Je suis sur SPIP 2.1.13 [19292].
    Je suis actuellement en train de tester le plugin Formidable (v. 0.6.6.) que je trouve très bien.

    Pour respecter les critères d’accessibilité Accessiweb, j’aimerais personnaliser le squelette formidable.html (présent dans le dossier /formulaires du plugin) afin de rajouter un attribut title au niveau du bouton de soumission du formulaire pour que l’intitulé de ce bouton soit pertinent.

    Je souhaiterais que cet attribut puisse être rajouté par un contributeur en appelant le formulaire formidable avec un nouveau paramètre |btok=complement (ex: <formulaire|formidable|id=5|btok=envoyer mes réponses>).

    Pour cela, j’ai créé une copie du squelette formidable.html que j’ai placé dans le dossier /squelettes/formulaires/ et j’ai modifié le morceau de code HTML suivant :

    <input type='submit' class='submit' value='<:bouton_valider:>'[ title='<:bouton_valider:>, (#ENV{btok}|attribut_html)'] />

    Lorsque je teste ce changement dans un article, le rajout de l’attribut title n’est pas pris en compte car #ENV{btok} reste vide.

    Que dois-je faire ? Pourquoi l’ajout du nouveau paramètre |btok dans la balise <formulaire|formidable...> n’est pas pris en compte ?

    • RastaPopoulos

      Parce que n’est pas un modèle appelant un squelette, c’est un modèle dynamique appelant un formulaire CVT, comme #FORMULAIRE_TRUC dans un squelette. Les paramètres donné au modèle ne sont PAS des paramètres nommées, mais juste les paramètres du formulaire (les params des fonctions CVT) dans leur ordre dans la fonction.

    • SB

      Bonjour,

      Merci pour votre réponse. Vos indications m’ont été précieuses et grâce à ça, j’ai réussi à solutionner ce problème de la façon suivante :

      j’ai surchargé le fichier formidable.php (j’ai seulement modifié la fonction formulaires_formidable_charger) et j’ai déposé ce fichier surchargé au même endroit que le squelette formidable.html (dans le dossier /squelettes/formulaires/) et ça a marché.

      Merci encore.

    Reply to this message

  • 1
    jechtou

    Bonjour,

    J’utilise une liste déroulante dans un formulaire de contact, mais j’ai un souci avec l’option “valeur par défaut” qui ne semble pas etre prise en compte

    J’ai renseigné la zone liste des choix possibles comme suit :

    transports|transports
    autres|autres services

    J’ajoute autres dans Valeur par défaut

    Le choix est bien présélectionné dans l’aperçu côté privé, mais pas dans le formulaire sur la page contact (appelé via un squelette par #FORMULAIRE_FORMIDABLE{contact} )

    Formidable 1.3.6 - dev avec SPIP 3.0.10

    Suis-je le seul é_è ?

    Reply to this message

  • 1
    Jeanne

    Bonjour,

    J’utile dans un formulaire un sélecteur de rubrique, dans la base de donnée ma sélection est bien prise en compte “rubrique | 9”.
    Je souhaiterais enlever “rubrique |” afin d’avoir uniquement identifiant de la rubrique.

    Merci d’avance

    • jechtou

      Bonjour,

      Tu peux faire ça simplement en utilisant le filtre ’explode’ sur ta balise :
      [( #MONSELECTEUR|explode| )] (il faut du coup préciser le délimiteur ’|’ entre crochets)

      Cela te transforme le « rubrique | 9 » en un tableau comme ceci :
      0 => rubrique
      1 => 9

      Il te suffit alors d’utiliser un filtre de + : “table_valeur” pour isoler ce que tu veux. Ainsi :
      [( #MONSELECTEUR|explode||table_valeur1 )] vaudra ’9’

      et [( #MONSELECTEUR|explode||table_valeur0 )] vaudra ’rubrique’

    Reply to this message

  • 3
    k3utchi

    salut

    merci pour ce plugin bien pratique

    je cherche à préselectionner un destinataire pour un formulaire de contact avec 1 destinataire à choisir dans une liste déroulante.

    j’essaie avec un array dans l’appel du formulaire mais j’obtiens un message d’erreur à chaque fois

    Warning: in_array() [function.in-array]: Wrong datatype for second argument 
in /homepages/37/d332278099/htdocs/ecrire/public/composer.php(76) :
 eval()'d code on line 88

    mon appel ressemble à ça, ça fonctionne pour le sujet

    #FORMULAIRE_FORMIDABLE{mon formulaire,#ARRAY{destinataires_1, xxx, input_4, mon sujet}}

    c’est bien l’id de l’auteur qu’il faut faire passer comme valeur au champ destinataires_1 ??

    • RastaPopoulos

      Oui les champs destinataires produisent des id_auteur. Mais je crois que c’est toujours un tableau : il faut donc mettre comme valeur #LISTE{123} (en SPIP 3) ou #ARRAY{0,123} (en 2.X).

    • k3utchi

      super, ça marche. thanks mate !

    • k3utchi

      ’tin quand j’y pense j’aurais presque pu y penser tout seul, vu que le champ destinataires est nommé au pluriel, logique que ce soit un tableau :) quand je serai grand moi aussi je serai un programmeur élégant ^^

    Reply to this message

  • mlle violette

    Bonjour,
    Merci pour ce super plugin ! j’ai juste un petit souci pour le mail d’envoi.
    J’ai bien trouvé le fichier à modifier => copié dans mes squelettes mais comment faire en sorte que les labels et les résultats soient alignés en face l’un de l’autre , et que l’on n’affiche pas les textes d’explications, les legend des fieldset etc...

    je n’ai trouvé que #VOIR_SAISIES#ENV*saisies, #ENV*valeurs comme éléments modifiable et ça ne me parle pas vraiment, je ne vois pas du tout comment faire une mise en forme html avec ces éléments :) (l’entête et le pied de mail conviennent parfaitement )

    je voudrais juste un truc tout bête genre

    label : réponse

    label : réponse

    Les données récupérées par mail doivent être copiées/collées dans une fiche ensuite, et c’est pour facilité cette opération que je souhaite changer la mise en forme.
    Merci d’avance si vous avez une réponse.

    Reply to this message

  • 2
    maxCSA

    Bonjour,

    Est-ce possible de spécifier l’adresse de l’envoyeur pour l’accusé réception envoyé à la personne qui a rempli le formulaire? Actuellement, le plugin utilise l’adresse courriel du webmaster du site pour tous les formulaires.

    C’est un peu contraignant pour nous étant donné que nous avons plusieurs formulaires pour des besoins très différents. Au bout du compte, c’est moi qui reçoit des messages indésirables :(

    Merci, et beau travail!

    • RastaPopoulos

      Non je crois qu’il n’y a pas d’option pour ça actuellement. C’est “le site” qui envoie ces mails. À rajouter dans la todo list...

    • maxCSA

      Merci RastaPopoulos pour ta réponse. Je vais donc attendre l’arrivée de cette option :)

    Reply to this message

  • 2
    pgiron

    Hello,
    J’ai peut-être mal vu, mais y a-t-il (en SPIP 3) un bouton qui s’affiche quelque part qui permet de charger un formulaire dans un article autre que devoir recopier <formulaire|formidable|id=blabla> ?
    Merci d’avance.

    PhG

    Reply to this message

  • 3
    Kriss

    Bonjour,
    C’est bête comme chou, mais je ne suis ni développeur, ni plus qu’un humble webmaster amateur... Mais je n’arrive pas à appeler le formulaire depuis le site et la vidéo s’arrête juste avant... Quel lien mettre ? (Ou comment faire ?)
    Merci.
    Christophe

    • Kriss

      Bonjour et merci...
      Si, ça j’avais vu, et j’ai fait plusieurs essais, mais je le mets où et comment ? Si je dois entrer dans le code, cela dépasse mes compétences et une url ou une page (?) directe me donne des 404.
      J’ai aussi essayer de retrouver le formulaire dans le répertoire, sans résultats et pourtant il existe, même si j’obtiens aussi cela : http://www.demilitarisation.org/spip.php?article97
      Merci encore, j’aimerai bien y arriver !
      Amicalement,
      CB

    • Kriss

      Je pense être en train d’y arriver... Je vous redis si besoin !

    Reply to this message

  • 4
    bob

    Bonjour,
    lorsque le formulaire compte beaucoup de lignes, il devient impossible de l’exporter (local ou pas d’ailleurs). Quelqu’un a-t-il un moyen efficace de réaliser cette opération ?

    • RastaPopoulos

      Mmmmh tu parles de l’export des réponses ou des champs ? Tu en as combien du coup ?

    • bob

      Bonjour et merci de m’avoir répondu si vite (et pardon aussi de ne vous répondre que maintenant).
      Je parle de l’export des réponses, ma bdd est grosse, je parle de plusieurs dizaine de milliers de ligne.

    • RastaPopoulos

      Mmmh oui j’ai jamais testé avec une telle quantité d’informations. Forcément ça doit faire plusieurs dizaines de mégaoctets, et le temps de générer ce fichier, le hit PHP plante (généralement c’est configuré pour faire timeout après 30 secondes, par défaut). Je ne suis pas spécialiste pour gérer ce genre de grosses bases, il faudrait voir sur spip-zone si quelqu’un a des méthodes pour générer le fichiers en plusieurs fois pour pas planter, en AJAX par exemple, je ne sais pas trop...

    • bob

      je vais chercher. Merci en tout cas.
      Ce plugin c’est de la balle :).

    Reply to this message

  • 2
    graphie

    Bonjour,

    Sur un article contenant un formulaire, j’’ai besoin d’imprimer au format PDF le résultat de la saisie de ce formulaire.

    Malheureusement, avec mes différents test d’impression (plugins PDF ou impression via le navigateur) je n’obtient que des formulaires vides, sans les saisies :-(

    Y a-t-il une solution qui m’ait échappée, ou pourrait-on utiliser le résultat stocké dans la BDD pour l’imprimer ?

    Merci pour vos conseils,
    françois

    • RastaPopoulos

      Ben déjà au minimum il faut choisir “afficher les réponses” au retour du formulaire, pour que ça s’affiche en texte et non dans les champs. Il me semble qu’il y a cette option, et que donc ensuite on peut imprimer avec navigateur. Sinon l’autre solution c’est effectivement sur la page de retour d’aller chercher les dernières réponses du visiteur en cours (la liste de ces réponses est donné par une fonction dont on a parlé dans ce fil de discussion.

    • graphie

      Je tourne autour depuis quelques jours, donc la logique poussait effectivement à choisir «Afficher... les valeurs saisies» ;-)

      Ceci fait, l’impression depuis mon navigateur retourne une page blanche : de toute manière pas une solution «universelle».

      Ta piste qui se trouve dans le post fourni me plait bien et je m’y colle tout de suite !

      Le souci du plugin PDF est qu’il recharge l’article (avec le formulaire) et donc génère un PDF basé sur un formulaire « tout frais ».

      Je vous ferai part de mes avancées.

      Merci,
      françois

    Reply to this message

Add a comment

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.

Who are you?
[Log in]

To show your avatar with your message, register it first on gravatar.com (free et painless) and don’t forget to indicate your Email addresse here.

Enter your comment here

This form accepts SPIP shortcuts {{bold}} {italic} -*list [text->url] <quote> <code> and HTML code <q> <del> <ins>. To create paragraphs, just leave empty lines.

Add a document

Follow the comments: RSS 2.0 | Atom