Formidable, le générateur de formulaires

Published : 23 January 2012 – updated on 25 January 2026 – by Maïeul, RastaPopoulos – 3764 commentaires

1
2
3
4
5
201 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 utilisateurtrice

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_reponse Identifiant de la réponse à modifier Entier
no_ajax Désactiver l’ajax sur le formulaire Booléen
traiter_enregistrement_desactiver_modif_instituer_prop Permet de désactiver au cas par cas l’option de configuration « Lorsque l’internaute modifie la réponse, son statut redevient « proposée » » 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
ignorer_limite_date Permet de ne pas tenir compte de la date de publication et de la date d’expiration (à priori usage purement interne à formidable Booleen

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 years 1 year 3 months Without limit
par date
Filter

859 discussions

  • 3
    Zab_Paris

    Bonjour

    Je viens d’installer la dernière version de Formidable, le formulaire est ok mais... je ne reçois rien. Rien de rien.
    J’ai précisé, dans la configuration de traitement, l’autrice (moi), et j’ai rajouté deux adresses mails différentes dans les destinataires, et rien. Rien de rien. Même dans les spams évidemment.

    Voici la page du formulaire : https://www.elisabethmasset.fr/spip.php?article20

    mon spip est la version 4.4.28 , formidable version 770

    mais que se passe t il ?

    Merci de votre aide

    Zab

    • Maïeul

      Il faudrait deja vérifier si les mails tout court partent de ton site. Tu a la possibilité normalement de faire un test dans la configuraiton du plugin facteur.

    • Zab_Paris

      oui, tout à fait, et ça ne marche pas non plus... quelle que soit la configuration que je teste.
      J’ai une adresse free, une adresse gmail, aucune ne reçoit rien...
      j’essaye avec le mail php, rien. Smtp, rien.
      Les réglages de spip, rien. Réglages personnalisés, rien.
      J’envoie un mail test sur l’une ou l’autre adresse, rien.

      Au secours ! Free est parfois capricieux, mais normalement, gmail prend tout...

    • Maïeul

      il faudrait voir avec l’hébergeur alors ce qu’il en est.

    Reply to this message

  • 1
    vfavrat

    Bonjour.
    J’ai eu une mise à jour de Formidable sur mon site en 7.6.1 aujourd’hui et j’ai ces messages dans l’espace privé :
    Erreur d’exécution ../prive/squelettes/inclure/barre-nav.html
    et voir la capture d’écran.

    Du coup il n’y a plus du tout de menu principal avec les icônes dans l’espace privé.

    Je suppose qu’il s’agit d’un bug dans la nouvelle version.
    Ou est-ce un souci que je peux résoudre de mon côté ?

    Un peu d’aide svp 🙏🏻

    Merci d’avance.

    Virginie

    • vfavrat

      Bon ben je m’auto-réponds...
      Je viens de voir qu’il y avait un correctif dans la version 7.6.2...
      et effectivement plus de bug ;)

      Merci pour la réactivité des développeurs. 🙏🏻

    Reply to this message

  • 3
    Lexi

    Bonspip,

    J’ai un site avec un auteur administrateur unique (donc numéro 1).

    Il s’est trouvé récemment la soudaine apparition d’un auteur numéro -1, aussi administrateur; Je l’ai éliminé mais il s’est trouvé que mon formulaire de contact sous propulsion Facteur boosté par formidable s’est mis de maniére inexpliquée en gréve. Toutes les mises à jour ont été effectuées (SPIP + plugins)... Facteur envoyait toujours des emails de test, mais par le formulaire formidable, rien n’était expédié l’auteur du formulaire, sauf un email de confirmation à la personne qui remplissait le formulaire. Zarbi.

    Le probléme venait donc de Formidable et j’ai fini par découvrir que mon formulaire, suite à l’élimination de auteur id = -1, n’avait plus d’auteur! J’ai réattribué l’auteur initial auteur id = 1, (le vrai! l’unique!), et tout s’est remis en ordre!

    Est-ce possible que formidable soit à l’origine du problème?

    Bien spipement et fidélement interrogateur,

    Alexis

    le site: Alexis, Schnellzeichner.live

    • Maïeul

      Formidable n’a pas ajouté d’auteur -1, ca s’est sûr. Probablement une erreur lors d’une maj de SPIP.

    • RastaPopoulos

      C’est SPIP-Cli qui permet de créer un admin complet -1 avec une de ses commandes, généralement, et ça ne pose aucun problème (si tu sais qui a fait ça, par ex ton hébergeur pour t’aider ?).

      Par contre je ne vois pas pourquoi un formulaire ne marcherait plus parce qu’il n’aurait pas d’auteur : c’est totalement facultatif, et un formulaire peut parfaitement n’avoir aucun auteur du tout.

    • Lexi

      1- Je n’utilise pas SPIP-Cli, il n’est pas sur mon serveur.
      2- La première fois qu’un auteur id = -1 est apparu, c’est suite à un hacking du site. auteur id = -1 et auteur id = 1 étaient parfaitement homonyme, une sorte de double négatif.
      3- Le probléme d’envoi d’email à un auteur par un formulaire formidable a été résolu par la réattribution du champ destinataire à un auteur . Le probléme d’envoi d’email existait avant d’effacer auteur id = -1. Et ca a fonctionné pendant un certain temps, meme si auteur id = -1 devait sans doute être destinataire.

      C’est là que je voie un petit défaut du formulaire: l’interface du champ destinataire identifie un auteur par son nom, pas par son id. Si il y a des auteurs homonymes, on ne voit pas la différence entre deux auteurs.

      Question subsidiare: y aura-til un jour la possibilité d’ajouter des inputs de type range dans les formulaires?

      Bien spipement,

    Reply to this message

  • 4
    VincentC

    Bonjour,
    depuis le passage de la version 3 à la version 4 de spip, j’ai un gros souci de mise en page des formulaires
    j’ai fouillé, modifié mes css, mai je ne trouve pas
    si vous avez une idée, je suis preneur

    • Maïeul

      Bonjour,

      cela ne concerne pas spécifiquement formidable, mais plus largement les formulaires.

      Deja avoir un lien vers le site en question permettrait d’aider.

      Formidable suit la nomenclature des formulaires de SPIP, qui a effectivement changé enntre la 3 et la 4. Relire https://www.spip.net/fr_article3791.html peut aider.

      Enfin je vous invite à poser votre question sur discuter.spip.net où il y a des gens plus compétents en css que moi.

    • VincentC

      RE
      j’ai réussi à corriger quel aspect graphique, mais j’aimerai bien qu’il y ai un peu plus d’alignement et de coherence, genre le bouton radio aligné sur le texte, des input de même taille
      la page contact du site
      https://www.fontenayinsoumise.fr/spip.php?page=contact_fr
      merci à vous

    • VincentC

      J’ai pas mal avançé je trouve...

    • RastaPopoulos

      Hello, comme déjà dit par Maieul : ce plugin ne s’occupe absolument pas des styles graphiques. Seulement de générer fonctionnellement des formulaires configurables, qui marchent bien.

      Ce pourquoi ta demande d’aide devrait être posée dans le forum des utilisateurs Général de discuter.spip.net.

    Reply to this message

  • 1
    Florence HENRY

    Bonjour

    Je rencontre un dysfonctionnement lié à l’utilisation des mots-clés sur les formulaires.

    Dès que j’applique un mot-clé à un formulaire, la page du mot-clé en question liste tous les formulaires dans la section “Liés à ce mot-clé :” (cf 1e partie de la capture).

    Dans la page qui liste tous les mots-clés, c’est pourtant le bon nombre de formulaires qui est listé (cf 2e partie de la capture).

    Si le mot-clé n’est associé à aucun formulaire, rien ne s’affiche.

    Spip 4.4.16
    Formidable 7.5.3

    je n’ai pas réussi à voir où le problème se trouve dans le code de formidable.

    Reply to this message

  • 6
    GillesF

    Bonjour,
    Je suis confronté à un souci d’utilisation du plugin pour l’envoi de la notification aux responsables :
    mon organisation a mis en place une politique DMARC stricte m’imposant d’utiliser le même expéditeur mail dans tous les cas de figure (adresse type robot@mondomaine.fr).
    Concrètement, lorsqu’une personne avec une adresse externe à mondomaine.fr remplit le formulaire, l’envoi fonctionne, sans problème, en revanche, lorsqu’il s’agit d’une adresse de type jean.dupont@mondomaine.fr, ça bloque car dans ce cas, le “From” prend la valeur “jean.dupont@mondomaine.fr”, au lieu de robot@mondomaine.fr

    Je ne sais pas si je suis un cas isolé, mais là, j’avoue que je sèche...

    Mes versions :
    -  SPIP 4.4.15
    -  je suis sur SQLite
    -  PHP Version 8.3.31
    -  Formidable version 7.5.2

    Merci d’avance de votre aide

    Reply to this message

  • 6
    pamillet

    Après plusieurs expériences positives de formulaires, je voudrais utiliser un formulaire pour un sondage par mail sans l’intégrer dans un article.
    J’ai bien “Activer les pages publiques des formulaires”, mais si je vois l’option “Voir en ligne”, elle ne trouve pas le squelette adhoc..., j’ai une erreur 404 et en debug le message “1 Aucun squelette formulaire.html n’est disponible...”

    c’est dommage de devoir passer par un article quand ce n’est pas utile, et j’imagine que l’option “pages publiques” est prévue pour ca... ?

    • RastaPopoulos

      Hello, comme pour tous les types de contenus rajoutés par des plugins : c’est à toi (ou aux mainteneureuses des squelettes génériques si tu installes un plugin de squelettes/thème) de prévoir et d’intégrer un template pour ces contenus rajoutés (là les formulaires en l’occurrence).

      Le HTML et CSS des pages est toujours propre à un squelette/thème (ceux distribués par défaut, ou SpipR, ou HTML5-trucmuche, ou ceux de ton site perso fait à la main), il est donc rigoureusement impossible aux plugins qui rajoutent des contenus, de fournir un template générique qui fonctionnerait partout.

    • pamillet

      OK
      je ne trouve pas d’infos sur les balises permettant d’utiliser des éléments de formulaires, comme les texte d’intro ou de fin des options globales, sur ce qui permettraient de jouer sur les styles en fonction des éléments ? on a bien des identifiants pour les champs mais pour l’usage interne du formulaire...

      il y a une doc spécifique à formidable pour écrire ses squelettes ?

    • mikel

      Le plugin pages uniques?

    • Maïeul

      1: Non il n’est pas utile d’utilsier page unique. Il “suffit” de créer un squelette formulaire.html avec #FORMULAIRE_FORMIDABLE{#ID_FORMIDABLE}.
      2. Par ailleurs pamillet, inutile de poster 2 fois ton message : tu l’a deja posté sur discuter.spip.net et des gens te répondent la bas.
      3. Les textes d’intro et de fin sont automatiquement ajoutés. Pour le moment il n’est pas prévu de classe css, mais n’hésite pas à ouvrir un ticket à ce sujet.

    • pamillet

      @Maïeul,
      désolé pour l’usage double de discuter et de contrib. J’avoue que je ne sais pas trop quelle est la bonne pratique... pour une question sur un plugin, il faut plutôt écrire sur contrib ?

    • Maïeul

      Soit l’un soit l’autre mais pas les deux en meme temps: laisse le temps aux gens de répondre :)

    Reply to this message

  • 2
    Rémy Salaün

    Bonjour,
    dans un formulaire de candidature (unique) à des offres d’emploi pour une asso, j’ai besoin de récupérer dans un déroulant la liste des annonces (où une annonce = un article). Mais comment faire ? Peut-on écrire une boucle dans un formulaire (mes tests ne sont pas probants) ?
    Ou faut-il créer un formulaire par article ?
    Merci pour votre aide,
    Rémy

    • RastaPopoulos

      Il n’y a pas de saisies simple de sélection d’article. Mais tu pourrais coder et déclarer (html + yaml) ta propre saisie dédiée.

    • Rémy Salaün

      Merci pour ta réponse,
      je vais explorer cette piste :-)

    Reply to this message

  • 1
    Sandra C.

    Bonjour,

    Juste pour prévenir que lorsqu’on installe la version 7.4.0 sur un nouveau site, le plugin ne crée pas la table formulaires_reponses.

    Pour ceux à qui ça arrive, j’ai pallié au problème en supprimant la version 7.4.0.
    À la place, j’ai installé la version 6.6.2 (la première compatible avec Spip 4.4), puis j’ai simplement fait la mise à jour vers la version 7.4.0.

    • Maïeul

      Merci pour le signalement. La version 7.4.1 corrige cela. Elle sera disponible très prochainement.

    Reply to this message

  • 9
    Florence HENRY

    Bonjour

    Je rencontre un problème avec le sélecteur d’articles. Dans la configuration il y a la possibilité de restreindre le choix à une branche (j’imagine qu’il s’agit de secteur ?).

    Quand je précise un secteur dans la configuration, c’est bien bonne rubrique qui est indiquée, mais aucun article n’apparaît dans le sélecteur..

    Je joins la copie d’écran avec et sans la limitation.

    Est-ce que j’ai mal utilisé la fonctionnalité ?

    Mon environnement
    -  php 8.3
    -  spip 4.4.7
    -  formidable 7.3.4

    • Maïeul

      Bonjour,

      pourriez vous envoyer un export yaml du formulaire en question ?

    • Florence HENRY 
      id_formulaire: '3'
