Formidable, le générateur de formulaires

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

Cette documentation est valable à partir de la version 5.2.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
id_formulaires_reponses Identifiant de la réponse à modifier Entier
forcer_modif Permet de forcer la modification d’une réponse, même si non autorisé 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

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

789 discussions

  • 4

    Bonjour

    j’ai formulaire qui ne fonctionne plus avec SPIP 4.0.1 & 4.0.2, Formidable 5.1.0
    Pré-remplir dynamiquement les champs d’un formulaire :

    #SET{date_saisie, #EVAL{date('Y-m-d H:i:s')}}
    #FORMULAIRE_FORMIDABLE{form01, #ARRAY{date_1, #GET{date_saisie}}} 

    Champ vide une idée de ou vient le problème ?
    Merci pour votre aide si vous y trouvez quelque chose...

    Reply to this message

  • 2

    Bonjour !

    Chez moi (spip 4.1) dans le sélecteur de date il ya le lien “aujourd’hui” (en bas), mais il fonctionne pas, au clic rien se passe , est-ce normal ?
    Merci

    Au revoir ! ;-)

    Reply to this message

  • 3
    Etienne J

    Horreur, j’ai fait la migration spip 4.1 sans regarder que Formidable soit migré compatible dans cette version. Est-ce prévu ? Si oui rapidement ?

    • Etienne J

      Par avance, merci !

    • Haha à toi de tester et dire. :p

      À peu près aucun plugin n’est marqué compatible pour l’instant hein, c’est marqué dans l’annonce :)
      Et c’est même marqué :

      Pour les tester afin de vérifier leur compatibilité, vous pouvez utiliser la configuration (constante) suivante dans votre fichier config/mes_options.php

      define('_DEV_VERSION_SPIP_COMPAT', '4.0.99');

      Ya peu de changement en 4.1 donc la version pour 4.0 doit marcher pareille à priori.

    • Etienne J

      Oui, entre temps je suis retourné sur la page de migration et ai vu la commande : cela foncitonne bien. Ouf et merci !

    Reply to this message

  • Bonjour,
    Merci encore pour la réactivité et les corrections.
    Cordialement

    Reply to this message

  • 1

    Merci beaucoup pour la réponse et la suggestion.
    Cordialement

    • Pour info, les 2 bugs que tu avais signalé (sur le multiétape + sur le IN) ont été corrigée dans la dernière version du plugin saisies, qui sera prochainement disponible pour mise à jour dans SPIP.

    Reply to this message

  • 2

    Bonjour,
    J’ai créé pour un champ un affichage conditionnel si la valeur du champ précédent est une des trois premières d’une liste.
    La condition est donc : @radio_5@ IN “choix1,choix2,choix3”
    Dans ce cas, le 2ème champ s’affiche bien et il est possible de le renseigner mais il disparait lors de la validation du formulaire.
    Est-ce que la condition est bonne ?
    Par ailleurs, est-il possible de récupérer, dans “valeur par défaut”, la valeur d’une réponse déjà enregistrée dans un autre formulaire ?
    Merci pour votre aide.

    SPIP 3.2.12 + Sarka-SPIP 4.5.11
    Formidable 4.15.4
    Saisies pour formulaires 3.54.10
    PHP 7.4.8

    • 1. Il me faudrait un export .yaml de ton formulaire (monprenom@monprenom.net)
      2. Non, on ne pas récuperer directement les valeurs d’une réponse d’un formulaire dans un autre formulaire. Après c’est possible avec un “pre remplissage dynamique” des champs de formulaire, mais il faut écrire son propre squelette.

    • HUM. Alors c’est une affaire complexe.

      Comme le précise la documentation IN est prévue, au départ, pour le cas où la saisie testée renvoie un tableau. Pas du coup pour teste qu’une valeur monoévoluée appartient à un ensemble.

      Mais
      1. On voudrait éventuellement le faire évoluer dans ce sens
      2. Et surtout, il y a un bug : côté Javascript, on permettait deja cela, mais pas côté PHP. Ce qui explique la dissonnance que tu a constaté.

      Et donc

      a. J’ai fait une proposition d’évolution pour résoudre ce bug MAIS je ne sais pas encore si on l’acceptera ou pas, car c’est un sujet complexe (le sens de IN est vraiment confusionnant). A priori, on pourrait aller dans le sens que tu a utilisé
      b. Mais en attendant, je te suggère de remplacer ton @radio_5@ IN 'choix1,choix2' par @radio_5@ == 'choix1' || @radio_5@ == 'choix2.

    Reply to this message

  • 4

    Bonjour,
    J’ai construit avec Formidable un formulaire d’adhésion pour une association. Cependant, je rencontre deux difficultés :
    -  j’ai créé 6 groupes de champs et activé la gestion multi-étapes dans la configuration des options globales ; mais, à l’affichage des étapes, la numérotation commence à 2, puis 4... pour 13 étapes au total ;
    -  je souhaite qu’un champ ne s’affiche que si la case du précédent est cochée ; j’ai donc saisi, dans l’affichage conditionnel, @checkbox_2@==“oui” mais, lorsque je valide la case, le champ suivant reste caché.
    D’autre part, les réponses au formulaire sont envoyée par courriel au trésorier de l’association. Comme il y a beaucoup de champs, ce courriel a plusieurs pages. Je souhaiterais donc que les réponses soient sur la même ligne que les questions. Sur quel fichier agir ?
    Merci pour votre aide
    Cordialement

    SPIP 3.2.12 + Sarka-SPIP 4.5.11
    Formidable 4.15.4
    Saisies pour formulaires 3.54.10
    PHP 7.4.8

    • 1. Pour le premier problème, il faudrait m’envoyer à monprenom@monprenom.net un export .yaml du formulaire
      2. Pour une case cochée, la valeur prise est ’on’, pas ’oui’. Mais vous pouvez simplement mettre @checkbox, ca marchera tout aussi bien
      3. Dans le fichier mes_options.php, mettre define('_SAISIES_AFFICHAGE_COMPACT', true);

    • Merci pour votre réponse rapide.
      Je vous envoie le fichier .yaml
      Cordialement

    • Pour le premier problème, c’est un bug qui a été signalé hier soir et corrigé ce matin :p. C’est parce que votre dernière explication se trouve hors groupe de champs.

      Deux solutions :
      -  vous la mettez dans un groupe de champs
      -  vous utiliser la version v3 de dev (je ne vais pas releaser tout de suite, j’ai d’autres projets), qui est disponible ici https://git.spip.net/spip-contrib-extensions/saisies/archive/v3.zip, mais attention dans ce cas le champ se retrouvera dans toutes les étapes.

    • Merci pour la réponse rapide et pour le conseil concernant la mention “obligatoire”.
      Cordialement

    Reply to this message

  • 1

    Bonjour

    Avec un spip 3.2.12 et formidable 4.15.4, après soumission d’un formulaire, le message de retour ne s’affiche pas du tout. Les valeurs saisies s’affichent bien, elles sont bien enregistrées en base, mais pas du tout mon message de retour.

    Auriez-vous une idée d’où pourrait venir le problème ?

    Le site est multilingue, mais j’ai le même résultat avec un message de retour avec ou sans la balise multi.

    Voilà le code yaml du formulaire :

    id_formulaire: '7'
    identifiant: testfh
    titre: test
    descriptif: ''
    css: ''
    message_retour: Merci
    saisies:
      -
        options: { label: Texte, type: text, size: '40', autocomplete: defaut, nom: input_1 }
        identifiant: '@61e834aa3bddd'
        verifier: {  }
        saisie: input
    traitements:
      enregistrement:
        moderation: posteriori
        moderer_admins: ''
        multiple: on
        modifiable: ''
        effacement: ''
        effacement_delai: ''
        identification: ''
        variable_php: ''
        unicite: ''
        message_erreur_unicite: ''
        anonymiser: ''
        ip: ''
        invalider: ''
        resume_reponse: ''
        analyse_exclure_champs: ''
        identification_reponses: ''
    public: non
    apres: valeurs
    url_redirect: ''
    statut: publie
    date_creation: '2022-01-19 16:56:44'
    maj: '2022-01-19 16:59:58'
    
    

    ET le code HTML produit pour afficher la réponse

    <div class="formulaire_spip formulaire_formidable formulaire_formidable-2">
         <div class="champ afficher afficher_input_1 saisie_input">
            <strong class="label">Texte</strong>
            <div class="valeur ">
    	    <p>fddf</p>
    	</div>
        </div>
        <br>
    </div>

    Reply to this message

  • 3

    Hello,
    J’ai hérité d’un poste informatique dans un collège qui utilise un spip plutôt daté.
    Je n’ai pas le droit d’y toucher de peur que cela perde leur base de donnée ou certaines informations auxquelles ils tiennent (sic)

    J’ai du mettre en ligne un article pour des préinscriptions qui utilise un formulaire qu’ils copient et réutilisent d’une année sur l’autre.
    En prévisualisation de l’article via le mode administrateur, le formulaire est là, il marche (j’ai fait un test d’inscription concluant) ; pourtant sur le site public, l’article, les images et pdf s’affichent, mais le formulaire lui, ne marche pas.
    A sa place j’ai le message d’erreur suivant :

    <?php include_once("./" _DIR_RACINE "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_FORMIDABLE'), 'section_sport_2022_1642512187'), array('''''''''fr''1')); if ($lang_selectlang_select(); ?>

    J’ai réactivé et enlevé des options, créé un nouveau formulaire test pour vérifier la compatibilité, rien n’y fait. Le nom du formulaire test remplace celui de la “section_sport_2022etc...”

    Est-ce qu’il y aurait quelque chose que je n’arrive pas à capter dans l’inclusion du formulaire? (les anciens formulaires n’apparaissent plus non plus, mais sans message d’erreur d’inclusion. Mais je ne saurais pas dire, l’ancien informaticien est parti sans laisser d’infos derrière lui...)

    Merci pour votre aide si vous y trouvez quelque chose!

    D.
    (Le site, pour visu, est celui du “Collège Centre” de Gap)
    https://www.clg-centre-gap.ac-aix-marseille.fr/spip2/
    SPIP 3.2.9
    Formidable 4.8.0

    • Comment insère tu le formulaire dans l’article ? Juste pour être sur.

      Mais cela m’a l’air typique d’un squelette qui utilise des #INCLURE à la place de <INCLURE>.

    • Non, pourtant c’est avec les symboles adaptés, les mêmes que pour l’inclusion des images et pdf qui fonctionnent.

      <formulaire|formidable|id=section_sport_2022_1642512187>

      (j’ai mis un formulaire google en attendant, depuis mon dernier post, ce qui a fait disparaitre le message d’erreur sur le site, mais la situation n’est pas rétablie pour l’inclusion du formulaire formidable, hélas)

      Merci pour votre temps!

    • Hum, ok donc l’appel est correct. Mais il faudrait vraiment regarder la construction des squelettes pour savoir s’il y a des #INCLURE ou des #INCLURE

    Reply to this message

  • 4

    Bonjour,
    Dans les deux sites sous Spip 3.2.11 que j’ai ici, les exports en CSV ou XLS produisent des fichiers vides (0k), j’imagine que c’est lié au serveur car cela fonctionne sur d’autres sans pb. J’ai testé sous PHP 7.3 ou 7.4 avec le même résultat. Quelles sont les extensions PHP dont il faudrait vérifier l’activation pour cette fonctionnalité d’export ? Ou y a-t-il un dossier temporaire dans lequel sont générés ces fichiers avant l’export ?
    Merci d’avance, Luc

    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 / PostgreSQL
  • 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 apparait.

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