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

5 discussions

  • 7
    escurel

    Bonjour,
    Formidable 6.2.0, dans /formidable/6.2.0/formulaires/formidable.html
    ligne : 9
    [<h3 class="titrem"><span>(#ENV{_titre})</span></h3>]
    ne retourne rien.
    [<h3 class="titrem"><span>(#ENV{_formidable/titre})</span></h3>]
    retourne bien le titre du formulaire.
    cordialement

    • Maïeul

      Oui car c’est prévu non pour afficher le titre du formulaire (qui serait alors systématiquement affiché, ce qui est plus que discutable), mais un titre qu’on passe explicitement lors de l’appel via #FORMULAIRE_FORMIDABLE{21,#ARRAY{_titre,montitre}}

      mais c’est assez has been deja le h3, a mon avis ce genre de chose devrait être déporté a l’exterieur du squelettes formulaires/formidable car on ne peut pas prévoir à priori les balises et tags à utiliser.

    • escurel

      Bonjour Maïeul,
      pour un appel dans un article ?
      <formulaire|formidable|id=contact|[......?.......]=Nous écrire>
      j’ai essayé : _titre=, formidable/_titre=, titre=, en fait c’est pas récupérable dans l’environnement du formulaire.

      Pour le h3, c’est vrai que c’est problématique,
      j’ai dû surcharger formulaires/formidable.html dans /squelettes/ pour éviter des sauts de h1 à h3 dans mes articles avec la perte des futures améliorations.

      Autre remarques :
      — Pour les champs textarea, il y a une condition de validation « Nombre de caractères maximum » (sympa) et pas « Nombre de caractères minimum » :(
      — J’ai observé aussi l’impossibilité d’utiliser l’option /g (global) dans les regex pour valider un champ, C’est le plugin API vérifier qui chouine.
      Par exemple : /(http:\/\/)|(https:\/\/)/gmi
      Cordialement

    • RastaPopoulos

      Je ne saisis pas trop le principe de faire cet appel de titre dans un texte SPIP, vu qu’alors tu peux forcément mettre le bon titre avec le bon niveau H suivant où t’es juste devant l’appel au formulaire ({{{Mon titre}}} ou {{{**Montitre}}} avec le plugin Intertitre ou <hN> directement)

    • Maïeul

      Je rejoins Rastapopoulos sur sa remarque.

      PAr ailleurs pour tes 2 autres points, il vaudrait mieux ouvrir des tickets, respectivement dans les plugins saisies et les plugins verifier.

    • escurel

      Bonjour Maïeul,
      Dans un premier temps j’avais mis un intertitre comme alternative, puis finalement j’ai pas trouvé cela excellent. Lorsqu’il y a besoin de suspendre l’emploi du formulaire pour X raison (spam, erreur, modif, ...), l’intertitre reste affiché. Quand la suspension dure un certain temps il faut le supprimer et le ressaisir ensuite, puis avec le temps Il faut s’en souvenir de cette manip. Bref.
      Cordialement

    • escurel

      Bonjour Maïeul,
      Dans la configuration du plugin : /ecrire/ ?exec=configurer_formidable
      L’option : Les admins de rubriques peuvent également créer et modifier les formulaires, non cochée Créer et modifier c’est « niet », Voir c’est OK à partir du menu Édition.
      Pour simplifier la vie de l’administrateur restreint, je pensai pouvoir décharger le menu Édition du lien « Formulaires ». En fait c’est pas possible, la fonction concernée n’est pas _dist
      https://git.spip.net/spip-contrib-extensions/formidable/-/blob/master/formidable_pipelines.php?ref_type=heads#L461
      Cordialement

    • Maïeul

      Ouvre des tickets stp.

    Répondre à ce message

  • 1
    Kingrise

    Bonjour à toutes et tous,

    Je travaille sur un projet où j’ai besoin de créer une fonctionnalité de réservation de créneaux horaires avec le plugin Formidable pour SPIP. L’idée est de permettre aux utilisateurs·trices de choisir un créneau horaire parmi ceux proposés, et une fois ce créneau sélectionné, il devrait être désactivé pour les futur·e·s utilisateurs·trices, un peu comme un Doodle.

    Voici les spécifications de ce que je cherche à réaliser :

    Date de début et fin : Les utilisateurs·trices doivent pouvoir choisir un créneau entre une date de début et une date de fin.
    Intervalle de temps : Les créneaux doivent être définis avec un intervalle qui peut être en minutes, heures ou jours.
    Lecture des réponses : Le système doit lire toutes les réponses soumises via le formulaire pour activer ou désactiver les créneaux horaires en conséquence.
    Enregistrement des résultats : Chaque sélection de créneau doit être enregistrée pour éviter les doubles réservations.
    Création d’un plugin : Il est possible qu’un plugin complémentaire soit nécessaire pour gérer cette logique de réservation.
    Je suis à la recherche de conseils sur la manière de mettre en œuvre cette fonctionnalité, ou si quelqu’un·e a déjà travaillé sur quelque chose de similaire, je serais ravi de connaître votre approche.

    Merci beaucoup pour votre aide !

    • Kingrise

      Bonjour,

      J’ai enfin réussi à créer mon petit « doodle » personnalisé
      Premièrement, créer un formulaire à l’aide de formidable...
      Créer les informations pour le nom de l’utilisateur à l’aide d’un champ ligne de texte,
      Créer un champ case à cocher et entrer les créneaux
      Pour mon cas :
      Label = Vendredi 19 (comme j’insère le formulaire dans un événement, je ne dois pas préciser davantage la date)
      Liste des choix possibles

      choix1|19 h
choix2|20 h
choix3|21 h
choix4|22 h
choix5|23 h

      Je renseigne les autres éléments de mon formulaire (une autre case à cocher pour samedi et idem pour dimanche avec les créneaux nécessaires)

      Je créer ensuite un modèle que je nomme « lirecase.html » à placer dans le dossier /squelettes/modeles

      [(#CACHE{0})]
[(#SET{checked_values, #ARRAY})]

[(#SET{checked_values,#ARRAY})]
<BOUCLE_reponses(FORMULAIRES_REPONSES spip_formulaires_reponses_champs){id_formulaire=#ENV{id}}{nom LIKE %checkbox%}>
  [(#SET{checked_values, #GET{checked_values}|push{#VALEUR}})]
</BOUCLE_reponses>

<BOUCLE_lire(DATA){source table, #GET{checked_values}}>
[<style>(#VALEUR|choixcase)</style>]
</BOUCLE_lire>

      Je créer enfin une petite fonction php dans un fichier mes_fonctions.html à placer dans le dossier /squelettes pour modifier le css de ma page

      <?php
function choixcase($texte){
	$string1=".vingt-quatre-sept .saisie_checkbox .choix_".substr($texte,2,strlen($texte)-4)." input[type='checkbox']{display:none!important;}";
	$string2=".vingt-quatre-sept .saisie_checkbox .choix_".substr($texte,2,strlen($texte)-4)."::before{content:'☑';font-size:24px;height:24px;float:left;margin-left:7px;}";
	$texte=$string1."\r\n".$string2;
	return $texte;
}
?>

      Ensuite, je peux insérer mes modèles dans mon événement où id=le numéro de mon formulaire...

      <lirecase|id=9>
<formulaire|formidable|id=9>

      Les créneaux choisis par les utilisateurs apparaissent maintenant cochés dans ma page et un nouvel utilisateur ne peut plus les cocher.

    Répondre à ce message

  • 1
    Geraud

    Bonjour
    Depuis la version 6, j’ai une erreur lors de la soumission de formulaires qui contiennent des case à choix multiple.
    Impossible de le soumettre.
    Merci

    • Geraud

      Voici le message d’erreur
      Fatal error : Uncaught TypeError : strpos() : Argument #1 ($haystack) must be of type string, array given in /home/zzzz/www/plugins/auto/saisies/v5.4.1/inc/saisies_name.php:52 Stack trace : #0 /home/zzzzz/www/plugins/auto/saisies/v5.4.1/inc/saisies_name.php(52) : strpos(Array, ’/’) #1 /home/zzz/www/plugins/auto/saisies/v5.4.1/inc/saisies_request.php(124) : saisie_nom2name(Array) #2 /home/zzzz/www/plugins/auto/formidable/v6.1.0/formulaires/formidable.php(774) : saisies_set_request(Array, ’checkbox_1’) #3 /home/zzzz/www/plugins/auto/formidable/v6.1.0/formulaires/formidable.php(398) : formulaires_formidable_sanitizer(Array) #4 /home/zzzz/www/ecrire/public/aiguiller.php(288) : formulaires_formidable_traiter_dist(’4’) #5 /home/zzz/www/ecrire/index.php(70) : traiter_formulaires_dynamiques() #6 main thrown in /home/zzzzz/www/plugins/auto/saisies/v5.4.1/inc/saisies_name.php on line 52

    Répondre à ce message

  • pamillet

    bonjour
    voulant tester formidable pour gérer des pétitions (https://discuter.spip.net/t/comment-faire-une-petition-sous-spip/174904/13) je butte sur un pb d’install...

    j’ai le message plugin formidable installé, puis ensuite « MAJ 1.5.0 . » et ca en reste là...
    et je n’ai plus accès à la gestion des plugin...
     ??
    je peux supprimer les fichiers téléchargés ?

    Répondre à ce message

  • Helem

    Bonjour
    Avec Spip 4.2.10 et Formidable 6.0.0

    Je place un champ « ligne de texte », je lui attribue la propriété de « Champ obligatoire », et la vérification « Numéro de téléphone ».
    Cette vérification ne fonctionne pas vraiment bien :
    si des « lettres » sont saisies, la vérification indique bien que le n° n’est pas valide.
    idem, si je ne saisis qu’un seul chiffre.
    Mais, dès la saisie de deux chiffres, le n° de téléphone est considéré comme OK, et le formulaire est validable.
    Du coup, j’ai remplacé la vérification « Numéro de téléphone » par une regexp.

    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