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

812 discussions

  • 4
    julien

    Une erreur est survenue lors de l’envoi du courriel.

    Avec un formulaire qui s’enregistre bien en base, mais qui n’est pas envoyé par mail malgré la demande de traitement avec envoi par mail.

    SPIP3.1, hébergement OVH, service mail PHP ACTIF sur OVH...

    Pour tester : http://solidaires.org/-Nous-rejoindre-

    Y a-t-il des logs de formidable qq part ? Une piste d’investigation ?

    Merci de votre aide.
    Julien

    • julien

      Je relance sur ce sujet : l’erreur exacte affichée est celle-ci :

      Une erreur est survenue lors de l’envoi du courriel.

      Une idée pour voir ce qui se passe ? Des logs des envois de Formidable ?

      L’envoi de mail par php est bien en marche sur le serveur.

      Merci de votre aide et idées !

    • RastaPopoulos

      /tmp/logs/ comme tous les logs
      il ya des logs de Facteur quand il a des erreurs emails normalement.

    • julien

      CLÔTURE DE CE MESSAGE !

      J’ai tenté une ré-installation complète du plugin FACTEUR, et hop ça remarche... mystère du plugin facteur !

    • julien

      Je viens de voir la réponse. Merci RastaPopoulos.

    Répondre à ce message

  • ploufplouf

    Bonjour,

    Je souhaiterais faire parvenir le formulaire à des destinataires en bcc, soit en copie cachée, comment je peux faire ? J’ai lu que ce sont dans les définitions des entetes de l’email qu’il faut préciser le bcc mais je ne sait pas comment faire.
    Il serait peut-être bien d’ajouter un champ dans les traitements pour les copies cachées ?

    Merci par avance de votre aide

    Répondre à ce message

  • 3
    pgiron

    Bonjour,
    Deux questions :
    1) Je pense qu’il faut être administrateur complet pour créer un formulaire ? J’ai essayé avec quelqu’un qui n’était que restreint et pas moyen d’en créer un.
    2) D’autre part, il me semble que le message du formulaire arrive avec le nom du webmestre enregistré et non le nom et prénom de la personne : j’ai bien rempli « Courriel de l’envoyeur » avec le champ « Courriel » qui avait un contenu valide et il n’a pas été pris en compte (sauf erreur de ma part, bug dans le « Configurer les traitements » du formulaire ?)
    Cordialement

    Philippe G.

    • RastaPopoulos

      1) Je pense qu’il faut être administrateur complet pour créer un formulaire

      Oui c’est la configuration par défaut, tu peux toujours modifier cette autorisation en PHP. Celle par défaut est ici : http://zone.spip.org/trac/spip-zone/browser/_plugins_/formidable/trunk/formidable_autorisations.php#L18
      Il faut donc faire la même fonction sans le « dist ».

      La raison est que les formulaires sont globaux au site, il n’y a pas de notion « d’auteurs » pour un formulaire. Donc on ne peut pas gérer finement les droits comme pour un contenu éditorial : soit on peut éditer, soit pas. Ainsi, si l’édition est activée pour les rédacteurs, alors il faut savoir que TOUS les rédacteurs pourront éditer n’importe quel formulaire.

      Un sous-plugin pourrait ajouter une notion d’auteur aux formulaires mais ça ne sera pas dans ce plugin en tout cas.

      2) D’autre part, il me semble que le message du formulaire arrive avec le nom du webmestre enregistré et non le nom et prénom de la personne

      Non, il arrive avec l’email d’envoi configuré pour le site, car c’est la configuration qui permettra de passer le plus de serveur SMTP possible et de pas finir dans les spams. En revanche le nom utilisé est bien celui inscrit dans la config du traitement (sauf que Thunderbird par exemple affiche en priorité le nom de son carnet d’adresse par rapport à l’email, s’il le trouve). Quant au courriel de l’envoyeur, il est mis dans l’entête « Reply-To », donc quand on fait « Répondre », ça écrit bien à celui qui a rempli le formulaire.

    • Jislenn

      « Un sous-plugin pourrait ajouter une notion d’auteur aux formulaires mais ça ne sera pas dans ce plugin en tout cas. »
      Bonjour,
      Est-ce que le sous-plugin en question a vu le jour depuis. Je voudrais autoriser les rédacteurs et administrateurs restreints à éditer des formulaires.
      Merci d’avance.

    • RastaPopoulos

      Ça fait plusieurs années que c’est ajouté hein. :D
      cf la page de configuration du plugin

    Répondre à ce message

  • Anthony

    Bonjour,

    je ne crois pas avoir vu la réponse à mon problème dans tout le déroulé de questions.

    Y a-t-il un moyen de modifier l’url post-validation d’un formulaire, qui est du type :
    http://www.domaine.fr/page.html#formulaire_formidable-[id formualire]

    Merci !

    Répondre à ce message

  •  ???

    Bonjour,
    Merci pour ce plugin, j’ai fais un formulaire qui a une adresse email, mais la validation du formulaire passe meme si l’adresse email n’est bonne
    blablabla = passe pas, c’est normal puisque ya pas de @
    blablabla@yahoo = passe, ce qui n’est pas normal il manque un point
    Esct que il ya un moyen de corriger ca ??? merci pour votre aide

    Répondre à ce message

  • 7
    Alexandra

    Pour info, et parce que ca peut servir un jour, pour afficher le label des réponses dans les réponses d’un formulaires
    Il faut :
    Boucler sur la table spip_formulaire/ *input_1 ou votre valeur à vous

    <BOUCLE_spip_formulaires(FORMULAIRES)>
