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

  • 1
    jmfre

    Bonjour

    Est il possible d’enregistrer les données de Formidable dans une autre table
    (ex : spip_matable - comme avec Formitable sous Spip 2 ?)
    Je suis sous Spip 3, Formidable 1.9.1
    Bonne journée
    Jean-Michel

    Répondre à ce message

  • 1
    Pablo

    Bonjour…
    Comment je fais (oui je n’arrive pas à trouver la réponse) pour afficher les résultats d’une saisie particulière. Par exemple je me sers du formulaire pour demander à l’utilisateur d’entrer certaines informations et il peut ensuite décider de voir ses saisies (à la demande sur une page quelconque du site).
    En somme, comment je fais pour balancer les données en base ?
    Merci.

    • Pablo

      Pardon… J’ai vu qu’il existant un modèle "formulaires_reponse.html dans le plugin.
      Ça m’ira très bien pour le moment. Merci et désolé pour le dérangement.

    Répondre à ce message

  • 5
    pascal

    Hello Je cherche à résoudre le mystère des réponses modifiables après coup.

    En fait je cherche à faire que les formulaires fonctionnent en deux étapes sur le même principe que les forums : une première étape prévisualisation qui réaffiche les champs pour correction éventuelle puis une étape validation définitive.

    Je coche « Réponses modifiables = oui » dans les traitements du formulaire mais ensuite c’est le mystère. Je ne trouve pas comment réafficher le formulaire pour permettre au visiteur de le modifier sans que cela génère un enregistrement supplémentaire dans la table des réponses.

    Quelqu’un a déjà essayé et pourrait m’aiguiller ? Merci ;-)

    • pascal

      Donc aucune piste sur la manière d’utiliser la fonction « modifiable » pour faire l’update d’une réponse ?
       :-(

    • RastaPopoulos

      Tout dépend si les gens peuvent répondre plusieurs fois à un même formulaire ou toujours qu’une seule fois. IL y a une case de configuration qui permet de dire que les gens ne peuvent répondre qu’une seule fois, et s’il y a à la fois cette option + l’option de réponse modifiable, alors ça peut afficher la dernière (et seule) réponse de la personne en cours, et lui permettre de la modifier.

      Il est aussi possible (à priori en mode insertion en squelettes) de fournir un identifiant de réponse en troisième argument du formulaire lors de l’appel. Dans ce cas ça permet d’éditer telle réponse précise.

    • pascal

      Il me semblait bien qu’il y avait moyen ;-)
      L’ID de la réponse qui vient d’être enregistrée n’est pas retournée dans le tableau message_ok ?

    • RastaPopoulos

      « message_ok » est une chaîne de caractère.

      Mais tu as une fonction, utilisable aussi en squelette, qui te permet de récupérer les tableaux des réponses du visiteur en cours pour un formulaire précis (et s’il n’y a qu’une réponse autorisé, cela renvoie donc une liste d’un seul élément).

      http://zone.spip.org/trac/spip-zone/browser/_plugins_/formidable/trunk/inc/formidable.php#L93

      #SET{reponses, #ID_FORMULAIRE|formidable_verifier_reponse_formulaire}
