Formidable, le générateur de formulaires

Publié le : 23 janvier 2012 – Dernière modification le 19 mars 2024 – par Maïeul, RastaPopoulos – 3516 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

812 discussions

  • 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

  • 2
    noutalg

    bonjour,
    Je reviens sur ma question d’upload de fichiers. Est-il envisageable d’inclure dans le pluging formidable (je ne sais pas où) le plugins ’formulaire upload’ ? Je ne connais pas assez spip pour répondre à cela et je voudrais juste savoir si c’est une idée saugrenue ou pas.
    Car si on regarde juste le module que j’utilise pour ce message, il y a bien la fonction ’ajouter un document’ dans ce formulaire.

    • RastaPopoulos

      Ce n’est pas pareil. Là pour le commentaire c’est codé spécifiquement dans le formulaire de forum de SPIP, avec un comportement précis. Pour Formidable il s’agit de développer ça de manière générique, pas juste pour un formulaire précis, c’est un peu plus compliqué. Je dois faire ça fin février ou en mars normalement.

    • noutalg

      Je viens de comprendre que votre réponse concernait ma demande. Merçi, j’attendrai donc mars.
      bon week end

    Répondre à ce message

  • gerard

    bonjour,
    j’ai un probleme avec l’export des reponses, ca ne marche pas. Le lien utilise est le suivant :
    http://localhost/ecrire/?exec=formulaires_reponses&action=exporter_formulaires_reponses&arg=1&hash=475d462f782a97f24a9cffd8ad216e886761ba12
    Firefox me repond que le fichier source ne peut etre lu, et il cree un fichier vide (alors qu’il y a des reponses).
    Je n’ai aucune erreur dans les logs d’apache ni dans les logs de spip. Il y a un moyen de tracer ce qui se passe ?

    merci d’avance,

    Répondre à ce message

  • 1
    Azrak

    Bonjour à Tous,

    Déjà félicitation pour ce super plugin, qui est très pratique d’utilisation.

    J’ai 2 petites questions :

    Quand je valide l’envoi du formulaire, les informations saisies restent dans les champs de texte. Y a t’il une option ou une modification à opérer dans le fichier php pour que le formulaire soit remis à zéro une fois l’envoi effectué ?

    Peut on modifier via les CSS l’apparence du texte qui est affiché lors des erreurs de saisie et après l’envoie avec succès du formulaire ?

    Merci d’avance.

    • RastaPopoulos

      Y a t’il une option ou une modification à opérer dans le fichier php pour que le formulaire soit remis à zéro une fois l’envoi effectué ?

      C’est un bug je crois, déjà signalé mais jamais corrigé.

      Peut on modifier via les CSS l’apparence du texte qui est affiché lors des erreurs de saisie et après l’envoie avec succès du formulaire ?

      Ben c’est du HTML non ? Donc tout est stylable par CSS, comme n’importe quoi d’autre. :)

    Répondre à ce message

  • 1
    Pierroot

    Je ne suis pas du tout bon en programmation. Et je voudrai savoir si votre plugin pourrait me servir pour éditer un bulletin d’adhésion en ligne pour un site associatif. Merci de votre réponse.

    • RastaPopoulos

      Peut-être, ça dépend du besoin., Si c’est juste pour avoir la liste des gens qui veulent adhérer et recevoir ces demandes par mail et pourquoi pas les enregistrer en base, ça devrait suffire.

      Si c’est pour faire des traitements sur ces demandes (en faire ensuite d’autres choses que juste les lister en base comme l’enregistrement par défaut) alors il faudra forcément mettre la main à la pâte (ou trouver quelqu’un pour le faire).

    Répondre à ce message

  • 1
    noutalg

    bonjour,
    Merci d’abord pour ce plugin et je voudrais savoir s’il est possible d’intégrer dans un formulaire un champ ’mon document’ qui permettrait de faire un upload ?

    • RastaPopoulos

      Il n’y a pas encore de Saisies (puisque tous les types de champ viennent de ce plugin) de type « fichier ». Ça va normalement être en développement dans pas trop longtemps.

    Répondre à ce message

  • 1
    Dan

    Binjour
    j’ai créé mon 1er formulaire. tout baigne !
    mais comment fait on pour modifier l’aspect du formulaire car sur ma page c’est pas trop top ...
    merci pour votre aide

    Dan

    Répondre à ce message

  • 3
    Sylvano

    Bonjour à tous,

    Formidable, et on se sent pousser des ailes ! Seulement il faut bien se rendre à l’évidence, je ne vole pas. J’ai même plutôt du plomb dans le code. Je réfléchis depuis quelques jours à une manière de créer une appli de gestion de projet en pur spip. Je penche pour une base gribouille, mais selon toute évidence l’attribution des mots-clés n’est pour l’instant pas « crayonnable » : pas de mots-clés d’admin pour les utilisateurs = squelettes publics peu dynamiques... Ou alors je ne suis pas doué en hiérarchisation, mais je vais bien être obligé de créer des possibilités de classement croisé à certains endroits.

    J’ai donc envisagé de générer des formulaires publics adaptés aux besoins du projet avec Formidable. Ca parait carrément faisable, mais plutôt laborieux, notamment pour récupérer et trier des données associées à des articles pour ensuite gérer des conditions . Quelqu’un aurait-il une piste dans le genre élégante ?

    Merci !

    Sylvano

    • RastaPopoulos

      Ce n’est pas du tout l’objet de ce plugin et à mon avis c’est une mauvaise piste.

      La manière d’enregistrer les données en base est adaptée à du questionnaire/sondage, c’est tout. Il y a bien sûr moyen de développer autant de nouveaux traitements que l’on veut (doc à venir) mais même comme ça ce n’est pas du tout le but de ce plugin d’être utilisé pour créer des nouveaux objets éditoriaux.

      Pour ça il faut coder un minimum. Apprendre à créer de nouveaux objets éditoriaux, etc. (programmer.spip.org + lecture des plugins existants).

      Sinon Gribouille c’est un wiki, donc je vois pas le rapport avec de la gestion de projets... :)
      Ce qui s’en rapproche plus serait plutôt le plugin Tickets

    • Sylvano

      Sais pas trop en fait. On ne peut pas toujours se soumettre à « l’élégance du code », je poste un début de réponse.

      Pour tester si une ou plusieurs valeurs inscrites par un formulaire formidable sont associées à un id_article et créer des liens de navigations à partir de ces valeurs :

      Trop gros pour poster... bon... :
      code_exemple

      Avec un « match » à la place du « == » on devrait pouvoir tester plus de valeurs d’un coup, je n’ai pas encore cherché. J’ai commencé par les checkbox multiples parce que les autres types de champ devraient être plus faciles à traiter (les champs en oui/non, par exemple).

    • Sylvano

      Aïe, je n’avais pas vu ton message...
      Oui, effectivement ce n’est pas l’objet. Beaucoup d’effort pour une bidouille. Effectivement j’ai la doc sur le bureau. Et j’avale du code, mais laborieux est le mot de la semaine... Merci pour ta réponse et les infos !

      J’avais pensé à un truc dans le genre... Je ne suis pas un projet technique, mais plutôt multimédia, j’ai besoin d’un peu de convivialité. Je reconnais que je pars de loin.

    Répondre à ce message

  • 3
    DD

    Bonjour,

    Je voudrais restreindre le choix de la rubrique au secteur 77 (option sélecteur de rubriques)
    j’ai donc mis :
    #FORMULAIRE_FORMIDABLE{1,#ARRAY{@selecteur_rubrique_1@,77}}

    dans mon squelette mais cela ne fonctionne pas (j’ai sans doute mal compris le tuto)

    Y-a-t-il une autre solution (à part mettre le nom des rubriques en dur dans un menu déroulant) ?

    merci

    Répondre à ce message

  • 1
    EWaldt

    C’est un putin de taf, bravo à vous et c’est 100 fois mieux que form&table !!!

    J’ai un fieldset qui affiche h3 « legend » ça doit surement être une class. je la modifierai bien moi même mais je suis incapable de trouver dans les fichiers du plugin ou peu bien ce trouver cette ligne.

    Une idée ?

    Etienne

    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