Formidable, le générateur de formulaires

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

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

166 discussions

  • 3
    PRX38

    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 !

    • Maïeul

      Si si il y a une fonction de duplication de formulaire. « Dupliquer le formulaire » cela s’appelle,

    • PRX38

      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 !

    • Maïeul

      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.

    Répondre à ce message

  • 2
    julien

    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

    • Maïeul

      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.

    • julien

      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

    Répondre à ce message

  • 1
    RealET

    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>

    Répondre à ce 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.

    • Rpnpif

      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.

    • Maïeul

      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

    Répondre à ce message

  • 2
    aloysus

    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

    • RastaPopoulos

      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.

    • aloysus

      Merci beaucoup

    Répondre à ce message

  • 3
    Ras Rubenxela

    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

    Répondre à ce message

  • 2
    aloysus

    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.

    • aloysus

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

    • RastaPopoulos

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

    Répondre à ce message

  • 1
    aloysus

    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

    • aloysus

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

    Répondre à ce 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

    • RastaPopoulos

      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

    • Maïeul

      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

    Répondre à ce message

  • 5
    AMHengrenage

    Bonjour, j’ai repris la gestion d’un site internet sous spip (je n’y connais pas grand chose) et je rencontre depuis +6mois un problème avec le formulaire.
    Malgré mes nombreuses recherches, j’ai vérifié tout le protocole de création,... quand un visiteur rempli le formulaire de contact, un 1er message apparait comme d’habitude signifiant que le message a été envoyé. Puis un 2d juste après indiquant qu’une erreur avec le formulaire vient d’arriver, et qu’il faudra réessayer ultérieurement.
    J’ai également vérifié la mise à jour des pluggins, je ne trouve pas la solution. Je ne sais pas quels détails vous donner de plus, dites moi !
    Helpp me please.....

    • Maïeul

      ce genre de message arrive notammenet (mais peut être pas queue) lorsqu’un bug PHP a lieu plus loins.

      Deja
      1) peut tu m’envoyer un export .yaml de ton formulaire, que je vois si je retproduis en local
      2) ton hebergeur doit avec des logs PHP, il faudrait les regarder

    • AMHengrenage

      Merci pour cette réponse rapide. Voici l’export du formulaire ci-dessous.

      id_formulaire : ’1’
      identifiant : contact
      titre : Contact
      descriptif : ’Formulaire destiné aux questions provenant du site.’
      css : ’’
      message_retour : ’Merci d’’avoir contacté l’’AMH. Nous répondrons à votre question dès que possible.’
      saisies :
      - options : label : ’Votre adresse email’, type : text, size : ’40’, autocomplete : defaut, obligatoire : on, erreur_obligatoire : ’Merci d’’indiquer votre adresse mail’, nom : email_1 , verifier : type : email, options : mode : normal , identifiant : ’@595e070218b83’, saisie : email
      - options : label : ’Votre question concerne’, datas : « choix1|Les cours & ateliers\r\nchoix2|La production & diffusion\r\nchoix3|Nos créations\r\nchoix4|Autre », obligatoire : on, erreur_obligatoire : ’Merci de sélectionner un sujet’, nom : selection_1 , identifiant : ’@595e08d482ac7’, saisie : selection
      - options : label : ’Votre message’, rows : ’5’, cols : ’40’, nom : textarea_1 , identifiant : ’@595e07302b0f5’, saisie : textarea
      traitements :
      email : champ_destinataires : ’’, champ_courriel_destinataire_form : ’’, destinataires_plus : ’’, destinataires_selon_champ : « @selection_1@/choix1 : accueil@atelierdemusiqueduhavre.com\r\n@selection_1@/choix2 : melanie@atelierdemusiqueduhavre.com\r\n@selection_1@/choix3 : melanie@atelierdemusiqueduhavre.com\r\n@selection_1@/choix4 : info@atelierdemusiqueduhavre.com », champ_courriel : email_1, activer_vrai_envoyeur : on, champ_nom : ’@email_1@’, champ_sujet : ’[Formulaire contact]’, pj : ’’, masquer_liens : ’’, activer_ip : ’’, activer_accuse : ’’, sujet_accuse : ’’, courriel_envoyeur_accuse : ’’, nom_envoyeur_accuse : ’’
      public : non
      apres : valeurs
      url_redirect : ’’
      statut : publie
      date_creation : ’2017-07-06 12:33:17’
      maj : ’2019-03-26 15:08:17’

      Effectivement, nous avons un 2e gros problème : l’envoi en nombre. Un msg d’erreur récurrent « SMTP error : could not authenticate » je ne sais pas à quoi ça correspond ... ni que mettre dans les paramètres de configuration divers puisque ça marchait très bien avant comme c’était. Mais lors de mon arrivée nous avons changé le serveur principal et je pense que des connexions et paramètres ont changés. Lesquels ? et où trouver ces infos ?

    • Maïeul

      Les serveurs standard ne sont pas fait pour envoyer des mails en nombre. Dans ce cas il y a des solutions prévu pour (voir du coté du plugin newletter et compagnie).

      Mais là n’est présentement pas la question : visiblement il semblerait que vous n’arrivez pas DU TOUT a envoyer de mails (cf le SMTP error). Faite des tests du coté de la configuration de facteur. Peut être un réglage à faire au niveau de la fonction mail() chez votre hebergeur, ou sinon passez par un smtp externe.

    • AMHengrenage

      Oui justement, nous avons bien les pluggins nécessaires à l’envoi en nombre (facteur, mailshot, mailsubscibers, newsletter).
      Concernant la configuration du facteur, je ne m’y connais pas assez pour oser changer quoi que ce soit.
      Alors après nous sommes hébergés chez ovh, et avons la version php 5.4 (où ovh nous indique avec un triangle rouge qu’elle est obsolète). Mais n’y connaissant vraiment rien à ce sujet non plus j’ai peur de tout faire planter, de perdre toutes les données ainsi que l’utilisation du site internet...

    • Maïeul

      Hum

      1. Comment est configuré mailshot ? car si vous dite « envoie en nombre » en passant par le serveur et pas par un prestataire externe, vous aurez des ennuis tout de même (enfin, ca depend : combien envoyez vous de mail en nombre, à quelle fréquence ?)
      2. Il se peut du coup que la fonction mail chez ovh ne marche plus en php 5.4, sils déconseille,
      3. Je vous invite à basculer en php 7.2, encore qu’il faut que votre spip soit à jour. Quelle version de SPIP avez vous ? Aucun risque a priori de perdre les données, mais faite tout de même une sauvegarde avant :
      -  avec phpmyadmin, une sauvegarde de la base
      -  en ftp, sauvegarde de IMG, squelettes,
      4. Pour le smtp, vous trouverez aisément des tutoriels sur internet pour savoir comment configurer smtp, il faudrait faire la même chose dans la configuration du plugin facteur. Surtout, vous pouvez dor et deja faire un test d’envoi mail dans facteur.

      Bref, tout cela ne m’a pas l’air directement lié à formidable, et je vous invieterau à poser les questions sur la liste de spip, plutot.

    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