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

  • 8

    Bonjour,
    J’essaie désespérément de préremplir un formulaire avec l’adresse mail de l’invité connecté, sans résultat !
    J’ai tenté d’utiliser #SESSIONemail dans valeur par défaut, de passer

    <?php include_once("/opt/nursit/sys/home/nursit/matrice/public/4.2/07/spip/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'), 'invitation', '@email_1@,#SESSION{email}'), array('', '', '', '', 'fr', '1')); if ($lang_select) lang_select(); ?>

    en l’appel du formulaire dans l’article, sans succès !
    Est il possible de préremplir ce champ email pour ne pas demander au visiteur de ressaisir son mail ?
    Par avance merci,
    André

    • Bonjour,
      Ce qui fonctionne pour moi c’est d’afficher le formulaire (par exemple dans le champ texte d’un article) comme ceci :

      <form_prerempli_session|id_formulaire=7|champ=hidden_1>

      pour moi @hidden_1@ est le nom de l’utilisateur mais cela devrait fonctionner avec le mail.

      dd

      PS avec Formidable 5.2.2 et SPIP 4.0.8

    • Merci je vais essayer avec cette syntaxe !
      André

    • Ca ne pourra pas marcher. La demande de Degom95 concerne un remplissage dynamique (dependant de la session) et DD tu propose un remplisage statique (= dépendant de ce qu’on met dans le contenu d’un article).

      @Degom95 : par définition et sécurité, on ne peut pas utiliser dans le corps d’un article des appels à des balises SPIP. Trop risqués.

      La comme cela je vois trois solutions :
      1. On pourrait envisager d’ajouter pour la saisie « email » une option pour préremplir avec l’email de la session courante -> ouvre un ticket sur le plugin saisies. A mon avis c’est le plus perenne.
      2. Sinon un modèle qui appelle lui même le formulaire... mais c’est très casse gueule, on a souvent des ennuis.
      3. Enfin sans doute moyen de premplir à partir du pipeline charger mais c’est technique.

    • Effectivement, je viens d’essayer et la je ne charge même pas le formulaire !
      Donc à revoir
      En tout cas merci pour vos réponses DD et Maieul

      André

    • mmh pourquoi yorait besoin de « solution » ?

      André n’a pas indiqué OU il insère son formulaire mais si c’est dans un squelette ya aucun problème pour passer n’importe quoi dont #SESSION trucmuche ce qu’on veut non ?

    • @rastapopoulos

      je cite André :

      en l’appel du formulaire dans l’article, sans succès !

      donc il me semble que c’est hors squelette et dans le corps d’un article.

    • ah oui ok bah non dans l’article ça n’existe pas

      donc oui pour l’option de la saisie email à priori :)

    • En fait j’appelle le formulaire dans un article !
      Je suis un webmestre lambda, de ceux qui utilisent les plugins sans oser trop programmer, donc l’idée effectivement est d’utiliser mon formulaire dans un article.
      En fait mon besoin est simple, je fais parti d’une association qui organise des évènements (des sorties motos) pour l’instant j’utilise agenda et évènements, mais pas possible d’inscrire plusieurs personnes pour un membre, c’est pourquoi j’ai essayé le formulaire de réservation de formidable, mais le mail est obligatoire dans le formulaire hors ceux qui peuvent s’inscrire sont déjà authentifiés

      André

    Répondre à ce message

  • 6

    Bonjour,
    J’ai un formulaire Formidable de dépot pour mon association et tous les plugins sont à jour.
    Lorsque je remplis le formulaire, que j’ajoute un format non reconnu par Spip j’ai une page blanche au lieu du message prévenant du format non reconnu.
    Un formulaire de dépot dans l’espace privé est pourtant créé par cette demande et tous les champs sont vides,
    Voici la page du formulaire : https://www.edition999.info/Formulaire-d-envoi-de-votre-livre.html
    vous pouvez faire des essais avec des formats non repris, je les supprimerai ensuite.
    Merci pour votre aide.
    Jean-Michel

    Répondre à ce message

  • 1

    Bonjour,
    Est-il possible d’avoir un champ calculé ?
    Je souhaite ajouter un champs indiquant le prix en fonction des options sélectionnées et du nombre.
    Merci pour tout votre travail et votre prochaine réponse

    • Je pense avoir trouvé une réponse avec le plugin « La saisie calcul »

    Répondre à ce message

  • 7

    Bonjour,

    Est-il possible d’empêcher l’ajout d’une url dans un bloc de texte via les conditions ?

    Quelle serait la syntaxe à utiliser ?

    Merci

    • Oui, il faut utiliser une vérification de type « Expression régulière ». Et ensuite refuser par exemple les http.

    • Merci beaucoup !! Ça marche du tonnerre !! Plus de spams depuis les modifications !!!

    • Philippe

      Et concrètement, comment empêcher le http? Que doit-on mettre dans « La valeur doit correspondre au masque suivant » ?
      Merci de votre réponse.

    • Bonsoir Philippe, concrètement, tu configures le champ Bloc de texte dans l’onglet Validation, tu entres dans expression régulière la balise suivante : /http/

      Cela empêche ainsi les utilisateurs ou les robots d’entrer du texte qui contient des url.

    • Ha oui, c’est dans la zone Masque à tester que tu entres cette balise... et ensuite tu coches ’Vérifier que la réponse ne correspond pas au masque’ et tu peux aussi entrer un texte qui averti l’utilisateur la zone message d’erreur « Vous ne pouvez pas ajouter d’URL »...

      Cela n’empêche pas de recevoir d’autres formes de spams.... mais au moins, il n’y a plus de lien et cela n’a plus d’intérêt pour le spammeur....

    • Merci les amis !

    • On peut aussi améliorer la regex en ajoutant www... En effet, des petits malins utilisent cette façon de créer le lien url... /http|www/

    Répondre à ce message

  • 12

    Bonjour et bravo pour tout ce travail,
    je cherche à faire un seul formulaire pour les articles d’une rubrique (recrutement) qui reprendrait dans chaque article (offre d’emploi) le titre de l’article dans les envois au webmestre afin de savoir pour quelle offre la réponse a été donnée.
    J’ai cherché (certainement mal) dans le forum et je n’ai pas trouvé.
    J’imagine une info a ajouter dans l’appel du formulaire :
    #FORMULAIRE_FORMIDABLE{emploi,#TITRE}
    Par avance, merci, Alain

    • 1. Il faut reperer le « nom technique » du champ (listé à droite lorsqu’on édite le formulaire), du type input_1.

      2. Ensuite le passer effectivement en paramètres, mais pas avec la syntaxe que tu utilise, mais selon celle donnée plus haute dans l’article.

      Si ton formulaire a l’identifiant reponse_emploi ca donnerait :

      #FORMULAIRE_FORMIDABLE{reponse_emploi, #ARRAY{input_1, #TITRE}}

    • Tout dépend si c’est un appel dans les contenus, ou automatisé dans les squelettes de telle branche (ce qui est le plus logique dans ton cas).

      Il faut ajouter un champ caché (hidden), et pré-remplir ce champ avec une info du contexte (le ID_ARTICLE ou directement le titre humain), pour ensuite le réutiliser dans ton message final.

      Sinon tu peux aussi voir si le plugin Emplois te permet d’encore mieux gérer de manière dédiée ce besoin plutôt que détourner les articles.

    • Bonjour et merci à Maïeul et RastaPopoulos
      J’ai en effet utilisé les deux infos et j’étais un peu à l’ouest.
      Bien sur avec le champ caché (j’ai déjà le titre sur la page publique) et le code dans le squelette article-xx.html de la rubrique :
      #FORMULAIRE_FORMIDABLE{reponse_emploi, #ARRAY{hidden_1, #TITRE}}
      J’ai exactement ce que je souhaite, dans les mails, le tableau des réponses et l’accusé de réception, c’est parfait.
      Encore merci
      Alain

    • Bonjour,

      En lisant votre échange, je pensais pouvoir récupérer le titre de mon article dans un champ caché, (en appelant mon formulaire directement dans cet article) :

      <formulaire|formidable|id=1|hidden_1, #TITRE>

      Mais je ne récupère que la valeur #TITRE.

      Merci pour vos lumières !

    • Ah, ça fonctionne en utilisant directement dans le squelette :

      #FORMULAIRE_FORMIDABLE{contact, #ARRAY{hidden_1, #TITRE}}

      Ma syntaxe ne doit pas être correcte avec :

      <formulaire|formidable|contact|hidden_1, #TITRE>

      SPIP 4.1.5 et Formidable à jour.

    • Bé oui @Graphie, ça n’existe pas, depuis quand as-tu vu que #TITRE pouvait avoir un quelconque sens dans le contenu texte de n’importe quel contenu ? :p
      C’est une balise de boucle, du langage de squelette.

    • Hé voui, je comprends bien.

      Donc pour un formulaire inclus dans le corps d’un article, pas de possibilité de savoir depuis quel article il a été envoyé ?

    • Bé non, mais puisque tu es déjà dans le texte d’UN article précis unique bah t’as pas du tout besoin de dynamisme non ? Tu peux remettre le titre que tu veux dans le hidden=Mon super titre
      (oui en plus dans un modèle c’est toujours « = » hein pour clé=valeur, c’est pareil pour tous les modèles du monde)

    • Oui, bien sûr : c’est aussi simple de renseigner directement la valeur souhaitée.

      Par contre, la syntaxe que tu proposes et que j’utilise aussi sur tous les modèles, renvoie une erreur en PHP8 :

      <formulaire|formidable|contact|hidden_1='Page contact'>
      Warning: Undefined array key 1 in /www/site/plugins/auto/formidable/v5.2.2/formulaires/formidable.php on line 153

      c’est pour ça que j’ai testé avec :

      <formulaire|formidable|contact|hidden_1,'Page contact'>
    • Il n’y a pas le message d’erreur avec PHP 7.4, mais le champ n’est pas valorisé !

    • Aaah mais oui mais non, ce param c’est pas un param de modèle, c’est dans l’ordre des args du formulaire, donc ça doit être un tableau. La syntaxe est d’ailleurs documentée juste au-dessus :
      Formidable, le générateur de formulaires

    • Cool, merci pour les retours @RastaPopoulos ;-)

    Répondre à ce message

  • 2

    Bonjour

    Il y a un traitement que je ne parviens pas à faire. Je voudrais que le destinataire du courrier soit défini dans un champ du formulaire. J’ai tenté de mettre une adresse mail dans un champ caché, mais de ce que je comprends, ce champ attend un identifiant auteur. Or mon destinataire n’est pas un auteur.

    Dans mon cas, le champ #ORGANISATEUR_EMAIL est un champ supplémentaire de ma table evenement (via champ extra)

    <BOUCLE_evt(EVENEMENTS){id_evenement}{age<0}>
    #FORMULAIRE_FORMIDABLE{inscription, #ARRAY{evenements_1,#ENV{id_evenement},hidden_1,#ORGANISATEUR_EMAIL}}
    </BOUCLE_evt>

    Comment pourrais-je faire ?

    J’ai tenté d’utiliser le 3e argument avec l’option traiter_email_destinataires, mais je dois mal l’utiliser car quand je l’utilise, ça me remplit mon formulaire avec la réponse 1 (qui n’est même pas une réponse du formulaire identifié par inscription) :

    <BOUCLE_evt(EVENEMENTS){id_evenement}{age<0}>
    #FORMULAIRE_FORMIDABLE{inscription, #ARRAY{evenements_1,#ENV{id_evenement},hidden_1,#ORGANISATEUR_EMAIL}, #ARRAY{traiter_email_destinataires, #ORGANISATEUR_EMAIL}}
    </BOUCLE_evt>

    Merci pour toute idée

    • Il a suffit que je poste pour découvrir le plugin « Formidable participation : destinataires supplémentaires ». Qui fait exactement ce dont j’avais besoin

      Pardon pour le bruit.

      Néanmoins, j’aimerais savoir comment je suis censée utiliser la 3e option.

    • Euh non ça n’a pas de rapport, Formidable participation c’est pour lier des formulaires à des événements du plugin Agenda… donc à moins que tu n’utilises ça…

      Le plugin Formidable a déjà un champ de config *de base* pour permettre d’ajouter des emails suivant la valeur d’un autre champ, je ne sais plus l’intitulé exact du label de tête. Par ailleurs il ne faut surtout pas mettre des emails dans le code HTML du formulaire, c’est justement ce pour quoi les téléformulaires sont faits, ne pas ébruiter les emails pour les robots.

    Répondre à ce message

  • 2

    Bonsoir
    Spip 4.0.8, Formidable 5.2.2

    Juste une petite question d’ergonomie :
    Soit un premier champ suivi par un deuxième champ qui ne s’affiche que si le précédent remplit une condition.
    Puis un troisième champ sans condition d’affichage.

    Une fois le premier champ rempli, si l’internaute fait « entrée » ou « tabulation », et si la condition est remplie, le deuxième champ s’affiche bien, mais le focus est passé directement sur le troisième champ.

    Ce serait mieux si le focus se faisait sur le champ conditionnel qui vient de s’afficher.
    Mais je ne sais rien de la faisabilité...

    Sinon, comme à chaque fois que je poste ici, je redis toute ma considération pour ce plugin qui est simplement... formidable...

    Répondre à ce message

  • 2

    Bonjour,

    J’ai un formulaire qui est spammé depuis plusieurs semaines avec 4 champs remplis de manière identique (Nom, prénom, ville, pays).

    J’ai cherché dans l’onglet validation pour essayer de dire qu’un champ pour être valide doit avoir un contenu différent de tel autre champ, mais je n’ai pas trouvé.

    J’ai aussi essayé au niveau des options globales du formulaire en mettant dans « Affichage conditionnel du bouton de validation » :

    @ligne_1@ != @ligne_2@ && @ligne_7@ != @ligne_8@ 

    mais cette syntaxe est refusée.

    Est-ce que ça pourrait être une évolution du plugin ?

    • 1. Tu a bien pour chaque champ la possibilité de valider selon critère de comparaison avec un autre champ, mais il manque effectivement un critère différent. Ouvre un ticket dans verifier, cela se fait assez facilement.
      2. Pour étendre les afficher_si en comparant entre champ : oui ca pourrait se faire mais :
      -  c’est un ticket dans saisies qu’il faudrait ouvrir
      -  c’est plus complexe
      -  ca ne résoudrait pas totalement ton problème, dans la mesure où actuellement, pour le bouton de validation, il n’y pas de double vérif par formidable des valeurs des champs : c’est uniquement en JS, pas coté PHP.

    Répondre à ce message

  • 1

    Bonsoir,

    Actuellement j’utilise SPIP 4.1.5 avec Formidable 5.2.2 et je cherche à utiliser les formulaires pour s’inscrire à des évenements par contre il faudrait qu’une partie du formulaire ne soit pas visible si la date du jour est supérieure à la date limite d’inscription (qui est inscrit dans le formulaire pour faire simple).
    Est ce possible ?

    Merci
    bonne soirée
    Jeff

    Répondre à ce message

  • 1

    Bonjour,
    Problème de compatibilité avec spipr-dist (je suppose), l’insertion de formulaire se passe bien et il est utilisable dans l’espace privé mais n’apparaît pas dans l’espace public, de plus j’ai ce message sur la page des plugins :
    « Erreur dans les plugins : /var/www/spip/plugins/auto/formidable/v5.2.1/plugin_pipelines.php »

    • Aucune raison d’une incompatibilité particulière avec ce plugin. Comment sont insérés les formulaires ? Sont-ils publiés.

      Le message d’erreur est par ailleurs incomplet : il devrait y avoir des infos plus précise, je pense.

      En l’état, je ne peux pas faire grand chose.

    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