Formidable, le générateur de formulaires

Publié le : 23 janvier 2012 – Dernière modification le 19 mars 2024 – par Maïeul, RastaPopoulos – 3511 commentaires

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

5 ans 1 an 3 mois Sans limite
par date
Filtrer

811 discussions

  • 3
    robomatix

    Merci pour ce plugin formidable !!!

    Je m’en suis servi pour créer un formulaire de contact avec juste un courriel à saisir et un champ text pour le message...

    Lorsque l’on clique sur envoyer, j’ai comme message :

    Strict Standards : Non-static method Facteur::html2text() should not be called statically in /www/xxx/cccc/x/plugins/auto/formidable/v1.3.4/traiter/email.php on line 109...

    Une solution ?

    Merci d’avance !

    • robomatix

      php 5.4 ( OVH avec SetEnv PHP_VER 5_4 )

      Bravo pour ta réactivité !

    • robomatix

      Pour info, J’ai mis dans le htaccess SetEnv PHP_VER 5 donc => php 5.2 et voilà !
      Ca marche !!!!

      Merci RastaPopoulos pour la piste !

      Ceci dit, ça serait bien si ça marchait avec php 5.4... ;-)
      Pour moi, sur ce site, c’est pas vraiment important...
      Mais peut être que ça le sera pour d’autre !
      Bon courage et encore merci pour ce super plugin qui permet de faire de formidables formulaires en quelques clicks !

    Répondre à ce message

  • Vincent

    Bonjour,
    Je suis confronté à un problème : ce plugin ne fonctionne pas avec un hébergement chez free. Il m’est impossible de créer un formulaire. Le message d’erreur est le suivant : formidable_1_0/formulaires/formidable.php on line 54
    Quelqu’un saurait-il quoi faire ?
    Merci d’avance

    Répondre à ce message

  • bruno31

    Bonjour à tous et à Rastapoloulos en particulier

    Toujours pas de version pour le téléversement de fichier ?

    Je peux libérer du temps pour participer à l’évolution de FORMIDABLE, mais il me faut un minimum de support Rastapopoulos. A ta disposition :o)

    Répondre à ce message

  • 1
    Jacques

    Dans un formulaire j’ai mis un champ avec liste déroulante (une liste de clubs). Je souhaiterais que quelqu’un qui n’est pas dans un club puisse mettre autre chose, de son choix (une ville, une école etc...) Pour l’instant j’ai mis un choixXX|autre mais comment faire pour pouvoir écrire comme dans une ligne de texte ?

    Il est possible de mettre des classes css supplémentaires sur les champs de ligne de texte, mais pas sur les autres champs (bouton radio, checkbox,, liste déroulante), est-ce volontaire ?

    Enfin lorsqu’on active l’option modération à priori il n’est pas facile de voir si on va valider l’enregistrement du formulaire : on voit bien ce qu’a posté la personne, son nom si c’est un rédacteur inscrit (Anonyme si non inscrit), l’adresse IP... Mais il faut cliquer sur chaque réponse pour connaitre le contenu et savoir si on valide. J’aurais besoin là d’avoir le tableau complété avec les réponses pour valider (dans la pratique c’est surtout pour éliminer les doublons alors que les saisies multiples sont autorisées). J’imagine que dans certains cas le tableau exploserait la mise en pages en largeur, mais c’est gérable pour cette opération de validation, non ?

    • Jacques

      (...)lorsqu’on active l’option modération à priori il n’est pas facile de voir si on va valider l’enregistrement du formulaire : on voit bien ce qu’a posté la personne, son nom si c’est un rédacteur inscrit (Anonyme si non inscrit), l’adresse IP... Mais il faut cliquer sur chaque réponse pour connaitre le contenu et savoir si on valide(...)

      Pour contourner ce souci chez moi j’ai surchargé deux fichiers.

      Tout d’abord dans squelettes/prive/objets/liste/formulaires_reponses.html avec

      <td >#ID_FORMULAIRES_REPONSE</td>

      juste avant la cellule de puce de changement de statut. Donc déjà pour chaque ligne on a l’ID de l’enregistrement.

      Ensuite j’ai surchargé dans squelettes/action/exporter_formulaires_reponses.php de façon à avoir les réponses avec statut « publie » et « prop » (merci denisb pour le code !) en remplaçant la ligne 22 de ce fichier par

      AND $reponses = sql_allfetsel('*', 'spip_formulaires_reponses', 'id_formulaire = '.$id_formulaire.' AND (statut = '.sql_quote('publie').' OR statut = '.sql_quote('prop').')')

      Puis j’ai ajouté l’affichage de de l’ID et du statut d’abord dans la ligne de titre du csv

      // La première ligne des titres
		$titres = array(_T('public:id'),_T('public:date'),_T('public:statut'), _T('formidable:reponses_auteur'), _T('formidable:reponses_ip'));

      puis dans les cellules du tableau :

      // Le début de la réponse avec les infos (ID,date,Statut, auteur, etc)
			$reponse_complete = array($reponse['id_formulaires_reponse'],$reponse['date'],$reponse['statut'], $nom_auteur, $reponse['ip']);

      Voilà, comme ça j’arrive à m’y retrouver pour valider les réponses...
      Est-ce qu’il serait possible d’intégrer au moins l’ID de la réponse dans prive/objets/liste/formulaires_reponses.html dans le plugin.
      L’autre usage est peut-être plus spécifique (exporter à la fois publié et proposé) mais serait-il possible d’avoir une option de configuration qui permette de choisir les statuts qu’on exporte ?

    Répondre à ce message

  • Teenoo

    Bonjour,

    petite question pratique, comment appliquer un placeholder dans le code HTML des formulaires générés automatiquement ?

    Merci pour votre réponse.

    Répondre à ce message

  •  ?

    Bonjour,
    ca vient de moi ou bien ya pas moyen de télécharger un fichier sur ce plugin ?? Merci de votre réponse

    Répondre à ce message

  • 2
    jacques83300

    Bonjour,

    Merci beaucoup pour ce plugin très utile.

    Je souhaite utiliser ce formulaire pour qu’un visiteur puisse envoyer une requête à une liste de distribution pré-définie.
    Est-il possible de rajouter au message qui sera envoyé aux membres de cette liste un en-tête qu’eux seuls pourront voir (et pas le visiteur) ?

    Merci d’avance pour votre réponse.

    • RastaPopoulos

      Ben tu peux toujours personnaliser le courriel envoyé, comme expliqué dans la doc ci-dessus, dans « notifications/formulaire_IDENTIFIANT_email.html ».

    • jacques83300

      Merci beaucoup pour cette réponse.

    Répondre à ce message

  • 2
    bob

    Bonjour, je suis confronté à une énigme. J’ai installé le plugin formidable sur un serveur dédié ovh, sous plesk. Je l’ai fait à mainte reprise.
    Pourtant, aujourd’hui, impossible de voir le formulaire que j’ai créé et que j’ai inséré dans un article, ni dans la partie privé ni dans la partie public.
    Une idée ?

    • bob

      Voici le type d’erreur rencontré :
      [Tue Jan 15 16:55:43 2013] [error] [client 77.104.18.94] PHP Fatal error : Unsupported operand types in /var/www/vhosts/nomdedomaine/httpdocs/plugins/auto/formulaires/formidable.php on line 54, referer : nomdedomaine/ecrire

    • RastaPopoulos

      Version de PHP trop ne supportant pas ce qui est fait dans ce fichier. Faut une version plus récente.

    Répondre à ce message

  • 1
    laurent

    Bonjour,

    j’utilise Formidable pour ma page Contact dans laquelle j’ai inséré 1 liste déroulante « Pays ».
    J’y ai mis par défaut le choix1 et cela s’affiche correctement dans l’espace privé mais pas dans l’espace public.
    J’ai essayé de retrouver la partie de code qu’il me faut mettre à jour, mais je n’y parviens pas :

    Le code :

    Avec Firebug le rajout de « option value= »« choix1 »« »/option" me donne le résultat recherché.
    Si vous avez 1 petite idée à ce sujet je suis preneur.
    Merci d’avance pour l’aide que vous pourriez m’apporter.

    Formidable 0.6.7
    SPIP 2.1.12
    Sarka-SPIP 3.0.8

    • laurent

      Désolé pour la question du dessus et merci pour ce super plugin !

    Répondre à ce message

  • 4
    Rainer Müller

    Bonjour,

    Sous firefox 18 et Opéra 12.12 je n’arrive pas changer l’ordre, le drag and drop focntionne mais le changement d’ordre n’est pas sauvegardé ; visiblement le même problème que constaté ici : http://www.mail-archive.com/spip@rezo.net/msg46816.html.

    Formidable : 1.3.4 SVN [66722]
    SPIP 3.0.5 [19905]

    • RastaPopoulos

      J’ai Firefox 18, et je n’ai aucun problème. Je change la position d’un champ, et j’appuie sur Enregistrer en bas. Et ça marche.

    • Rainer Müller

      C’est pourtant ce que je fais, dans les log j’ai ceci
      Jan 14 11:10:45 66.249.73.85 (pid 2562) :Pub:info : Erreur - ’commandes_recuperer_fond’ non definie !

      C’est lié ?

    • RastaPopoulos

      Quand on teste un plugin, on désactive d’abord tout ce qui n’est pas en rapport avec celui-ci (donc tous les autres plugins sauf ce qui est nécessité).

      C’est marqué juste au-dessus du champ de texte en cliquant sur « Les choses à faire avant de poser une question ».

    • Rainer Müller

      Tout à fais traison,

      Cependant je viens de tester sur un spip avec seulement les plugins nécessaires pour formidables actives. Et cela se reproduit.

      Apparemment un nombre trop important de champs rend inopérable le changement de position/rang

      Pour Info, il s’agit d’un formulaire avec 18 champs. -> J’arrive à déplacer le champ 18 à la position 17 mais pas plus haut.

      Avec un formulaire de teste contenant moins champs cela marche parfaitement

    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