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

  • 2
    PRX

    merci pour ce plugin !

    Il serait bien de pouvoir enchaîner les formulaires car :

    -  en général, on a besoin des coordonnées de la personne partout : formulaire « contact » et d’un formulaire spécifique à la page en liant les deux.
    -  on fait peur à la personne si on fait un formulaire trop grand : il vaut mieux faire plusieurs pages courtes.

    Comment s’y prendre avec la version pour Spip 2.1 ?

    • PRX

      Il serait aussi bien qu’il ne prenne pas toute la largeur, mais la largeur du plus grand des champs, si on pouvait ajouter par ex |right> pour le caler à droite (ou à gauche ou au centre)

    • PRX

      et pour chaque formulaire, savoir où on l’ a employé : cela va venir très vite compliqué sur les gros sites.

    Répondre à ce message

  • joz

    Bonjour,
    j’ai un problème avec un champs type ’date’ : le datepicker me propose le choix d’années de 2003 à 2023, ce qui n’est pas du tout pertinent pour moi. Où est-ce que je peux changer cette plage de sélection ?
    d’avance merci
    joz

    Répondre à ce message

  •  ???

    Bonjour,
    Je veux cumulé le plugin Formulaire upload avec formidable, puisque avec formidable impossible de faire un upload...Mais je ne sais pas quoi faire pour que le fichier upload et mon formulaire partent ensemble dans le même mail. Est ce que quelqu’un l’a dèja utilisé ?? Merci de votre aide

    Répondre à ce message

  • 4
    Francis82

    Bonjour à tous,

    Bravo pour ce plugin très complet.

    Mes petits soucis :

    En local, j’ai construit un formulaire qui envoie un mail et s’enregistre dans la BDD.

    1. Quand je rempli ce formulaire plusieurs fois, avec une adresse mail différente, je n’ai toujours qu’une réponse enregistrée, la dernière. J’aimerais que ça stocke toutes les réponses en BDD.
    2. Après cela, j’aimerai faire des stats sur certains des champs des réponses sur le site public, j’ai bien lu la solution de Luc mais elle est pour moi, néophyte, un peu obscure. Ces stats porteraient sur des boutons radios (sexe) et des listes déroulantes (profession, age, etc.)

    Bref, j’ai besoin d’aide.
    Merci

    • RastaPopoulos

      1) Il faut configurer le traitement d’enregistrement en base comme il faut. Si vous le faites plein de fois vous même sur la même machine, c’est toujours la même personne qui répond, et vous avez dû configurer pour n’autoriser qu’une seule réponse par même personne.

      2) Le plugin fait déjà des statistiques (avec le modèle <formulaire123|analyse>. Et il y a aussi déjà des affichages en barre colorée avec pourcentage.

    • francis82

      Merci RastaPopoulos,

      La config changée, cela fonctionne.

      Par contre, je n’ai pas compris le
      "modèle  <formulaire123|analyse>"
      . C’est où ? Comment ça marche ?

      Je me sens un peu niais mais comme dit le proverbe :

      Pose ta question, tu auras l’ai con une fois
      Si tu la pose pas, tu seras con toute ta vie...

      Merci

    • RastaPopoulos

      Comment ça c’est où ? C’est un modèle, à insérer dans un contenu ou dans un squelette, comme tous les autres modèles de SPIP et des plugins.

      http://www.spip.net/fr_article3454.html

      Tu mets le numéro du formulaire que tu veux analyser, et ça te l’analyse. C’est ce qui est utilisé dans l’interface d’admin quand on visionne les statistiques, mais on peut l’utiliser n’importe où donc dans le site lui-même aussi.

    • francis82

      Ça s’éclaircit :)

      Si je ne veux analyser que certains champs (selction_x) ?
      J’ai essayé :

      <BOUCLE_champs(FORMULAIRES_REPONSES_CHAMPS){id_formulaires_reponse}{nom==^selection_}>
      Mais ça ne fonctionne pas...

      Une idée ?

    Répondre à ce message

  • voreysien

    Oui, c’est tout à fait ça, les réponses sont bien enregistrées, c’est uniquement aux stats que ça coince. En plus ce sont trois boutons radio avec une seule réponse possible, il n’y a rien d’autre sur ce formulaire.

    Répondre à ce message

  • 5
    JPADAL

    Bonjour,

    J’aimerais bien analyser les réponses du formulaire via leur export au format csv mais ni Excel ni Open Office m’affiche quelque chose d’exploitable...
    Avec open office calc, j’indique bien que le séparateur de champs est la virgule et que les valleurs sont mises entre double cotes mais j’ai toujours des lignes continues et non des valeurs bien rangées en colonnes, chacune dans sa petite cellule !
    Quelqu’un peut il m’aider ?
    Bien cordialement.
    JP

    • RastaPopoulos

      © Chez-moi-ça-marche. :)

      Du coup si je reproduis pas, c’est difficile de trouver une éventuelle erreur... :(

    • JPADAL

      Merci. En tâtonnant j’ai fini par y arriver sauf que j’ai des symboles bizarres a la place des lettres accentuées ...
      Et puis tient, tant que j’y suis, comment supprimer un des 2 destinataires qui me sembles avoir été mis là d’office ?
      A bientôt le plaisir de lire vos conseils ;-)

      JP

    • Jacques

      Avec Excel j’avais ce problème et ne savait pas comment m’en sortir. En ouvrant le fichier csv avec LibreOffice il est possible de choisir le charset lors de l’import : je choisis utf-8 et tout est OK.

    • JPADAL

      Bonjour, j’ai donc installé libreoffice mais je ne vois pas où et quand on choisit utf-8 ... merci de m’en dire un peu plus :)

    • JPADAL

      Bonjour Jacques
      et merci tardif mais bien sincère : avec ta solution du Libre office + charset j’ai des tableaux impeccables.!
      Mon problème est à considérer comme résolu.
      Bon weekend
      JPA

    Répondre à ce message

  • 3
    Luc

    Bonjour, et merci pour ce plugin. J’utilise MailCrypt qui fonctionne bien sur l’ensemble de mes sites, de même que Formidable, mais, sur les réponses de formulaire que j’affiche ensuite sur l’un de mes sites, le traitement n’est pas totalement appliqué et tous les emails sont transformés en textecheztexte.com. Conflit javascript ? Merci d’avance pour toute suggestion.

    • Luc

      Rebonjour, pas de petite suggestion ou ombre de début de piste ? Je trouverai dommage de devoir désactiver MailCrypt :(

    • RastaPopoulos

      Aucune idée, je ne connais pas / n’utilise pas ce plugin. Faut déjà regarder dans Firebug s’il y a des erreurs JS d’affichées. Mais Formidable n’ajoute aucun javascript (sauf Saisies si ya des fieldset pliable, mais c’est un tout petit truc), donc je ne vois pas trop en quoi il y aurait conflit...

    • Luc

      A priori pas de message d’erreur dans Firebug, et oui, pour le coup, j’utilise les fieldset pliables. Vous pouvez voir ça ici : http://www.carrefour-prison.ch/Etablissements-penitentiaires?id_formulaire=51, dans le premier pavé « Informations générales ». On dirait juste que le traitement par MailCrypt des adresses mails n’est pas finalisé. Il isole bien le @ mais devrait ensuite substituer le « chez » qui rend l’adresse confuse pour le coup. A d’autres endroits du site (hors formulaires) par contre, cela marche impec. (ex : http://www.carrefour-prison.ch/Contact)

    Répondre à ce message

  • 4
    jeronimo74

    Bonjour,
    Le plugin fonctionne formidablement bien. Juste une question :

    Est-il possible d’avoir une page résumant les réponses mais visible hors espace privé ?

    • jeronimo74

      Désolé mais je relance...

    • Luc

      Pour ma part, j’ai utilisé formulaires_reponse.html, un modèle présent dans le plugin et que tu peux adapter à ta sauce, avant de le placer dans tes squelettes.

    • jeronimo74

      Merci.
      Bien trouvé le fichier en question.
      Par contre je ne sais comment le personnaliser notamment « id_formulaire » et « id_formulaire_reponse »
      En clair comment « j’interroge » le bon formulaire ?

    • Luc

      Eh bien, le code est déjà mâché dans ce modèle, ensuite tu peux spécifier directement dans ta boucle l’id du formulaire (ou de l’une de ses réponses) ou le passer dans l’URL. C’est ce que j’ai fait en l’occurence, tu peux voir cela ici : http://www.carrefour-prison.ch/Etablissements-penitentiaires

      Je n’ai pratiquement pas eu à modifier le code, mais voici ce que j’utilise :

      <BOUCLE_reponse(FORMULAIRES_REPONSES){id_formulaires_reponse}>	
 
 #SET{valeurs,#ARRAY}
 <BOUCLE_champs(FORMULAIRES_REPONSES_CHAMPS){id_formulaires_reponse}>
#SET_MERGE{valeurs,#ARRAY{#NOM,#VALEUR|tenter_unserialize}}
 </BOUCLE_champs>

<BOUCLE_formulaire(FORMULAIRES){id_formulaire}>
#VOIR_SAISIES{(#SAISIES|unserialize), #GET{valeurs}}
</BOUCLE_formulaire>

</BOUCLE_reponse>

    Répondre à ce message

  • 3
    René

    Bonsoir,
    Bravo pour ce plugin génial qui me sert énormément !

    Petite question :)

    j’ai un site par exemple avec cette adresse : www.monsite.com

    J’affiche mes rubriques (contact par ex) comme ceci : www.monsite.com/contact

    Le problème c’est que lorsque je clique sur le bouton valider de mon formulaire de contact, celui-ci traite le formulaire mais me renvoie sur la page racine du site www.monsite.com. Du coup, le visiteur ne peut pas savoir si son message est bien envoyé ou si il y a une erreur de saisie. Sauf si il clique de nouveau sur la page contact :(

    Où se trouve le bout de code pour la fonction du bouton Envoyer ?
    Merci infiniment pour votre réponse.

    René

    • René

      Je me répond à moi-même :
      c’est dans le fichier formidable.html

      ligne 6

      Bonne soirée

    • RastaPopoulos

      Ce n’est pas normal que ça ramène à l’accueil du site. Soit ça reste sur la même page, soit ça redirige vers ce qui est configuré dans l’édition du formulaire, où on peut remplir un champ pour dire où ça va ensuite.

    • René

      Bonjour,
      pour des raisons de mise en page, est-il possible d’inscrire les messages d’erreurs directement dans les champs qui sont obligatoire ? et non en dessous ?
      Par exemple le champs EMAIL et MESSAGE ?

      Merci pour votre réponse.

    Répondre à ce message

  • 2
    pgiron

    Bonjour,
    Une question sans doute idiote, mais je ne trouve pas les feuilles de style pour personnaliser le formulaire (oui je sais, honte sur mi...).
    Merci de vos lumières...

    • RastaPopoulos

      Normal : il n’y en a pas ! :)

      À toi de bien styler tes formulaires dans ton site (et pas que ceux là, tous les formulaires potentiels), pas à ce plugin qui ne fournit que l’aspect fonctionnel.

      La structure HTML et les classes suivent la norme des formulaires de SPIP.

    • pgiron

      Normal : il n’y en a pas ! :)

      Ça corrobore donc ce que je subodorais après les avoir cherché !

      À toi de bien styler tes formulaires dans ton site (et pas que ceux là, tous les formulaires potentiels), pas à ce plugin qui ne fournit que l’aspect fonctionnel.
      La structure HTML et les classes suivent la norme des formulaires de SPIP.

      OK, merci ! :-)

    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