Edition du formulaire
3 pipelines permettent de modifier la phase d’édition des formulaires. Ils sont particulièrement utiles pour ajouter des types de champs complexes.
| Nom du pipeline | Description |
|---|---|
| forms_types_champs | appelé avec la liste des types de champs. Permet d’ajouter/modifier des types de champs |
| forms_bloc_edition_champ | appelé avec le contenu du bloc de saisie d’un champ. Permet la modification pour des types de champs supplémentaires. |
| forms_update_edition_champ | appelé lors de la mise à jour d’un champ, en edition du formulaire. Permet d’ajouter des proprietes aux champs |
A titre d’exemple, le plugin geoforms utilise ces pipelines pour ajouter un type de champ géolocalisé.
Visualisation du formulaire
Ces 3 pipelines sont appelés dans la phase d’affichage du formulaire.
| Nom du pipeline | Description |
|---|---|
| forms_label_details | appelé pour ajouter des explications complementaires sur certains types de champs. Utile pour la gestion de type de champs supplémentaire |
| forms_input_champs | appelé pour chaque champ au moment de générer le <input> de saisie |
| forms_ajoute_styles | pipeline pour ajouter des styles à la css (utile pour styler des champs supplémentaires) |
Valeurs du formulaire
2 pipelines pour intervenir sur les valeurs affichées dans le formulaire (pré-replissage par exemple) et le message de succès affiché après validation.
| Nom du pipeline | Description |
|---|---|
| forms_pre_remplit_formulaire | appelé avant affichage d’un formulaire, pour permettre un pré_remplissage de certains champs (ex email si le visiteur est identifié) |
| forms_message_complement_post_saisie | appelé pour permettre l’ajout d’un message complémentaire au basique ’votre réponse a été enregistrée’ |
Enregistrement de la saisie
3 pipelines permettent d’intervenir lors de la phase de validation de la saisie et de son enregistrement.
| Nom du pipeline | Description |
|---|---|
| forms_valide_conformite_champ | appelé au moment de la vérification de la saisie des champs. Permet de signaler des erreurs de saisie sur les types de champs supplémentaires |
| forms_pre_edition_donnee | appelé avec la liste des champs et leurs valeurs juste avant leur insertion/maj en base. Permet l’ajout éventuel de champs saisis et non détectés. |
| forms_post_edition_donnee | appelé avec la liste des champs et leurs valeurs juste apres insertion/maj en base |
Affichage des donnees
Ce pipeline est appelé pour calculer la valeur en clair des champs retournés par la balise #LESVALEURS
| Nom du pipeline | Description |
|---|---|
| forms_calcule_valeur_en_clair | appelé au moment de la transcription valeur en base => valeur affichée pour un champ donné. Permet de prendre en charge des formatages sur des types de champs supplementaires |
La balise #FORMS
Elle s’utilise dans une boucle FORMS ou FORMS_DONNEES :
- S'utilise dans une boucle FORMS, ou FORMS_DONNEES
- <BOUCLE_f(FORMS){id_form}>
- #FORMS
- </BOUCLE_f>
La balise #FORMS peut prendre 5 arguments optionnels :
| argument | rôle | valeur par défaut |
|---|---|---|
| class | nom du squelette utilise pour afficher les champs du formulaire. | vide ou ’forms_structure’ |
| script_validation | nom du script utilisé pour valider les réponses/envoyer le mail de confirmation | valide_form |
| message_confirm | chaine de langue utilisée pour générer le message d’avis d’envoi de mail de confirmation. Attention, cette chaine doit comprendre la variable @email@ qui sera remplacée par l’email de l’internaute | forms:avis_message_confirmation |
| reponse_enregistree | chaine de langue utilisée pour le message « reponseenregistree ». | forms:reponse_enregistree |
| forms_obligatoires | liste de formulaires obligatoires avant la saisie du formulaire en cours (?) | vide |
Exemple
- <BOUCLE_f(FORMS){id_form}>
- #FORMS{'',valide_form,message_reponse_perso}
- </BOUCLE_f>
Vos commentaires
# Le 30 août 2011 à 12:17, par Luberon Central
En réponse à : Les points d’entrées de Forms&Tables
Bonjour,
Est-il possible de récupérer l’id ou le nom du rédacteur dans le formulaire ?
Je m’explique, j’ai 2 formulaires :
- un pour s’inscrire : http://www.luberon-central.com/blog/spip.php?article1
Une fois que l’utilisateur s’est inscrit, je lui crée un compte rédacteur.
Cela lui donne accès à un nouveau menu dans la partie publique (je ne parle pas de la partie privée).
Si vous voulez tester, j’ai créé un compte rédacteur login : demo mot de passe : demoluberon .
Dans ce nouveau menu, le nouveau rédacteur a la possibilité de proposer de nouveaux produits http://www.luberon-central.com/blog/spip.php?article4 via un autre formulaire.
Est-il possible d’insérer quelque part dans le formulaire, l’id ou le nom du rédacteur enregistré afin d’être sûr que c’est bien lui qui remplit ce second formulaire (et pas un autre rédacteur enregistré) et de récupérer cette information dans les résultats du formulaire et dans le mail qui m’est envoyé automatiquement suite à la validation du formulaire ?
Mille merci.
Répondre à ce message
# Le 17 avril 2010 à 02:29, par Vincent François
En réponse à : Les points d’entrées de Forms&Tables
Bonjour,
Je cherche à surcharger le pipeline « forms_message_complement_post_saisie » pour insrer un bout de code javascript qui permettra à Google Analytics de noter les validations du formulaire.
Je n’y arrive pas. J’ai créé un petit plugin qui dit dans plugin.xml :
et dans le code PHP, un bout d’essai pour voir ce que ça donne de détourner
function suppforms_forms_message_complement_post_saisie($texte)
return "XXX" ;
Mais il ne se passe rien...
Comment puis-je faire ? Une idée, une piste ?
Merci d’avance pour toute réponse même incomplète.
# Le 17 décembre 2010 à 18:48, par stefdn
En réponse à : Les points d’entrées de Forms&Tables
Bonjour,
un peu tard pour répondre mais j’ai eu le même problème et en tâtonnant, j’ai réussi à utiliser ces pipelines. J’ai créé un petit plugin pour ça, qui contient 2 fichiers :
dans plugin.xml :
et dans test_pipeline.php :
il suffit ensuite d’installer et d’activer ce plugin, comme tous les autres
Répondre à ce message
# Le 27 mars 2010 à 16:53, par Metalrod11
En réponse à : Les points d’entrées de Forms&Tables
Salut,
Je cherche à faire apparaitre sur une carte Google les enregistrements d’une table.
Je suis sous SPIP 1.9.2 et j’ai installé et configuré « Forms&Tables 1.9.1 », « Google Map API » et « GIS ». L’ensemble fonctionne :
- j’ai inséré des cartes dans la partie publique où je fais apparaitre les articles « géoréférencés » dans la partie privée grâce à l’interface de « GIS »
- j’ai créé aussi un formulaire de contact qui fonctionne
Les trois plugins semblent donc ok.
J’ai voulu tester le plugin « Geoforms » pour voir s’il répondait à mes besoins (puisqu’il est cité dans cet article et dans celui sur le plugin « Google Map API »). J’ai eu du al à le trouver donc j’ai récupéré un par un les fichiers sur SPIP Zone. Après l’avoir activé, lorsque je souhaite le configurer grâce à l’cône apparue dans dans le menu « configuration » de SPIP, j’obtiens « Fichier inc/geomap_config introuvable ». Y a-t-il un endroit où trouver une version plus récente ? A-t-il été « remplacé » par un autre plugin (y en a-t-il un qui me permettrait de faire ce que je veux : « faire apparaitre sur une carte Google les enregistrements d’une table » ?
Merci à vous
Répondre à ce message
# Le 17 février 2010 à 22:05, par julie
En réponse à : Les points d’entrées de Forms&Tables
Salut,
je voudrais limiter le nombre de caractère du
textaera. Pour cela, je cherche à rajouter le code qui va bien dès la génération du formulaire. Mais où se trouve le fichier qui contient le bout de code qui génère le textaera du formulaire ?Merci d’avance.
Répondre à ce message
# Le 7 mars 2009 à 11:30, par Ritchie
En réponse à : calcul automatique d’un champ dans Forms&Tables
Super plugin ! installé sous spip 1.9.2.e
J’ai créé un formulaire où les visiteurs doivent entrer plusieurs champs numériques
( ex champA= 54, champB=68, champC=456) je souhaiterais qu’un dernier champ (D, donc) soit calculé automatiquement en fonction des données entrées en A,B et C tel que D=(C/A*B)/100 . Est-ce possible ? Je souhaiterais également que ce champ D s’arrête à 2 décimales. Merci pour l’aide.
Répondre à ce message