identifiant: soumettre_annonce
titre: Annoucements
descriptif: ''
css: ''
message_retour: ''
saisies:
  -
    options:
      label: Title
      placeholder: 'Title of the event'
      type: text
      autocomplete: defaut
      obligatoire: 'on'
      nom: input_1
    verifier: {  }
    identifiant: '@697ccd10b7afd'
    saisie: input
  -
    options:
      label: Content
      rows: '10'
      obligatoire: 'on'
      nom: textarea_1
    verifier: {  }
    identifiant: '@697ccd11b1a2f'
    saisie: textarea
  -
    options:
      label: Email
      type: text
      autocomplete: defaut
      obligatoire: 'on'
      nom: email_1
    verifier:
      -
        type: email
        options:
          mode: normal
    identifiant: '@697ccd170a7ad'
    saisie: email
  -
    options:
      label: Statut
      defaut: submitted
      nom: hidden_1
    identifiant: '@697ccd80180d6'
    verifier: {  }
    saisie: hidden
  -
    options:
      label: 'Included in newsletter'
      limite_branche: '6'
      nom: selecteur_article_1
    verifier: {  }
    identifiant: '@697df4ea675fe'
    saisie: selecteur_article
traitements:
  enregistrement:
    moderation: priori
    moderer_admins: ''
    multiple: 'on'
    modifiable: ''
    modif_instituer_prop: ''
    unicite: ''
    message_erreur_unicite: ''
    unicite_statuts: ''
    identification: ''
    variable_php: ''
    effacement_type: nope
    effacement_delai: ''
    effacement_date: ''
    anonymiser: ''
    ip: ''
    invalider: ''
    resume_reponse: ''
    analyse_exclure_champs: ''
    identification_reponses: ''
