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>
Aucune discussion
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 : |