Fichier ecrire/inc/cvt_multietapes.php

CVT Multi étapes

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.

Source

Proposer une amélioration

Liste des fonctions

array cvtmulti_formulaire_charger_etapes( $args , $valeurs )

Paramètres

  1. $args
  2. $valeurs

Retour

  • array

Package

Proposer une amélioration
array cvtmulti_formulaire_verifier_etapes( array $args , $erreurs )

Paramètres

  1. array $args
  2. $erreurs

Retour

  • array

Package

Proposer une amélioration
array cvtmulti_recuperer_post_precedents( string $form )

Paramètres

  1. string $form

Retour

  • array

Package

Proposer une amélioration
array cvtmulti_sauver_post( string $form , boolean $je_suis_poste , array & $valeurs )

Paramètres

  1. string $form
  2. boolean $je_suis_poste
  3. array & $valeurs

Retour

  • array

Package

Proposer une amélioration

Dépréciées

array cvtmulti_formulaire_charger( array $flux )

Paramètres

  1. array $flux

Retour

  • array

Package

Deprecated

  • : appel direct de cvtmulti_formulaire_charger_etapes par le core
Proposer une amélioration
array cvtmulti_formulaire_verifier( array $flux )

Paramètres

  1. array $flux

Retour

  • array

Package

Deprecated

  • : appel direct de cvtmulti_formulaire_verifier_etapes par le core
Proposer une amélioration