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

  • nostradamus1935

    Un plugin qui porte bien son nom : formidable !

    Répondre à ce message

  • 3
    bruno31

    Ce plugin est EXCELLENT. Un grand MERCI à l’auteur

    J’insère des formulaires dans le contenu d’un article.

    SI le visiteur est connecté et qu’il a saisi un formulaire, je voudrais qu’une des données saisie puisse être insérée à certains endroits précis de l’article.

    Exemple :
    J’ai un formulaire avec une input X et une input Y

    Dans mon article, je voudrais insérer une balise, qq chose du genre :

    <formulaire_reponse_champs|id_formulaire=1|champs=X>

    Je suppose qu’il s’agit d’un modèle à créer ?
    ou alors existe t’il déjà qq chose ?

    • bruno31

      Sans attendre la réponse, j’ai créé le modèle :

      [(#REM) Ce modèle est à utiliser avec FORMIDABLE
Il sort la donnée saisie par un visiteur (id_auteur est pris dans la session) pour un champs précis d'un formulaire
Paramètres :
- id : (obligatoire) le id textuel d'un formulaire
- champs : (obligatoire) nom du champs (Ex : input_1)
- defaut : (optionnel) la valeur par défaut si aucune valeur trouvée

Exemple : <formulaire_reponse_champs|id=dim1|champs=input_1>
]
<BOUCLE_formulaire(FORMULAIRES){identifiant=#ENV{id}}>
	<BOUCLE_reponses(FORMULAIRES_REPONSES){id_formulaire=#ID_FORMULAIRE}{id_auteur=#SESSION{id_auteur}}>
		<BOUCLE_champs(FORMULAIRES_REPONSES_CHAMPS){id_formulaires_reponse=#ID_FORMULAIRES_REPONSE}{nom=#ENV{champs}}>
			#VALEUR
		</BOUCLE_champs>
			#ENV{defaut}
		<//B_champs>
	</BOUCLE_reponses>
		#ENV{defaut}
	<//B_reponses>
</BOUCLE_formulaire>
    • RastaPopoulos

      Oui il faudrait que tu crées un modèle pour ton besoin précis. En allant chercher uniquement la réponse de l’utilisateur connecté.

      De tête là comme ça :

      <BOUCLE_formulaire(FORMULAIRES){id_formulaire}>

<BOUCLE_reponse_du_connecte(FORMULAIRES_REPONSES){id_formulaire}{id_auteur=#SESSION{id_auteur}}{id_auteur>0}>
    #SET{valeurs,#ARRAY}
    <BOUCLE_champs(FORMULAIRES_REPONSES_CHAMPS){id_formulaires_reponse}>
        #SET{test_array,#VALEUR|unserialize}
        #SET{valeur,#GET{test_array}|is_array|?{#GET{test_array},#VALEUR}}
        #SET_MERGE{valeurs,#ARRAY{#NOM,#GET{valeur}}}
    </BOUCLE_champs>
</BOUCLE_reponse_du_connecte>
    [(#REM) Pour ne garder que la saisie avec le nom que tu veux )]
    #SET{saisie,#SAISIES|unserialize|saisies_lister_par_nom|table_valeur{#ENV{champ}}}
    #SET{saisie, #ARRAY{0,#GET{saisie}}}
    
    #VOIR_SAISIES{#GET{saisie}, #GET{valeurs}}
</B_reponse_du_connecte>

</BOUCLE_formulaire>

      Et si tu veux qu’il n’y ait que la valeur et pas le titre du champ, il faut que tu arrives à ajouter l’option « valeur_uniquement » à la saisie que tu récupères (plus facile dans un filtre PHP vu que c’est un tableau à modifier).

    • RastaPopoulos

      Ah ok si t’es sûr que c’est un champ libre, tu peux afficher directement la valeur brut comme ça. Mais sinon il faut utiliser #VOIR_SAISIES

    Répondre à ce message

  • 5
    jpqvn

    Bonjour,

    je tiens d’abord à féliciter l’auteur de cet excellent plugin qui m’a permis d’organiser un sondage et de mettre en place un formulaire d’adhésion en ligne. J’apprécie également la « philosophie » de sa conception structurée en plusieurs plugin élémentaires utilisables par d’autres applications.

    Deux questions :
    1/ cette dernière version peut elle remplacer celle que j’utilise (0.5.5) sans perte des formulaires déjà créés ? Quelle est la procédure à suivre ? (je suis sous SPIP 2.1.0)
    2/ Est-il possible de modifier le mail qui me retourne les formulaires. J’aimerai par exemple pouvoir mettre la réponse su la même ligne que le nom du champ. Quel est le fichier que je dois modifier et qui génère la présentation actuelle ?

    Merci par avance et encore bravo

    • RastaPopoulos
      1. Pas de grands changements dans la base, et de toute façon il y a des scripts de mise à jour lorsqu’il y en a besoin.
      2. Le mail est un squelette, que tu peux donc personnaliser comme tout squelette SPIP (dans ton dossier squelettes/ avec la même arbo) soit par défaut (pour tous les formulaires) mais aussi formulaire par formulaire, en ajoutant l’identifiant : le documentation est juste au-dessus de ton message ! :)
    • DD

      Bonjour,

      Est-ce que la partie du squelette à modifier est bien : #VOIR_SAISIES#ENV*saisies, #ENV*valeurs

      et comment modifier les informations transmises ?

      merci

      dd

    • RastaPopoulos

      Nan ça c’est un truc automatique qui affiche d’un coup d’un seul toutes les saisies fournies en paramètres.

      Donc le seul moyen c’est de boucler toi-même sur les saisies et les réponses et d’afficher ce que tu veux un par un. C’est un peu plus compliqué, forcément.

    • DD

      Merci. Je m’en suis doutée après coup.

      Autre chose, mon site utilise le plugin ispip pour la version mobile et les formulaires ne sont pas affichés sur les pages des articles. Est-ce que formidable est compatible avec un autre système d’affichage mobile (ie responsive pour être à la mode) ?

      dd

    • RastaPopoulos

      Je ne sais pas ce que fais iSPIP donc je ne peux pas répondre. Mais tout squelette classique est censé afficher ces formulaires, ils ne sont pas différents des autres formulaires de SPIP (forum, inscription, etc). Si un squelette affiche les formulaires de base, il devrait aussi afficher les formulaires de Formidable.

    Répondre à ce message

  • 1
    naomed

    bonjour, je cherche depuis 2 jours à créer un formulaire avec plusieurs questions, j’ai réussis (pas de quoi être glorieux !) en revanche, je sèche lamentablement sur la manière d’afficher le récapitulatif de toutes les réponses à toutes les questions du formulaire. Comme dans les plugins de rating wordpress. je suppose que c’est possible mais je n’ai pas trouvé dans ce forum une interrogation qui ressemble à mon problème.

    une piste ? Merci

    Répondre à ce message

  • 4
    SPEEP

    Ce plugin est excellent

    En revanche je rencontre un sérieux problème d’alignement sur la partie publique du site
    Je n’arrive pas à faire de jolis alignements

    Merci beaucoup pour votre aide

    • RastaPopoulos

      Ben les alignements c’est un problème de CSS.

      par exemple en donnant une taille fixe aux labels. Tu peux t’inspirer pour cela des styles dans l’espace privé, qui correspondent apparemment à ce que tu voudrais : label en display:block avec largeur fixe et float.

    • SPEEP

      Merci beaucoup pour la réponse c’est vraiment sympa, effectivement je galere sur la css
      j’ai suivi tes conseils mais je suis embeté par les cases à cocher.
      D’où ma deuxième question qui concerne la reduction des espaces entre les choix

      En tous cas le plugin est très bien fait, grande classe
      J’ai une troisième question qui concerne l’ajout de CSS pour chaque champ crée, je n’arrive pas à les reintegrer dans ma feuille de style.

      Merci encore, ca fait vraiement plaisir de voir que SPIP est toujours entouré d’une belle et efficace communuauté

      Ps : j’ai intégré le plugin dans Magusine et ca marche parfaitement (sauf mes soucis de CSS) mais cela n’a rien à voir avec le dev du plugin

    • RastaPopoulos

      Ben les boutons radios ou les cases sont dans des blocs « .choix ». Donc tu peux très bien définir spécifiquement les labels qui sont à l’intérieur : « .choix label ».

    • SPEEP

      Merci beaucoup,

      Grace à ton conseil je m’en suis nikel sorti, franchement c’est trop sympa

      Le plugin et ton aide c’est FORMIDABLE :)

    Répondre à ce message

  • 1
    PtitLouis

    Bonjour et merci pour ce très bon plugin. C’est vraiment complet, il ne manque quasi rien.

    Est ce que quelqu’un a un feedback sur le pré-remplissage des champs ?
    Je voudrai juste rappeler l’ID de l’article dans l’envoi du formulaire à partir duquel il est rempli. J’ai donc passé :

    #FORMULAIRE_FORMIDABLE{contact, #ARRAY{hidden_1, #ID_ARTICLE}}

    Et je pensais récupérer l’info dynamique de l’#ID_ARTICLE dans le champs masqué identifié hidden_1, mais non. La réponse est vide. Gasp ! J’obtiens : Champ caché Sans réponse

    J’utilise la dernière version SPIP avec les dernières versions de tous les plugins. Je bosse en local sur Wamp et les mails partent quand même et je stocke tout bien, tous les champs du formulaire dans la base de données, sauf mon id_article. Contextuellement, je suis bien dans un article avec son ID qui va bien. Je pense avoir tout essayé...

    Alors, allergique à Wamp ou j’ai pas tout compris ? On pourrait en savoir plus sur le préremplissage ? Merci d’avance !!!!

    • RastaPopoulos

      Ben non pourtant, tout à l’air d’être comme le dit la doc. Donc là comme ça, je vois pas où peut être le problème. URL ?

    Répondre à ce message

  • 4
    Azrak

    Bonjour à tous de nouveau,

    J’ai encore une question, je tente de masquer voir de supprimer le message suivant quand il y a une erreur dans le formulaire :
    « Il y a des erreurs dans les champs ci-dessous, veuillez vérifier votre envoi. »
    (je ne veux garder que les messages d’erreur liés au différent champs du formulaire.

    J’ai donc tenter de masquer ce message via le CSS : display : none ; ---> sans succès

    Savez-vous quelles lignes sont à mettre en commentaire dans le fichier PHP du formulaire pour masquer ce message.

    • RastaPopoulos

      Il faut garder ce message, c’est important pour l’accessibilité, notamment quand on a pas une vue d’ensemble du formulaire, par exemple pour les lecteurs d’écran.

      Mais tu peux évidement le cacher uniquement en CSS. Tu dis que tu fais « display:none » mais tu ne dis pas sur quel élément... Suffit de regarder la class du conteneur avec Firebug.

    • Azrak

      J’entends bien le sujet de l’accessibilité en l’occurrence mon formulaire ne comporte que 2 champs. donc pas de scrolling et de plus je conserve le message d’erreur lié au champs adresse mail.

      j’applique le display : none ; à la class reponse_formulaire reponse_formulaire_erreur

    • RastaPopoulos

      Euh ça ce sont deux classes qui sont sur le même élément.

      .formulaire_formidable .reponse_formulaire_erreur{
    display:none;
}
    • azrak

      Merci beaucoup, j’ai encore appris un truc

    Répondre à ce message

  • 3
    sirom

    bonjour,
    VIVEMENT le plugin fonctionnel sous Spip 3

    Cordialement,

    • RastaPopoulos

      Mais le plugin est fonctionnel sur SPIP 3 (branche « trunk » dans le SVN).

    • sirom

      Mouais... galère j’arrive pas a faire fonctionner SCPlugin sur mac

      J’attendrai que tu mettes une version en téchargement/install automatique dans spip 3
      car pour l’instant celle qui est proposée en DEV ne veut pas s’installer ( elle demande spip-bonux)
      Merci encore

    • sirom

      Bon ok , j’’ai finalement utilisé svnX pour télécharger les SVN.
      J’ai donc mis la main sur spip-bonux 3 .
      pour les autres plugins nécessaires au fonnctionnement de formidable ils s’installent tout simplement directement depuis l’interface de spip 3.
      Cà fonctionne !

      Cordialement,

    Répondre à ce message

  • 3
    sirom

    bonjour,
    le plugin est bien entendu formidable ;)
    sauf qu’avec le champ date, le datepicker ne s’affiche pas ( l’icone du calendrier est bien présente mais lorsqu’on clique desssus rien ne se passe) le plugin jquery UI est bien activé.
    Ai-je omis quelque-chose ?

    • RastaPopoulos

      Ben.... disons que... chez-moi-ça-marche. ©

      Donc quoi dire ? :)

    • sirom

      Pourtant j’utilise formidable sur une install « propre » de SPIP 2.1.12 [18732]
      je n’ai donc rien « traficoté ».
      Mystère....
      Merci pour ta réponse

    • sirom

      Bon ce matin çà marche, j’ai effacé le formulaire puis recrée un autre et çà fonctionne !

      merci

    Répondre à ce message

  • 5
    ManuDevil

    C’est dommage, j’ai une erreur SQL quand je tente de créer un formulaire. Apparemment, l’activation du plugin n’a pas créé la table correspondante dans la base de données...

    • RastaPopoulos

      Me semble-t-il, avant le champ pour commenter il y a un lien en gras « Les choses à faire avant de poster une question ». Non ? :)

    • ManuDevil

      Au temps pour moi. Je précise donc :

      -  SPIP 2.1.0 [15608]

      Les plugins :

      -  CFG 1.16.0
      -  Le couteau suisse 1.8.57
      -  Mediathèque 1.6.7
      -  Spip Bonux 2.3.0
      -  Thickbox v2 0.3

      Ce sont les plugins actifs actuellement. En raison du bug, j’ai désactivé les plugins nécessaire à Formidable, qui étaient ceux proposés dans cette même page.

    • RastaPopoulos

      Euh ben c’est l’exact contraire qu’il faut comme information : les versions des plugins dont il est question pour le bug, donc Formidable et ses dépendances.

    • ManuDevil

      Un petit dessin valant mieux qu’un grand discours, voilà donc une capture d’écran, avec toutes les infos de configuration des plugins.

      Merci de passer du temps sur mon cas.

    • RastaPopoulos

      Il faudrait voir la version SVN de Formidable surtout, puisqu’il ne crée pas les tables jusqu’au bout. Il faudrait le désinstaller proprement (plus les tables), le mettre à jour et voir si ça marche.

      Car par exemple ce commit http://zone.spip.org/trac/spip-zone/changeset/57654/_plugins_/formidable/branches/v0 corrigeait justement un problème de création de table à cause d’une coquille de ma part.

    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