Formidable, le générateur de formulaires

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

811 discussions

  • 3

    Pffff !... 800 réponses en une nuit reçues via le formulaire, 20 réponses par minutes par un petit malin chinois.... n’y a-t-il pas moyen de contrecarrer ce genre d’attaque ??

    • En théorie c’est du ressort de nospam de vérifier cela, mais parfois ca passe entre les mails du filet. Depuis une dizaine d’année que j’utilise formidable, je n’ai jamais été spammé via formidable. Cela étant d’autre le sont. J’ai l’impression que plus le formulaire est « complexe » moins on est spammé. Mais bon complexifie le formulaire comme moyen de lutte antispam, c’est pas top.

      Une solution qui marchait dans beaucoup de cas c’est d’interdire les http dans les réponses de formulaires. Pour ce faire il faut configurer la vérification du champ de texte en demandant de ne PAS valider l’expression régulière #http#

    • Bonjour Maïeul,
      Merci pour tout le boulot accompli sur ce plugin !!
      Juste une petite suggestion en passant... En retournant dans le plugin Le Couteau Suisse (je n’y étais plus retourné à cause des problèmes de maintenance dans les versions de spip3 mais cela semble être du passé), j’ai retrouvé une lame AntiSPAM... Elle semble fonctionnelle pour les forums...

      Pourquoi ne pas ajouter cette fonctionnalité (ajouter des filtres ou des ip en blacklist) aux formulaires ?.... Ou peut-être du côté de nospam ???... Si cela est toute fois du domaine du possible :-)

      Bonne journée et bonne continuation !

    • parce que la politique antispam general relève de nospam...

    Répondre à ce message

  • 2

    Bonjour à tous, je ternime un site et au moment de passer par l’étape de mise en place des formulaires… les options Boutons radios, cases à cocher, listes déroulantes ont simplement disparut !
    Suis sous OSX, MAMP 6.8 et spip 4.1.9.

    J’ai bien sur essayé d’activer et désactiver des plugins du site, des fois que… sans succès.

    J’ai refais une instale propre d’un nouveau site avec seulement la galaxie des plugins formidables… idem.
    Une idée ?
    Bien à tous !

    • C’est un bug apparu avec la dernière version de YAML.

      J’espérais sortir une version corrigée de saisies ce week-end, mais je vais sans doute l’anticiper.

    • haaaaaaa… merci, je m’arrachai les cheveux, 15 jours de taff pour bloquer aux formulaires (5 encore à réaliser). Je vais voir si je peux compenser en attendant. MERCI INFINIMENT (et une nouvelle fois) pour ta réactivité !!

    Répondre à ce message

  • 1

    dans un formulaire, j’ai besoin d’une validation qui permette de selectionner maximum 2 réponses sur 5 proposées dans une liste de choix. Est-il possible de mettre cela en place avec spip ? Et comment ?

    • Bah c’est déjà le cas, ya bien une option « choix maximum » dans l’onglet « utilisation » des checkbox

    Répondre à ce message

  • Bonjour

    Dans le résumé, les champs date ne sont pas repris correctement apparait « Sans réponse » alors que la date est bien choisi et apparait bien dans les données après validation.

    Merci de me dire comment faire ?

    Répondre à ce message

  • 3

    Bonjour, merci pour ce formidable plugin, j’ai besoin d’aide pour l’affichage conditionnel d’une liste qui doit s’afficher seulement si la réponse à ma sélection 1 est le choix 175 @sélection_1@==« choix175 » mais cela ne marche pas. Besoin d’aide svp

    • Bonjour,

      Dans un de mes formulaire j’ai ceci qui fonctionne :
      @radio_1@=="choix2"

      dans la partie « Affichage conditionnel » du champ qui ne doit donc s’afficher que si la réponse préalable du champ @radio_1@ est le choix n°2

      dd

    • Merci, votre réponse m’a éclaire mais je constante que quand je met une condition dans mon formulaire, ça marche bien dans l’espace prive du site par contre elle n’a aucun effet dans le site public.

    • Il y a sans doute alors un bug d’installation / de configuration de vos squelettes chez vous.
      Peut-on avoir une URL pour voir ce qu’il en est ?

    Répondre à ce message

  • 2

    Bonjour
    pour info

    sur un serveur nginx j’ai été obligé d’ajouter #URL_SITE_SPIP/ au form pour que ça fonctionne
    sinon : Échec de la connexion sécurisée

    <form method='post' action='#URL_SITE_SPIP/[(#ENV{action}|ancre_url{[formulaire_#ENV{form}-(#ENV{id,nouveau})]})]' enctype='multipart/form-data'><div>

    bonne journée
    Natacha

    • Hum,

      c’est assez étonnant cette affaire. Je ne vois pas pourquoi cela se produirait spécifiquement pour les formulaires formidable et pas pour d’autre. Je me demande si tu vous n’avez pas un problème de config ailleurs sur nginx.

    • c’est aussi mon avis
      il doit y avoir un problème de config nginx
      mais je n’ai pas la main dessus
      Merci pour la réponse

    Répondre à ce message

  • 3

    Bonjour,
    J’utilise formidable pour gérer des petites annonces. Quand un auteur a créé une annonce via le formulaire, dans l’affichage de la liste des annonces, il a la possibilité de modifier son annonce (sa réponse du point de vue de formidable) ou de la supprimer. Mais j’ai un problème avec la suppression car cela ne fonctionne que si l’auteur est administrateur ! D’ailleurs je n’ai pas testé s’il est possible de faire une modification pour un non-administrateur ...
    Voici les commandes utilisées,

    #BOUTON_ACTION{'Modifier', #URL_PAGE{publie_pa}|parametre_url{id_formulaire_reponse,#ID_FORMULAIRES_REPONSE}, 'submit','','Modifier cette annonce'}
    #BOUTON_ACTION{'Supprimer', #URL_ACTION_AUTEUR{supprimer_formulaires_reponse,#ID_FORMULAIRES_REPONSE,#SELF}, 'submit','Désirez-vous vraiment supprimer cette annonce ?','Supprimer cette annonce'}

    Je ne sais pas comment faire pour que cela fonctionne aussi avec un ’simple’ auteur, merci d’avance pour votre aide.
    Thierry

    • Effectivement, par défaut seuls les admins ou les auteurs de formulaire (je dis bien de formulaire, pas de réponse) peuvent modifier une réponse.

      Cf. https://git.spip.net/spip-contrib-extensions/formidable/src/branch/master/formidable_autorisations.php#L222

      il faut donc que tu créé ton propre jeu d’autorisation. cf https://programmer.spip.net/Creer-ou-surcharger-des

    • Merci Maïeul, encore une petite question pour la surcharge d’autorisation :
      J’ai rajouté ça dans mon fichier mes_options :

      $GLOBALS['spip_pipeline']['autoriser'] .= "|autorisations_pa";
      
      function autorisations_pa() {
      	include_spip('inc/autorisation_formulaire_reponse_pa');
      }

      et dans squelette/inc/autorisation_formulaire_reponse_pa.php j’ai ça :

      <?php
      /**
       * Surcharge des autorisations pour les réponses de formulaire si petites annonces
      **/
      
      // Sécurité
      if (!defined('_ECRIRE_INC_VERSION')) return;
      
      function autoriser_formulairesreponse_supprimer($faire, $type, $id, $qui, $opt) {
              // appel de autoriser_formulairesreponse_instituer_dist via api
      	$return = autoriser('instituer', $type, $id, $qui, $opt);
      	if(!$return) { // si pas d'autorisation verifie sur quel formulaire on est
      		$id_formulaire = sql_getfetsel('id_formulaire', 'spip_formulaires_reponses', 'id_formulaires_reponse = '.intval($id));
      		$nom_formulaire = sql_getfetsel('identifiant', 'spip_formulaires', 'id_formulaire = '.intval($id_formulaire));
      		return ($nom_formulaire == 'form_pa'); // on accorde l'autorisation si réponse du formulaire de petites annonces
      	}
      	return $return;
      }

      mais quand je regarde en debug, ma fonction autoriser_formulairesreponse_supprimer n’est pas trouvée et c’est toujours la fonction autoriser_formulairesreponse_supprimer_dist qui est appelée.
      Je ne comprend pas ce qui cloche ... ??
      merci d’avance
      Thierry

    • Je sais pas, je suis pas trop doué sur ces questions. Je t’inviterai à en discuter sur discuter.spip.net

    Répondre à ce message

  • 5

    Bonjour,
    J’ai installé les dernières versions de tous les plugins nécessaires (formidable, saisies, facteur, etc...) sur un site en spip 4.1.5.
    J’ai créé un formulaire de réservation de gîte où celui qui réserve reçoit un accusé de réception avec les données fournies. Le responsable du gîte reçoit la demande.
    Mon souci : celui qui réserve reçoit 2 fois le message d’accusé réception et le responsable reçoit 2 fois la demande.
    Quelle peut être la raison ?
    Merci de votre aide
    Martine

    • Bonjour,
      Je précise mon observation d’hier : les réponses sont envoyées 2 fois si je souhaite que les valeurs de réponse soient dans l’accusé de réception, Si je coche : « Ne pas envoyer les valeurs de réponse ... », le message n’est envoyé qu’une fois à chaque destinataire.

      Mais le formulaire est top ! Merci.
      Martine

    • C’est systématique ? Ou ponctuel ? Il arrive fréquement que des gens double clique par erreur...

      Est-ce que par ailleurs tu enregistre en base les réponses, y sont-elles en double ?

    • Bonjour,
      C’est systématique. C’est moi qui fait les tests et j’ai testé sur 2 sites différents avec 2 formulaires différents.
      Je n’enregistre pas les données dans la base.
      Merci pour votre aide.
      Martine

    • la franchement je ne vois pas, peut être tout simplement un bug de votre hebergeur. Qu’est-ce qui se passe en cas de rappel de mot de passe, est-ce que c’est envoyé 2 fois ? si oui le pb provient de votre hebergeur, sinon il faudra voir.

      Tentait aussi l’enregistrement en bas, au moins temporairement, pour voir ce que ca donne.

    • Merci Maïeul, en effet, j’utilise certains formulaires seulement comme chatbox... mais même avec le filtre http ou www.... Ils arrivent encore à injecter leur m*... J’ai bloqué en amont dans .htaccess certaines des adresses IP lorsque le nombre de spams est conséquent... Mais parfois, c’est juste un mail spam mais qui donne des boutons... Je pense que je vais activer l’obligation de s’inscrire sur le site pour poster dans les formulaires car la politique de Spip est d’éviter le Captcha de Google.

    Répondre à ce message

  • 1

    Bonjour,

    existe t’il un moyen de générer un PDF avec les réponses d’un formulaire et de l’envoyer par mail au destinataire ?

    Merci

    • Pas directement non, faudrait coder une extension pour cela. Par contre on peut envoyer un accusé de réception en mail.

    Répondre à ce message

  • 5

    Salut,
    tout d’abord, merci pour ce plugin !
    J’ai fait un mini-formulaire qui envoie un mail.
    À la validation W3C, j’ai un :
    « The value of the for attribute of the label element must be the ID of a non-hidden form control. »
    Il me semble qu’au

    <label for="champ_destinataires_1">Destinataires</label>
    <input type="hidden" name="destinataires_1[]" value="1" />

    Il faudrait ajouter un id au input (si j’ai bien compris) du type pour que cela passe :
    <input id="champ_destinataires_1" type="hidden" name="destinataires_1[]" value="1" />
    Merci encore !

    • Hum, mais pourquoi diable ton champ est en hidden ?
      Peux tu fournir un export yaml du formulaire ?

    • Merci pour la promptitude ;)
      Voilà le yaml.
      Je pense que le champ est en hidden car il n’y a qu’un destinataire que l’on ne sélectionne pas.
      ou peut-être est-ce le « Type de choix » :
      « Mettre toutes ces personnes en destinataires. L’internaute n’aura aucun choix. »
      Tu veux le lien ?

      id_formulaire: '1'
      identifiant: newsletter
      titre: '<:newsletter:>'
      descriptif: ''
      css: ''
      message_retour: '<:newsletter_sucess:>'
      saisies:
        -
          options: { label: '<:newsletter_mail:>', type: text, size: '40', autocomplete: defaut, obligatoire: on, nom: email_1 }
          verifier: { type: email, options: { mode: normal } }
          identifiant: '@62029e25a26b1'
          saisie: email
        -
          options: { label: '<:newsletter_language_title:>', explication: '', datas: "choice1|English\r\nchoice2|Français", vue_masquer_sous_groupe: '', defaut: '', cacher_option_intro: '', option_intro: '<:newsletter_language:>', multiple: '', disable: '', disable_avec_post: '', disable_choix: '', afficher_si: '', afficher_si_remplissage_uniquement: '', afficher_si_avec_post: '', attention: '', class: '', conteneur_class: '', size: '', obligatoire: on, info_obligatoire: '', erreur_obligatoire: '', nom: selection_1 }
          verifier: {  }
          identifiant: '@62029ed89d1b7'
          saisie: selection
        -
          options: { label: Destinataires, explication: '', choix_destinataires: ['1'], type_choix: tous, option_intro: '', afficher_si: '', afficher_si_remplissage_uniquement: '', afficher_si_avec_post: '', attention: '', obligatoire: '', info_obligatoire: '', erreur_obligatoire: '', nom: destinataires_1 }
          verifier: {  }
          identifiant: '@6202a00fb5042'
          saisie: destinataires
      traitements:
        enregistrement:
          moderation: posteriori
          moderer_admins: ''
          multiple: on
          modifiable: ''
          effacement: on
          effacement_delai: '10'
          identification: ''
          variable_php: ''
          unicite: ''
          message_erreur_unicite: ''
          anonymiser: ''
          ip: ''
          invalider: ''
          resume_reponse: ''
          analyse_exclure_champs: ''
          identification_reponses: ''
        email:
          modification_reponse: on
          champ_sujet: 'Inscription Newsletter'
          champ_sujet_modif_reponse: ''
          champ_sujet_valeurs_brutes: ''
          exclure_champs_email: ''
          pj: ''
          masquer_liens: ''
          activer_ip: ''
          masquer_champs_vides: ''
          champ_destinataires: [destinataires_1]
          destinataires_plus: ''
          destinataires_selon_champ: ''
          activer_vrai_envoyeur: on
          champ_nom: ''
          activer_accuse: ''
          sujet_accuse: ''
          texte_accuse: ''
          masquer_valeurs_accuse: ''
          courriel_envoyeur_accuse: ''
          nom_envoyeur_accuse: ''
          champ_courriel_destinataire_form: ''
      public: non
      apres: formulaire
      url_redirect: ''
      statut: publie
      date_creation: '2022-02-08 17:11:36'
      maj: '2022-11-23 10:32:59'
    • Oki, je comprend mieux. Je n’utilise jamais la saisie destinataires, toujour l’option destinataires supplementaires dans la config du traitement.

      Et non il ne faut pas ajouter de id au hidden, puisque le message précisement est

      « The value of the for attribute of the label element must be the ID of a non-hidden form control. »

      Donc il faut pas de label si l’élèment est caché (ce qui est logique en fait : un label c’est fait pour les humaines.

      Bref, j’ai ouvert une PR sur saisies https://git.spip.net/spip-contrib-extensions/saisies/pulls/238

      A priori tu peux appliquer par anticipation le patch (je sais pas quand cela sera releasé).

    • Merci encore !
      Oui, maintenant que tu le dis, ça semble logique :)

    • DOnc c’est dans master. Reste plus qu’à attendre la release (je ne sais pas quand cela sera, mais a priori pas très vite, on a releasé il y a peu...)

    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