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é
812 discussions
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
Conflit avec Mediaspip ?
Je n’arrivais plus à faire fonctionner la lecture de m avec Mediaspip. J’ai posé la question. La réponse est une erreur javascript
Uncaught TypeError: Property '$' of object [object Object] is not a function saisies.js:8
J’ai désactivé Formidable et Mediaspip fonctionne à nouveau normalement.
J’imagine donc que cette erreur vient de Formidable, non ?
Un grand merci à vous...
Robert
Pas de réponse ?
Formidable bloque Mediaspip (avec erreur Javascript) ou bien ai-je commis une erreur quelque part ?
Merci
Répondre à ce message
Bonjour après une manip et réinstallation des plugins Formidable et Facteur j’obtiens ce message d’erreur :
Erreur SQL 1146
Je n’ai pas dans mes mes tables de spip_formulaires et tables associées à formidable. L’activation du plugin ne les crée pas non plus. Comment les recréer et décoincer la situation ? merci d’avance
Répondre à ce message
Bonjour,
J’ai des soucis de compréhension
1) Champ caché. Lorsqu’on affiche les réponse et que le « champ caché » renvoie au titre de l’article, j’ai des problèmes avec les accents, les tirets et autres caractères. Par exemple : « Trompe-l’ ;oeil  ; : et autres illusions d’ ;optique » pour « Trompe-l’oeil et autres illusions d’optique »
2) J’ai configuré pour que l’auteur puisse modifier sa saisie mais je n’arrive pas à le faire fonctionner.
Merci de vos aides...
Robert
Pour 1), je pense que c’est peut-être un bug de SPIP qui a été corrigé récemment sur les entités dans le formulaire.
Pour 2) je ne sais pas, chez-moi-ça-marche©. Pour modifier sa saisie il faut peut-être n’autoriser qu’une seule réponse par visiteur, sinon par défaut, c’est une nouvelle réponse qui sera créée.
1) Mais comment mettre à jour ?
Je suis en SPIP 3.0.11 [20757]
Et Formidable 1.51 [75321]
Merci
Robert
Répondre à ce message
Bonjour
Sur un spip V 3.0.11 avec version php 5.4.6 et plugin Formidable 1.3.7 je rencontre cette erreur qui s’affiche en haut de page après validation du message du formulaire : http://www.les-aubes.fr/?Le-couple-dans-tous-ses-etats&lang=fr
Strict Standards : Non-static method Facteur::html2text() should not be called statically in
/homez.11/lesaubes/www/__plugins/auto/formidable_1_0/__traiter/email.php on line 109
Je ne comprends pas cette erreur, mais je reçois quand même le contenu du formulaire dans ma boite mail
- Quel est le problème et quelle solution svp ?
merci d’avance pour votre aide
cordialement
JM
Version de PHP ? Facteur est bien à jour ?
Bonjour
PHP 5.4.6
Facteur : 2.4.5
config facteur : réglage spip, fonction mail php
Hello
Tu peux mettre à jour tes plugins dans 1H ? J’ai apriori corriger le problème.
Mais un autre retour confirmerais.
Bonjour Pierre
merci pour ton aide
mais j’ai cette erreur au moment de la mise à jour
Impossible d’activer le plugin ../plugins/auto/formidable/v1.5.1
Nécessite le plugin FACTEUR en version 3.0.3 minimum.
...et pas de possibilité de mettre à jour Facteur
Ah flute, il est pas en zip, je regarde ça rapidement.
Je viens de rajouter le facteur en zip.
Il sera la rapidement.
il est disponible ici http://bit.ly/17KK6O2
Merci Pierre
après essai, tout est OK
Répondre à ce message
Bonjour,
Je viens de faire la mise à jour à la version 1.5.1 et là, problème !
Le plugin indique qu’il lui faut Facteur en version 3.0.3 pour être activé... lequel n’existe pas !
Que faire ?
>Y a-t’il la possibilité de retrouver la version 1.4.1 de Formidable.
Merci d’avance.
Alain S.
Salut
Si le zip est fait ici http://files.spip.org/spip-zone/facteur-3.0.zip
Il sera dans svp ce soir.
Répondre à ce message
Bonsoir
Sur un site en php 5.4 j’ai ceci :
Strict Standards : Non-static method Facteur::html2text() should not be called statically in /home/ffffffff/public_html/fffff/plugins/formidable/traiter/email.php on line 109
Strict Standards : Non-static method Facteur::html2text() should not be called statically in /home/ffffffff/public_html/fffffff/plugins/formidable/traiter/email.php on line 171
Une idée de comment corrigé ?
Faut utiliser la nouvelle fonction « facteur_mail_html2text » qui n’est pas fans la classe Facteur mais dans le fichier « facteur_fonctions.php » (donc faire un include_spip avant). Et bien sûr modifier le « necessite » de Facteur dans le XML de Formidable, pour mettre le numéro de la dernière version, afin d’être sûr d’avoir cette fonction.
Pas le code sous la main pour le faire là, donc quand j’aurais le temps, ou toi fais le si tu peux.
Donc il faut
<necessite nom="facteur" compatibilite="[3.0.3;[" ></necessite>
au lieu de 1.5.3Et remplacer
$texte = Facteur::html2text($html);
par$texte = Facteur::mail_html2text($html);
?Et au lieu de
include_spip('classes/facteur');
faut mettre facteur_fonctions ?Je peux le faire lundi par contre.
Non c’est PAS une méthode de la classe justement, c’est une fonction normale toute seule. Et il ne faut pas remplacer l’include mais en ajouter un, car la classe on l’utilise aussi je crois (mais si ce n’est pas le cas, on peut effectivement enlever l’include de la classe).
Hello
Commit http://zone.spip.org/trac/spip-zone/changeset/75321 pour corriger.
Répondre à ce message
Bonjour,
SPIP 2.1.23 [20601] Formidable 0.6.7 [66723]
Souci d’affichage lors de la configuration de champ « sélection d’article », « sélection de rubrique » et « sélection d’article ou de rubrique » (sous Chrome + Firefox). Voir la copie d’écran.
Répondre à ce message
Bonjour,
La réponse existe sans soute, je n’ai pas su la trouver.
Spip 2.1.23 Formidable 0.6.7
Je créé mon formulaire sans problèmes. Je cherche à configure les traitements et j’indique comme table destinataire
prospects_afest
et complète les autres champs de la partie « Enregistrement dans une table utilisateur ».Lorsque ensuite l’on remplit le formulaire dans l’espace plubique on a ce message d’erreur :
Erreur : l'insertion dans la table (prospects_afest) ne se fait pas bien.Table 'afestor_afest.prospects_afest' doesn't exist
Donc il faut indiquer une table déjà existante ou en créer une nouvelle, le plugin ne le faisant pas ?
D’autre part je ne comprends pas bien la différence qu’il y a entre
La sauvegarde est faite dans une table utilisateur, sans alimenter la table de formidable
en entête et la même chose dans la partie Simple Table Utilisateur ?En réfléchissant (enfin !) un peu j’ai compris la différence de ma question 2. Ce sont les titres des différentes rubriques du formulaire.
Ces deux questions ne concerne pas Formidable mais FormiTable, un sous-plugin qui rajoute le traitement dont tu parles. Et que je ne connais pas du tout. La doc est uniquement sur une page wiki pour l’instant : FormiTable (developpement arrêté)
Merci.
Je n’avais pas percuté qu’il s’agissait d’un sous-plugin de Formidable. Désolé pour le bruit.
Répondre à ce message
Bonjour,
Est-il envisageable de réaliser des opérations mathématiques simples sur des champs de ces formulaires ? Par exemple, pour un bon de commande : 3 pommes à 2 Euro la pièce = 6 Euro, + TVA sur le total. Si oui, cela est-il réalisable par quelqu’un ne maitrisant pas php ou JavaScript ? Si quelqu’un a déjà réalisé cela, je serais heureux d’avoir un retour d’expérience… Oui, je suis optimiste, mais c’est comme cela qu’on avance ;-)
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 : |