#GET{reponses) est soit "false", soit un #ARRAY d'une ou plusieurs réponses
[(#GET{reponses}|array_pop)] retournera donc l'id de la dernière réponse
    • pascal

      Cool. Merci je vais tenter de me dépatouiller avec ça ;-)

    Répondre à ce message

  • 3
    Etie

    Bonjour J’ai mis le formulaire en ligne mais comme mon site est noir et l’écriture aussi peut-on mettre l’écriture en blanc ?
    Merci pour votre retour.
    Cordialement

    • RastaPopoulos

      Oui et non. :)

      Non, en rapport avec ce plugin, car celui-ci n’a rien à voir avec l’aspect graphique et ne fait que générer le HTML des formulaires et leur aspect fonctionnel.

      Oui, en modifiant les styles graphiques, c’est-à-dire dans les CSS de ton thème graphique. Du genre :

      label{ color:white; }
    • Etie

      Pourtant j’ai bien ça dans le texte SPIP :

      h2 c l a s s=« blanc »
      formulaire|formidable|id=1
      /h2

      Et ca dans mon CSS :

      h2.blanc
      font-family : « Luxi sans », « Lucida Grande », Lucida, « Lucida Sans Unicode », sans-serif ;
      font-size:11px ;
      font-weight:bold ;
      color :#FFFFFF ;

      Et le résultat reste toujours le meme

    • RastaPopoulos

      Euh, ça n’a aucune sorte de sens de mettre un formulaire à l’intérieur d’un H2 (= titre de niveau 2, un formulaire ne peut pas être DANS un titre).

      Ensuite, le style en question ne s’applique qu’au texte inclus dans la balise H2, pas forcément à des sous-balises à l’intérieur, notamment les labels, qui peuvent avoir eux-mêmes des styles dédiés plus précis.

      Mais pour cela, il faut forcément en amont d’abord apprendre comment fonction le HTML, ainsi que les cascades de styles CSS.
      Par exemple ici : https://developer.mozilla.org/fr/docs/CSS/Premiers_pas

      Il faut aussi regarder quels styles sont réellement appliqués à tel ou tel élément, afin de savoir comment les surcharger. Par exemple avec l’outil d’inspection du code sous Firefox : F12, Inspecteur, premier bouton à gauche « Sélectionner un élément avec la souris ».

    Répondre à ce message

  • Francky

    Salut :-)
    Je crois que j’ai compris pourquoi il n’y a pas le bloc « sur le web » dans l’article pour voir de suite les dernieres modifs
    En faite, je pense que cela vient de archivelist
    http://zone.spip.org/trac/spip-zone/browser/archivelist.txt#L396
    Il y a écris :
    396 _plugins_/formidable/branches/v0 ;formidable ;formidable
    397 _plugins_/formidable/branches/v1 ;formidable_1_0

    Alors que cela devrait plutôt être :
    396 _plugins_/formidable/branches/v0 ;formidable
    397 _plugins_/formidable/branches/v1 ;formidable_1_0

    voir peut-être mieux :
    396 _plugins_/formidable/branches/v0 ;formidable_V_0
    397 _plugins_/formidable/branches/v1 ;formidable_V_1
    Tu en pense quoi ?

    Répondre à ce message

  • 1
    Marines

    Bonjour,
    Merci de ce plugin que fonctionne très bien. J’ai une seule question. Existe-il la possibilité de récupérer les données des formulaires dans de nouveaux articles ?
    Par exemple, dans un formulaire pour proposer des événements ?
    Merci

    Répondre à ce message

  • 1
    seb

    Bonjour,

    je souhaiterais afficher des formulaires, qui une fois remplis génèrerais un pdf a envoyer par email.
    Est ce envisageable avec ce plugin ?
    merci

    • RastaPopoulos

      Tout est envisageable ! :)

      Mais pour l’instant ça ne fait pas ça non. Il faudrait développer un sous-plugin qui ajouterait un nouveau traitement pour ce besoin (possible que j’ai besoin d’un truc similaire cette année, donc possible qu’au cours de l’année je doive le faire).

    Répondre à ce message

  • 3
    chag

    Bonjour,

    Sur la page d’accueil d’un site, j’ai mis un formulaire et je souhaite changer ce formulaire de temps a autres.

    au début, j’ai mis ça :

    [<div id=« sondage »>
    (#FORMULAIRE_FORMIDABLEsondage_accueil)
    </div>]

    en me disant que si je changeais le nom du formulaire, ca n’afficherait rien mais ca affiche :

    Le formulaire n’existe pas.

    Est ce qu’il existe une autre méthode qui m’aurait échappé ?

    • RastaPopoulos

      Pourquoi changer le nom du formulaire ? Soit tu supprimes l’appel, soit tu l’entoures avec [(#REM)  La partie à commenter ].

    • chag

      C’est ce que j’ai fait mais ça oblige a modifier le squelette. En changeant le nom du formulaire, je pensais pouvoir tout gérer depuis l’admin. du coup, pas besoin d’intervenir pour modifier le squelette quand il faut supprimer le formulaire ou le cacher temporairement. L’administrateur du site est autonome :)

    • RastaPopoulos

      Ben sinon il faut que l’appel soit dans un contenu SPIP, avec le modèle (dans le descriptif du site ou autre). Et donc du coup ça peut se changer ou s’enlever depuis l’admin.

    Répondre à ce message

  • 1
    Pascal Engelmajer

    Bonjour,
    je n’arrive pas à afficher le formulaire ([formulaire|formidable|id=1])
    La page affiche un cadre vert avec un fond vert et le bouton [valider]
    la hauteur affichée est juste suffisante pour le bouton.
    Ci dessous le code généré et expurgé des interdit.
    Avez-vous une idée de ce qu’il faut que je fasse ou d’une erreur dans mon paramétrage ?
    Merci de vos réponses
    Cordialement

    Code
    [div Klass=« formulaire_spip formulaire_formidable formulaire_formidable-1 »]
    [form Klass=« verifformok » method=« post » action=« /ecrire/ ?exec=article&id_article=702 » enctype=« multipart/form-data »][div]
    [div][input name=« exec » value=« article » type=« hidden »][input name=« id_article » value=« 702 » type=« hidden »][input name=« formulaire_action » value=« formidable » type=« hidden »][input name=« formulaire_action_args » value=« 89sjJeSzaYZ6F7ZHauUDcDLN8awswVqTKR/SOaUVCaJZNjzCEII8ixaGgihhg781iu0cP5nqKmm8S/pTBG7Sp9mjCHUPk73JrZUb » type=« hidden »][input name=« id_formulaire » value=« 1 » type=« hidden »]
    [input name=« formidable_afficher_apres » value=« redirige » type=« hidden »][/div][ul]
    [li look=« display:none ; »]
    [label for=« mechantrobot-1 »]Veuillez laisser ce champ vide :[/label]
    [input id=« mechantrobot-1 » name=« mechantrobot » value=« » type=« text »]
    [/li]
    [/ul]
    [!—extra—]
    [p Klass=« boutons »]
    [span Klass=« image_loading »][/span]
    [input Klass=« submit » value=« Valider » type=« submit »]
    [/p]
    [/div][/form]
    [br]
    [/div]

    • RastaPopoulos

      Ben c’est juste que tu n’as aucun champ dans ton formulaire. Peut-être n’as tu pas enregistré les champs ?

    Répondre à ce message

  • 3
    DD

    Bonjour,

    Je ne comprends pas..
    J’ai un champ oui / non et j’ai mis la valeur par défaut à oui. Dans l’admin c’est OK mais sur le formulaire public la valeur par défaut est à non (en gras)

    Merci

    dd

    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