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
Bonjour,
Sous spip 3.0 j’arrive à faire fonctionner ce plugin. J’aimerais cependant rediriger vers une autre page internet les gens aprés remplissage du formulaire. J’indique l’adresse de redirection mais cela ne fonctionne pas, je mets bien sur l’option « rediriger vers une nouvelle adresse ». Mes parametres ne sont jamais pris en compte.
Je voudrais connaître l’instruction à noter dans ma base de données dans le champ « après » pour que cela fonctionne.
Merci beaucoup
Ce n’est pas moi qui ai ajouté cette fonctionnalité, mais d’après le code je ne vois pas ce qui cloche pour l’instant. Qu’as tu mis dans le champ pour l’URL ?
Merci pour ta réponse.
En fait je me sers du formulaire pour gérer des inscriptions d’une course à pied, et les inscrits règlent par paypal.
http://aclacaune.fr/spip.php?article297
Certains ne comprennent pas qu’il faut valider le formulaire puis cliquer sur payer ensuite.
Donc à l’issue du formulaire je voudrais les rediriger vers cette adresse
http://www.aclacaune.fr/paiement.html
Lorsque j’indique cette adresse dans la config du formulaire tout semble bien fonctionner, mais les modifs ne sont pas prises en compte.
J’ai rentré l’URL dans ma base, mais je voudrais savoir si je dois mettre quelque chose dans le champs « après ». (voir image jointe).
Si je comprends bien, ce n’est pas ton formulaire créé qui ne marche pas, mais le formulaire de configuration du formulaire qui n’enregistre pas la config voulue ? C’est ce formulaire là qu’il faudrait corriger. Pour savoir quoi mettre dans ta base, il faut regarder les clés de la liste déroulante proposé dans ce form de config : à priori faut mettre « redirige ».
Mais ce n’est pas normal de ne rien y avoir, normalement ya une des 4 valeurs proposés dans la config, vu qu’il n’y a pas la possibilité de ne rien mettre.
Purée merci, le fait de mettre redirige, me « redirige » sur ma page
MERCI !!!!!
Répondre à ce message
le plugin fonctionne très bien sous spip 3. J’aurai aimé cependant avoir la possibilité de créer un champs de téléchargement de document. Est-ce possible ? Y a t-il une astuce pour faire cela ?
Merci aux développeurs de ce plugin.
Non ce type de champ n’existe pas pour l’instant, c’est dans la liste des choses à faire depuis le début, mais c’est un peu compliqué de le faire proprement.
Répondre à ce message
Bonjour,
Y-a-t-il moyen de lier ce plugin avec http://www.spip-contrib.net/Plugin-Catalogue (qui permet de créer des produits et des variantes par article) afin de pouvoir sélectionner dans le formulaire les produits puis les traiter avec le plugin transaction ?
Il me semblait aussi avoir vu que l’on pouvait maintenant faire des calculs sur les champs (genre je veux 2 paquets de nouilles donc le prix unitaire est multiplié par 2), mais je ne trouve plus où.. J’ai sûrement rêvé.
Merci dd
Répondre à ce message
Bonjour,
Je dois faire un site avec une centaine de formulaires, qui se finissent tous par la même choses (nom, prénom, adresse, tel etc...)
Est-il possible de faire un formulaire (ou groupe de champs) que j’incluerai dans chacun de mes formulaires. Et si ensuite je veux rajouter sur tous mes formulaires un nouveau champ, le rajouter a un seul endroit au lieu de modifier mes 100 formulaires ?
Ça revient a faire de la mutualisation de formulaire.
Merci de votre aide
Cela n’existe pas pour l’instant dans ce plugin. Faudrait pouvoir enregistrer des groupes de champs (avec le même constructeur, mais qui n’auraient aucun traitement, ça enregistrerait juste les champs) et pouvoir les appeler dans un vrai formulaire. Une idée à noter... ou alors ça pourrait faire l’objet d’un sous-plugin qui ajouterait cette fonctionnalité, car elle ne doit pas être utile très souvent donc ça éviterait de compliqué l’interface pour la majorité des gens.
Merci pour ta réponse
Effectivement un sous-plugins serait parfait !
Répondre à ce message
Via google traduction (de l’Argentine)
Salut à tous,
Au premier coup d’œil le plugin semble excellente, et j’ai construit sous la forme dans la partie privée, maintenant, je veux qu’il soit utilisé par les utilisateurs du site, avant d’utiliser le plugin « Form & Table » en utilisant l’étiquette - [(# MODELE forme id_form = 1 {})] - Que dois-je utiliser le label pour la forme pour voir ce que les utilisateurs et l’utilisation potentielle dans un squelette ? J’utilise la version 3.0.1 de SPIP. Comment puis-je également demander à un utilisateur de télécharger des images (jpg, png, gif, etc) de fomulario PAR ?
Merci beaucoup, Gabriel
Répondre à ce message
Bonjour
Ancien utilisateur de Form&Table, j’utilise désormais FORMIDABLE avec plaisir.
Je fais une proposition d’évolution pour le PLUGIN :
L’idée est d’afficher une image (en vignette cliquable ou pas) attachée à chaque champs. Cela permet de proposer des formulaires avec des explications tout en image.
2 possibilités :
- soit on ajoute un champs « ID du document » pour indiquer un n° de document image qui aura été téléchargé ailleurs (article ou rubrique).
- soit on donne la possibilité d’ajouter un modèle dans le label :
si bien sûr le standard HTML autorise l’insertion de à l’intérieur d’un ?
Je peux me rendre dispo pour faire évoluer le plugin, si l’auteur est d’accord.
Que pense l’auteur de tout cela ?
Répondre à ce message
Bonjour à tous, et merci à RastaPopoulos pour cet excellent plugin !!
Je suis en train de tester en localhost avec un petit formulaire contenant juste un champ courriel.
Quand j’arrive à l’étape de configuration des traitements, je n’ai pas la possibilité de les configurer car rien ne s’affiche (à part les labels). Ci-joint une capture d’écran.
Une idée ?
Aucune idée, tout marche chez moi en 2.1 et en 3.0. Tout est à jour ?
J’ai testé chez mon hébergeur (le site est strictement identique à celui que j’ai en local), et là aucun problème. Je pense donc que ça vient du fait qu’en local je n’ai pas configuré de serveur de mail.
Répondre à ce message
Super plugin, je crois que c’est exactement ce que je cherchais.
En fait, je souhaite m’en servie à la place de « publication ouverte ». Comment faire donc, pour que les formulaires soient automatiquement publiés dans une rubrique sur la page publique ?
Y’a t’il une boucle à intégrer ?
Je ne sais pas si c’est vraiment le meilleur choix. Enfin en bidouillant peut-être, mais à la base, en tout cas dans ce qu’il fournit par défaut, ce plugin sert à faire des téléformulaires, pour recueillir des informations, et non pas pour publier du contenu.
aie ! Visiblement, le plugin publication ouverte n’a pas été développé depuis spip 2.0... je pensais que cela pouvait être une bonne alternative... Merci pour ta réponse, en tous cas.
Répondre à ce message
Je suis sur spip 3.0.1. Suis entrain de faire un site qui selon la page ou l’on se trouve on va trouver toujours le même formulaire mais adressé à des emails différents.
Ainsi sur la rubrique 1, le formulaire ira chez une personne, sur la page 2 le même formulaire sera envoyé à une personne en charge de cette section.
Je pensais créer simplement plusieurs mot clés correspondants à chaque personne de contact qui appelleraient autant de formulaires. Je copierai ainsi le formulaire d’origine pour chaque personne.
C’est la bonne façon de faire ? Car je vois dans le chapitre « Pré-remplir dynamiquement les champs d’un formulaire depuis un squelette » qu’il y a la possibilité d’intéragir avec le squelette. me demandais ainsi si le champs que l’on pourrait changer dynamiquement soit le mail chez qui le formulaire est expédié.
Si cest possible ça éviterai de créer 10 formulaires. Merci
Répondre à ce message
Bonjour,
j’utilise la version 1.1.1 du plugin avec SPiP 3.0.1 et j’ai un petit soucis dans l’interface privée. Les puces des statuts s’affichent les unes à côté des autres (les 3 puces) et le clic sur l’une d’elle ne permet pas de modifier le statut.
J’ai installé le plugin sur 2 sites pour voir si j’arrivais à reproduire l’erreur, et j’ai bien le même problème sur les 2 sites.
merci
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 : |