Module facilitant l'écriture de formulaires CVT en plusieurs étapes.

#FORMULAIRE_TRUC

Squelette : Chaque étape est representée par un squelette indépendant qui doit implémenter un formulaire autonome pour les saisies de l'étape n :

• formulaires/truc.html pour l'etape 1
• formulaires/truc_2.html pour l'etape 2
• formulaires/truc_n.html pour l'etape n

Si un squelette formulaires/truc_n.html manque pour l'étape n c'est formulaires/truc.html qui sera utilisé (charge à lui de gérer le cas de cette étape).

Charger : formulaires_truc_charger_dist() : passer '_etapes' => nombre total d'etapes de saisies (>1 !) indiquer toutes les valeurs à saisir sur toutes les pages comme si il s'agissait d'un formulaire unique

Vérifier : Le numero d'étape courante est disponible dans $x=_request('_etape'), si nécessaire _request() permet d'accéder aux saisies effectuées depuis l'étape 1, comme si les étapes 1 a $x avaient été saisies en une seule fois

• formulaires_truc_verifier_1_dist() : verifier les saisies de l'etape 1 uniquement
• formulaires_truc_verifier_2_dist() : verifier les saisies de l'etape 2
• formulaires_truc_verifier_n_dist() : verifier les saisies de l'etape n

Il est possible d'implémenter toutes les vérifications dans une fonction unique qui sera alors appelée avec en premier argument le numero de l'étape à vérifier formulaires_truc_verifier_etape_dist($etape,...) : vérifier les saisies de l'étape $etape uniquement.

À chaque étape x, les étapes 1 a x sont appelées en vérification pour vérifier l'absence de régression dans la validation (erreur, tentative de réinjection ...) en cas d'erreur, la saisie retourne à la première étape en erreur. en cas de succès, l'étape est incrémentée, sauf si c'est la dernière. Dans ce dernier cas on déclenche traiter().

Traiter : formulaires_truc_traiter_dist() : ne sera appelé que lorsque toutes les étapes auront été saisies sans erreur.

La fonction traiter peut donc traiter l'ensemble des saisies comme si il s'agissait d'un formulaire unique dans lequel toutes les données auraient été saisies en une fois.