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.

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}}

Pré remplir les champs depuis une ancienne réponse

Si les réponses sont enregistrées, on peut passer en troisième argument un identifiant de réponse.

#FORMULAIRE_FORMIDABLE{contact,'',23}

pour modifier la réponse 23.

Champs oui-non et case unique

Pour rendre obligatoire la réponse “oui” à un champ de type oui-non ou 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)

updated on 14 January 2020

Discussion

710 discussions

  • bonjour,
    sur le sujet : “appeler mon formulaire” avec un titre ou pas et son identifiant, j’ai 2 remarques :
    (voir image de l’exemple employé ici de la liste des formulaires de formidable en pj)

    TITRE / PAS TITRE formulaire :
    si on met dans un contenu (article):
    <form38> (qui n’est pas documenté ici mais hérité de l’ancien plugin certes)
    on obtient le formulaire AVEC son TITRE. (ce qui est pas mal)
    si on met comme c’est documenté :

    <formulaire|formidable|id=40>

    on obtient le formulaire SANS son TITRE (pas terrible à mon goût)

    Identifiant : bug ?
    il est marqué en remarque du titre dans le formulaire de Formidable :“L’identifiant ne peut contenir que des chiffres, lettres latines non accentuées et le caractère “_””
    si on met , dans mon exemple : le titre comme affiché sur l’image et que l’on l’appelle
    : cela n’affiche RIEN.
    alors que <form40> fonctionne SI je renomme l’identifiant du formulaire en “form40”.

    Sans doute de la doc à compléter et une petite màj.
    merci !

    Reply to this message

  • 3

    bonjour,
    je veux faire des formulaires légèrement différents en traitement (réponse email différente) à partir d’un 1er formulaire qui fonctionne, mais n’ai pas envie de tout refaire.

    Il n’est pas visible ou prévu de faire des copies de formulaires, ou je n’ai pas vu, n’est-ce pas ?

    J’envisage alors une solution d’exploiter le 1er formulaire en l’appelant depuis un autre : est-ce la solution à ce problème ?
    Mais comment “imbriquer” des formulaires (formulaire qui en appelle un autre) svp ?
    merci !

    • Si si il y a une fonction de duplication de formulaire. “Dupliquer le formulaire” cela s’appelle,

    • Ah oui merci Maieul, pas vu , c’était trop bas à gauche, je suggère de remonter ces commandes...

      et pour les formulaires imbriqués : est-ce que cela se fait SVP ?
      merci !

    • Mouais, je suis partagé sur le fait de remonter, le bloc est deja pas mal chargé.
      Disons en tout cas que je le ferais pas tout de suite sans une réflexion globale sur le role de ces 2 blocs.

      Et non pas de possibiliét de formulaire imbriqué. Si je comprend un peu l’idée (une notion d’inclusion, comme les <INCLURE> de spip), je suis pas sûr du tout que ce soit une bonne idée.

    Reply to this message

  • 2

    Formidable plugin !
    J’ai réglé le formulaire sur modifiable par cookie. tout se passe bien, mais quand je reviens, pas de modification possible...
    Voici la page : https://www.accesstoland.eu/Inventory-of-Innovative-Land-Practices-in-Europe
    Que faut-il faire pour la modification ?
    Merci !
    Julien

    • Normalement il n’y a rien de spécial à faire. Par contre évidement je crois que cela ne fonctionne pas si on autorise les réposnes multiples.

    • Je confirme votre idée, c’était bien ça ! C’est somme toute assez logique.
      Je rajouterais un bouton pour effacer le cookie si la personne veut refaire un formulaire.
      Merci

    Reply to this message

  • 1

    Bonjour,

    Je pose ça là si ça peut servit à d’autres.

    Ayant constaté que certains utilisateurs soumettaient 2 fois un formulaire (double clic), voici un contournement en javascript.

    <script type="text/javascript">
    jQuery(document).ready(function()
    {
    $(".formulaire_formidable").submit(function (e) {
    //disable the submit button
    $(".formulaire_formidable .submit").attr("disabled", true);
    return true;
    });
    });
    </script>

    Reply to this message

  • 3
    Michel du lac de Créteil

    ATTENTION! => Le plugin SAISIES n’est pas encore actualisé en AUTO ce qui désactive le plugin FORMIDABLE! Ce qui est gênant, car nous attendons des inscriptions à un événement par un formulaire créé avec FORMIDABLE.


    MESSAGE :
    Erreurs survenues
    Impossible d’activer le plugin ../plugins/auto/formidable/v4.1.1
    Nécessite le plugin SAISIES en version ≥ 3.34.0.

    • Même problème ici. Très bloquant.

      Il est passé ici à Formidable 4.2.0. qui exige Saisie 3.34.0 qui n’est pas accessible.

    • comme expliqué sur l’autre file, c’est vraiment bizarre car j’ai posté saisie 3.34 AVANT formidable 4.2.0

      saisies 3.34 est d’ailleur disponible
      https://plugins.spip.net/saisies.html

      j’ai du reste réussi à mettre à jour sans problème sur un site via svp/auto

      je vous invite aller dans maintenance>liste des travaux et executer “svp_actualiser_depots”

    • Michel du lac de Créteil

      C’est OK maintenant!
      Merci!
      Michel

    Reply to this message

  • 2

    Bonjour,

    A la fin du formulaire, il y a le bouton validez. Comme je fais le formulaire en différentes langues, y a-t-il un moyen de changer le nom du bouton ?
    Cordialement

    • Bé quelle rapport avec la langue ? Cette chaine est déjà bien traduite dans plein plein de langues. Changer le mot c’est si on veut mettre complètement autre chose (y compris en français donc). Et il y a une interface pour ça, en haut à droite.

    • Merci beaucoup

    Reply to this message

  • 3

    Bonjour, je redécouvre formidable pour un usage un peu plus sophistiqué que d’habitude et je bloque sur un point.
    Je fais la sélection d’un widget “Sélecteur de rubrique”
    Ma question : Est-il possible de restreindre les rubriques affichés ? Secteur au moins ?

    Amicalement

    • La version 3.33.0 du plugin saisies, qui sera bientôt disponible en zip, permet de limiter le choix des rubriques à une branche (option dans l’onglet “utilisation”)

    • Merci pour l’info Maïeul, je vais voir comment m’adapter en attendant.

    • le zip devrait être disponible :)

    Reply to this message

  • 2

    Autre question :
    J’aimerais que celui qui a rempli le formulaire puisse imprimer l’affichage de la réponse (sans imprimer tout le menu du navigateur) et éventuellement recevoir cette page par email s’il le souhaite. Je n’ai pas trouver la solution.
    Merci de votre aide.

    • Bonjour,
      Etant novice, Je n’ai toujours pas trouvé la solution. Si quelqu’un peut m’aider ?
      Cordialement

    • Ben c’est à toi d’avoir des styles CSS pour que quand on imprime ça n’affiche pas la navigation, c’est au thème graphique de faire ça, mais ce n’est pas du ressort de ce plugin.

      Et pour le deuxième… ya que deux traitements fournis, et l’un est d’envoyer par email, dont l’option d’accusé de réception pour la personne qui rempli (si on lui demande un email).

    Reply to this message

  • 1

    Bonjour,

    Pour une base de données à visée statistique, je souhaiterais limiter le nombre de lettres tapée dans un un champ à trois caractères (pour des raisons de confidentialité),
    Peux-t-on faire cela ?

    Cordialement

    • Excusez moi, j’ai trouvé.
      C’est dans configurer le champ et utilisation.

    Reply to this message

  • 4
    Nicolosko

    Bonjour,

    j’écris dans le forum, faute d’avoir trouvé une réponse ailleurs, et je pédale complètement dans la saisie et les traitements du formulaire.
    Pour faire simple :
    -  J’ai une liste déroulante de destinataires, auteurs = @destinataires_1@
    -  un champ sujet = @input_1@
    -  un champ message = @textarea_1@

    Voila les choses que je n’arrive pas à faire :
    -  au submit, que le message sois envoyé au mail de l’auteur sélectionné dans la liste @destinataires_1@.
    -  passer un argument via l’url, qui doit changer les valeurs @input_1@ et @textarea_1@
    Du style si je passe dans l’url le parametre &param=toto, alors
    @input_1@ = blabla
    @textarea_1@ = bliblou

    Si rien n’est passé @input_1@ et @textarea_1@ ont des valeurs par défaut.
    Est-ce que quelqu’un parmi vous a déjà eu à faire à ce genre de problématique, si oui... comment vous en êtes vous sorti ?

    Merci d’avance.
    Cordialement
    Nicolosko

    • L’envoi c’est dans la config du traitement email… ya un champ de config exprès pour ça où tu choisis à qui suivant un des champs destinataires du formulaire.

      Pour le reste, c’est forcément en appelant ton formulaire dans un squelette que tu contrôles. Après bah tu fais tes tests et tu construis un #ARRAY de valeurs par défaut dans un #SET suivant ton paramètre d’URL, et tu le passes à l’appel du formulaire comme expliqué plus haut dans la doc.

    • Nicolosko

      Bonjour,

      merci pour ton retour. Ca fonctionne bien.
      J’ai encore une question... comment passer la phase de “prévisualisation” et envoyer directement le message ?
      Si t’as une idée...

      Merci.
      Nicolosko

    • heu... il n’y a pas de phase de previsualisation avec un formulaire formidable...

    • Nicolosko

      Wooops... tu as raison... finalement j’utilise le plugin “Formulaire de contact avancé”.. qui - lui - passe par une phase de prévizu... désolé.

      Merci

    Reply to this message

Comment on this article

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