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
).
Nom de l’option | Fonction | Type |
---|---|---|
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 destinatairesformulaire_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)
Discussions par date d’activité
811 discussions
SPIP 3.0.11
Après avoir créer un premier formulaire, j’ai un message d’erreur dans :
espace privé/article Fatal error : Call to undefined function mailcrypt_email_dist
J’ai jeté le formulaire, le message d’erreur est disparu.
Que faire ou comment faire ?
Merci
que contenait le formulaire ?
Euh « mailcrypt » ça vient soit du plugin Mailcrypt soit du couteau suisse. Donc aucun rapport avec ce plugin.
Rappelons une XXXe fois que pour tester un plugin, il faut désactiver absolument tout ce qui n’est pas obligatoire pour le faire tourner. Si ça marche on réactive petit à petit pour voir d’où vient le bug ou le conflit.
Résolu
C’est Mailcrypt qui causait problème. Merci
Répondre à ce message
Salut,
Le nom du site enregistré dans la configuration de mon site comporte un accent (é) - En indiquant le nom du site dans le champ « Nom de l’envoyeur » au moment de la configuration des traitements et pour l’envoi des mails, je remarque que l’accentuation produit une aberration typographique dans les mails au niveau du nom de l’envoyeur (De), le (é) ne passe pas. J’aimerais savoir comment remédier à cela ?
Merci d’avance ;)
Un problème d’encodage ? Ça produit quoi dans le mail ?
Salut,
Le
é
me donne ceci :é
J’ai testé avec les caractères spéciaux et entités HTML relatifs au caractère souhaité mais ça ne passe pas non plus... des idées ? Merci pour ton expertise :)
Ouais donc c’est un problème d’encodage utf-8/iso-trucmuche, apparemment. Ça fait ça dans n’importe quel client mail ? En local et webmail ? Et le site est configuré avec quel encodage (si c’est un récent avec une install neuve, en utf-8 à priori) ?
Répondre à ce message
Essais de saisies de formulaires
Petit jeu.
Dans « Configurer le formulaire » -> « Afficher ensuite » quand je coche :
1) « Le formulaire à nouveau », j’obtiens après avoir rempli le formulaire et valider : « formulaire » en gros vert et gras + le formulaire avec ce que je viens de saisir.
2) « Les valeurs saisies », j’obtiens : « valeurs » en gros vert et gras + mes réponses (avec les erreurs (code HTML) sur accents, apostrophes et espaces insécables.
3) « Les statistiques de réponses », j’obtiens :« stats » en gros vert et gras.
4) « Rien du tout », j’obtiens : « rien » en gros vert et gras.
5) « Rediriger vers une autre adresse » (sans spécifier d’adresse en dessous, j’obtiens : « redirige » en gros, vert et gras.
Bref aucun réglage de « propre »... Je suis le seul dans ce cas, apparemment, non ?
Robert
Ben clairement les chaînes de langue ne sont pas interprétés apparemment. Tu as les mêmes comportements avec TOUS les plugins non nécessaires de désactivés ? (seule méthode correcte pour tester)
Bonjour,
J’ai fait l’essai en désactivant tous les plugins sauf Verifier, Facteur, Formidable, Saisies, Bonux, Couteau-suisse, YAML.
J’ai surchargé la page article.html de la dist en article=1.html avec les formulaires.
J’ai un résultat équivalent en répondant, par exemple à la fiche du livre « D’art d’art ! (Volume 1) »... Voir image.
Je ne sais plus quoi faire...
Robert
Je ne sais pas si ça changera, mais tu as oublié de désactiver le couteau suisse.
À part ça toutes les valeurs que tu indiques dans le vert ce sont les valeurs brut de l’option « apres » du formulaire. Or à aucun moment ces valeurs ne sont affichés nulle part. Donc je sais pas si t’as une surcharge quelque part dans ton squelette ou dans un plugin mais on dirait qu’il y a un truc qui ne va pas dans ton installation. Ces valeurs sont utilisés à divers endroits pour faire des tests dessus et conditionner l’affichage de tel ou tel autre chose, mais à aucun moment on ne les affiche elles-mêmes, et encore moins dans le bloc « message_ok », il n’y a ça nulle part dans le code.
J’ai tout désactivé sauf Verifier, Facteur, Formidable, Saisies, Bonux, YAML (y compris couteau-suisse). Désactivé le dossier squelettes. Vider le cache. Surcharger article.html de la dist en html=1.html.
Le tout est en ligne. C’est pas beau...
http://malle-arts.org
Dans le dossier Livres... les formulaires sont accessibles... Voir dans « D’art d’art ! (Volume 1) »
Je ne sais plus quoi désactiver...
Robert
Déjà ya pas un truc bizarre ? T’as des accolades non interprétées on dirait.
Sinon j’ai validé un formulaire, et dans le cadre vert je n’ai absolument pas « valeurs » mais bien « Votre saisie a bien été enregistrée... ».
En revanche, l’une des valeurs réaffichée, le titre de l’article, a des entités HTML dedans. Sauf qu’elles ne sont pas bonnes, car le point-virgule de fin a un espace avant ! Donc forcément ça peut pas être interprété.
Je ne sais pas pourquoi ça fait ça. Il faudrait peut-être tester dans formulaires/formidable.html de mettre en bas à la place de
#VOIR_SAISIES{#ENV*{_saisies},#ENV}
plutôt#VOIR_SAISIES{#ENV*{_saisies},#ENV**|unserialize}
.À tester... mais ce code n’a pas bougé depuis très très longtemps, donc ça parait bizarre que personne n’ait déjà eu ce problème d’accents avant.
Accolades dues aux codes avec onglets du couteau suisse : corrigées...
Moi, j’ai toujours « valeurs » malgré vidage du cache et du dossier tmp. J’ai essayé sur autre navigateur (Chrome) même résultat "valeur apparaît.
Fait modif dans formidadable.html. Toujours les mêmes résultats...
Capture.
Robert
J’ai fait un nouvel essai en ne mettant qu’un seul forum dans le squelette article=1.html.
J’obtiens le même résultat.
Robert
http://zone.spip.org/trac/spip-zone/changeset/75994 devrait résoudre le pb. LE zip sera disponible peu après 16h, et via CVT après 18h.
comme il n’est pas très poli de ne pas prévenir les gens de l’enregistrement de leurs données, on corrige cela via http://zone.spip.org/trac/spip-zone/changeset/75995.
Super ! Génial ! Un grand merci... ça fonctionne...
Reste juste le problème avec les codes html.
Au lieu de « D’art d’art ! (Volume 1) »
Précision : "Titre Livre est un champ caché dans mon formulaire il me sert à réattribuer la réponse au livre concerné.
hum, je n’arrive pas à reproduire. Tu peux m’envoyer (par email) un export yaml de ton formulaire, que je vois concrètement sur quoi tu te base ?
C’est fait par email
c’est un bug de spip.
cf http://core.spip.org/issues/3059
En attendant passe
#TITRE*
et pas#TITRE
. Tu perd certes l’insécabilité ...Super !
ça marche, merci beaucoup. Deux dépannages en une journée alors que je suis planté depuis une semaine c’est inespéré.
Merci
Répondre à ce message
Bonjour à tous,
Débutant sur Spip, je tente de créer un nouveau formulaire. J’ai installé Fomidable.
Je crée et enregistre un nouveau formulaire mais quand je veux poser un contrôle (texte, case à cocher...) sur ce nouveau formulaire, j’ai un message d’erreur « Aucun squelette saisies/Ligne de texte n’est disponible... » squelette « ../plugins/saisies/saisies/_base.html »
Ma configuration actuelle est :
- Spip 3.0.11 sous PHP Version 5.1.3RC4-dev (hébergé chez free)
- Formidable1.7.0 - test
- Saisies1.34.2
- SPIP Bonux3.0.5
- Facteur3.0.4
- YAML1.5.1
Si quelqu’un à une idée, je suis preneur.
Bonne journée et merci d’avance
Possible que ce soit la version de PHP qui est obsolète. Ce plugin à besoin d’au moins la 5.2 il me semble (because nouvelles fonctions de manipulation de tableau dedans).
Hébergé par free ... donc pas facile à gérer.
Voire même impossible, je crois qu’ils ont soit 4.qqc OU 5.1, et c’est tout.
Répondre à ce message
Ce plugin est remarquable. Il fonctionne très bien. La finesse de la configuration est un vrai plaisir.
Seule remarque à faire à ce stade : la présentation dans l’espace privé, la manipulation et l’exportation des données récupérées par les formulaires me semble être un point faible.
Répondre à ce message
Bonjour,
Deux questions :
1) Dans la configuration de mon formulaire, j’ai coché, après validation « Les valeurs saisies ». Or j’ai un intitulé qui apparaît « valeurs » en vert... Comment indiquer un intitulé de mon choix.
2) Pa ailleurs la reprise du titre de l’article donne des erreurs sur les accents, apostrophes et ponctuations du titre de l’article. Comment corriger ?
Merci beaucoup
PJ : Capture écran d’une réponse.
Mmmh c’est pas moi qui ai codé cette partie là, mais c’est sûr que « valeurs » (en plus sans majuscule) c’est assez moche. Faudrait au moins que la chaîne par défaut soit mieux.
Pour les accents il doit manquer une fonction quelque part pour ne pas voir les entités HTML.
Merci bien pour cette réponse.
Mais avec mes petits bras et petits moyens, je fais quoi et comment ?
Merci par avance.
Robert
Re- bonjour,
Je suis vraiment très très ennuyé par ces erreurs et difficultés. D’autant que ce projet porte sur 100 tablettes numériques pour des enfants.
Je suis prêt à rémunérer quelqu’un s’il faut pour la perte de temps.
Merci
Robert
Ou au moins me dire où (dans quels fichiers) je peux chercher et quoi faire pour corriger...
Merci
je peux tenter de regarder demain ce qu’il en est. Quelle version de spip et de formidable ?
SPIP 3.0.11 [20757]
Formidable (v1.7.0) Rév. 75920
Merci
J’ai tout désactivé sauf Verifier, Facteur, Formidable, Saisies, Bonux, YAML (y compris couteau-suisse). Désactivé le dossier squelettes. Vider le cache. Surcharger article.html de la dist en html=1.html.
Le tout est en ligne. C’est pas beau...
http://malle-arts.org
Dans le dossier Livres... les formulaires sont accessibles... Voir dans « D’art d’art ! (Volume 1) »
Je ne sais plus quoi désactiver...
Robert
Répondre à ce message
Bonjour,
Formidable Formidable !
Un souhait toutefois : pouvoir inclure dans un formulaire un « Ajouter un document » (gif, jpg, png, pdf).
Ce serait formidable.
Cordialement et merci encore
Répondre à ce message
Dans la configuration des champs, est-il possible de rajouter une balise ou un modèle pour le label (titre qui sera affiché) ?
Quelque chose de dynamique car j’aimerai rajouter dans le formulaire une question sur le dernier article publié.
Par exemple :
Que pensez-vous de notre article « titre de l’article » dans la rubrique xxxx ?
Reponse :....
Merci pour les pistes.
Viva SPIP
Non ce n’est pas possible pour les labels.
Répondre à ce message
Bonjour,
je souhaiterais mettre plusieurs champs sur la même ligne. La liste des choix possible m’oblige à un choix par ligne... Voir exemple ci-joint
Ça c’est une opération graphique, à faire avec des règles de style CSS, et ce n’est donc pas l’objet de ce plugin qui se contente de générer un HTML à peu près propre.
Ce plugin ne gère pas, et ne gérera jamais, l’aspect visuel du site web. Ça c’est au thème du site de s’en occuper.
En CSS il faut cibler les blocs en question et appliquer un style du genre « display:inline » ou « display:inline-block ».
Répondre à ce message
Bonjour
Après avoir créé un formulaire, j’ai activé l’option dans Settings" l’option « create posts ». Dans l’onglet Post Types, Cela marche pour afficher les donnéesdans un article et dans un page mais je souhaiterais que les réponses soient affichées dans Table press, qui est présent aussi.
Pour résumer je souhaiterais qu’un internaute, après avoir rempli un formulaire de type fiche descriptive d’un objet, que tous les champs soient successivement rajoutés sur une page affichant un tableau Table Press ou un tableur du même genre. L’idée étant qu’à chaque fois qu’un formulaire est validé, cela remplisse une ligne de données sur le tableau....
Merci de vos lumières
VM
Es-tu sûr de parler du bon plugin ?
Oups c’est le bon plugin mais c’est sur Wordpress
Désolé
Je me suis embrouillé les pinceaux
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 :
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.
Suivre les commentaires : |