Les points d’entrées de Forms&Tables

Le plugin F&T comprend un certain nombre de points d’entrées utiles pour modifier ou enrichir son comportement par défaut sans en modifier le code.

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 pipelineDescription
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 pipelineDescription
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 pipelineDescription
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 pipelineDescription
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 pipelineDescription
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 :

argumentrôlevaleur 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>

Discussion

Aucune discussion

Ajouter un commentaire

Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :

  • Désactiver tous les plugins que vous ne voulez pas tester afin de vous assurer que le bug vient bien du plugin X. Cela vous évitera d’écrire sur le forum d’une contribution qui n’est finalement pas en cause.
  • Cherchez et notez les numéros de version de tout ce qui est en place au moment du test :
    • version de SPIP, en bas de la partie privée
    • version du plugin testé et des éventuels plugins nécessités
    • version de PHP (exec=info en partie privée)
    • version de MySQL / SQLite
  • Si votre problème concerne la partie publique de votre site, donnez une URL où le bug est visible, pour que les gens puissent voir par eux-mêmes.
  • En cas de page blanche, merci d’activer l’affichage des erreurs, et d’indiquer ensuite l’erreur qui apparaît.

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.

Qui êtes-vous ?
[Se connecter]

Pour afficher votre trombine avec votre message, enregistrez-la d’abord sur gravatar.com (gratuit et indolore) et n’oubliez pas d’indiquer votre adresse e-mail ici.

Ajoutez votre commentaire ici

Ce champ accepte les raccourcis SPIP {{gras}} {italique} -*liste [texte->url] <quote> <code> et le code HTML <q> <del> <ins>. Pour créer des paragraphes, laissez simplement des lignes vides.

Ajouter un document

Suivre les commentaires : RSS 2.0 | Atom