apres: formulaire
url_redirect: ''
statut: publie
date_creation: '2026-01-30 15:23:30'
date: '2026-01-30 15:34:36'
message_prepublication: ''
date_expiration: '0000-00-00 00:00:00'
message_postexpiration: ''
maj: '2026-01-31 13:42:44'
composition: ''
composition_lock: '0'
    • Maïeul

      C’est un bug dans spip, je viens de soumettre une proposition de correction, à tester

      https://git.spip.net/spip/prive/-/merge_requests/120

    • Florence HENRY

      Merci ! Dites-moi quand je peux tester

    • Maïeul

      Vous pouvez deja tester d’appliquer “à la main” le patch.

    • Florence HENRY

      j’avais un problème avec mon compte sur git et je n’ai pas pu regarder le patch plus tôt.

      Je vois maintenant que le patch a été intégré dans la version 4.4.13 que je viens de tester.

      malheureusement, le problème est toujours là.

    • Maïeul

      Je viens de retester et chez moi ca marche : j’ai bien les articles du secteur 6.

    • Florence HENRY

      En désactivant tous mes plugins sauf formidable, en effet le problème est résolu (merci !).

      Il réapparaît quand j’active le plugin Pages (version 2.3.0).

      Je fais une notification sur la page de ce plugin ?

    • Maïeul

      Oui, tu peux ouvrir. Sans doute cela vient d’une surcharge du formulaire par le plugin page. Je pense que tu peux avec la MR originel voir ce qu’il faut adapter (mais perso j’ai assez donné sur ce problène)

    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
  • 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.

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