[<p>(#SAISIES|unserialize|saisie_chercher{input_1}|table_valeur{options/label})</p>]
</BOUCLE_spip_formulaires_reponses>

    Mettre la fonction crée par marcimat (un grand merci) dans mes_fonctions.php

    // Recupérer le label d'une saisie formidable
function trouver_ma_saisie($saisies, $champ) {
    include_spip('inc/saisies');
    if (!is_array($saisies)) {
        $saisies = unserialize($saisies);
    }
    if (!$saisies) {
        return false;
    }
    $saisie = saisie_chercher($saisies, $champ);
    return $saisie;
}

    Et pour les réponses, mais c’est déjà documenté

    <BOUCLE_spip_formulaires_reponses(FORMULAIRES_REPONSES_CHAMPS){id_formulaires_reponse}{nom=input_1}>
[<p>(#VALEUR)</p>]
</BOUCLE_spip_formulaires_reponses>
    • kent1

      Avant de recopier bêtement du code... le tester serait pas mal ?

      J’ai mis à jour le wiki...

    • François Movihardt

      Désolé, ça fonctionne, ... très bien même !
      Merci en tout cas !

    • Alexandra

      J’assume pleinement le « bêtement ». Mais au moins maintenant on sait comment faire. Merci Kent1 et Marcimat.

    • kent1

      J’ai également ajouté ce que souhaitait faire exactement alexandra, sans code php, juste avec SPIP et la boucle data sous le titre « Afficher les résultats d’un formulaire par question et non par réponse (grouper toutes les réponses d’une question ensemble) »

      Cela donne :

      <BOUCLE_formidable_id_form(FORMULAIRES){id_formulaire=#ENV{id}}>
<BOUCLE_saisies(DATA){source tableau,#SAISIES|unserialize}>
[(#SET{nom_saisie,[(#VALEUR|table_valeur{options/nom})]})]
<B_spip_formulaires_rep>
[<h3>
	(#VALEUR|table_valeur{options/label})
</h3>]
<div class="reponses_form reponse[(#GET{nom_saisie})]">
<BOUCLE_spip_formulaires_rep(FORMULAIRES_REPONSES) {id_formulaire} {!par id_formulaires_reponse} {pagination 10 [(#GET{nom_saisie})]}>
			<div>
				<h4>[Réponse N° (#ID_FORMULAIRES_REPONSE)][  - (#MAJ|affdate)]</h4>
				[(#VOIR_REPONSE{[(#GET{nom_saisie})], valeur_uniquement})]
			</div>
</BOUCLE_spip_formulaires_rep>
[[<p>Il y a au total #GRAND_TOTAL contributions, cette liste en affiche (#TOTAL_BOUCLE)</p>]
<div class="pagination">(#PAGINATION{page_precedent_suivant})</div>]
</div>
</B_spip_formulaires_rep>
</BOUCLE_saisies>
</BOUCLE_formidable_id_form>
    • RastaPopoulos

      Je vois pas l’intérêt du « trouver_ma_saisie » alors que saisies_chercher() fait déjà le bon truc, du moment qu’on lui donne bien un tableau de saisie à la base (mais à priori quand on l’utilise on sait d’où ça vient).

    • associate-it

      J’ai corrigé le bloc note https://contrib.spip.net/Balises-et-boucles-avec-Formidable parce qu’un simple copier-coller ne fonctionnait pas à cause de deux erreurs :

      -  Une erreur de syntaxe dans la boucle d’affichage du label (balise de fermeture qui n’a pas le même nom que la balise d’ouverture)
      -  Une erreur dans le nom de la fonction « saisies_chercher » (il manquait le « s » à « saisies ») dans la fonction « trouver_ma_saisie »

      Maintenant ca fonctionne comme attendu. Par contre, la fonction « saisies_chercher » fonctionne effectivement aussi bien : (#SAISIES|unserialize|saisies_chercherinput_1|table_valeuroptions/label).

      Je n’ai pas osé supprimer la fonction « trouver_ma_saisie » dans le bloc note, mais ajouté un paragraphe indiquant qu’on peut se passer de la fonction « trouver_ma_saisie ».

    Répondre à ce message

  • 2
    ploufplouf

    Bonjour,

    En utilisant les mails par défaut du plugin, mon champ de liste déroulante n’apparait pas.

    Il y a-t-il une manip à faire pour ce type de champ ?

    Merci

    • RastaPopoulos

      Je n’ai pas compris la question. Ça veut dire quoi « les mails par défaut du plugin » ? Quelle liste déroulante ?

    • ploufplouf

      en fait je parles des email de notification. Dans mon formulaire j’ai un champ avec une liste déroulante et le résultat n’apparait pas dans le mail reçu. Je n’ai pas touché au code du squelette donc le suivant :

      (#ENV*message_retour
      #VOIR_SAISIES#ENV*saisies, #ENV*valeurs

    Répondre à ce message

  • 2
    joz

    Bonjour,
    J’ai un problème avec un formulaire (sur un site qui contient d’autres formulaires fonctionnels) :
    à l’envoi du formulaire je reçois l’avertissement « Une erreur est survenue lors de la validation du courriel. »
    Les réponses sont quand même enregistré dans la bdd, mais le mail de confirmation n’est pas envoyé au remplisseur du formulaire.

    Qu’est-ce qui peut être la cause de ce problème ?

    Le formulaire problématique est basé sur la copie d’un formulaire qui fonctionne sans problème. Je pense que la configuration est bonne...

    Merci pour toute idées de debuggage
    joz

    • RastaPopoulos

      Peut-être dans les logs de Facteur (facteur.log) ou généraux (spip.log) ? Est-ce qu’il y a des détails sur une erreur d’envoi ? Et ça merde quelque soit l’email fournit par le visiteur (donc quelque soit l’email à qui est envoyé l’accusé) ?

    • joz

      Merci pour la réponse.
      Je vais chercher dans les logs (j’y pense jamais).
      Et je pense que ça merde avec toutes les adresses, mais je vais observer encore..
      ++
      j

    Répondre à ce message

  • Kingrise

    Bonjour,

    Je vois qu’une mise-à-jour datée du 16/03/2016 (rev. 96025) est proposée. Mais en téléchargement, elle est introuvable sur Contrib et introuvable sur la Zone de téléchargement ??...

    Merci à l’équipe de développement :-)

    Répondre à ce message

  • 3
    pgiron

    Bonjour,
    Je ne trouve aucun moyen de faire disparaître les réponses « supprimées » : aucun bouton, elles ne sont pas dan la corbeille... J’ai loupé quelque chose ?

    • RastaPopoulos

      Les formulaires à la poubelle et les réponses à la poubelle sont supprimés toutes les 24h, comme tous les trucs qui s’insèrent dans le pipeline « optimiser_base_disparus ».

      Mais si tu as le plugin Corbeille, celui-ci annihile complètement ce pipeline. Qui ne fait plus rien. La corbeille n’a aucun automatisme, c’est chaque objet (donc chaque plugin qui gère) qui soit implémenter une liste-formulaire dédié à la corbeille.

    • pgiron

      Ah d’accord, merci ! Et que me conseilles-tu alors ?

    • RastaPopoulos

      Bah ya pas 36 solutions, si tu veux garder Corbeille activé, faut forcément implémenter la corbeille pour les objets de Formidable (les deux tant qu’à faire).

    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