Server : Apache System : Linux webd348.cluster026.gra.hosting.ovh.net 5.15.148-ovh-vps-grsec-zfs-classid #1 SMP Thu Feb 8 09:41:04 UTC 2024 x86_64 User : hednacluml ( 122243) PHP Version : 8.3.9 Disable Function : _dyuweyrj4,_dyuweyrj4r,dl Directory : /home/hednacluml/universe/ecrire/inc/ |
<?php /***************************************************************************\ * SPIP, Système de publication pour l'internet * * * * Copyright © avec tendresse depuis 2001 * * Arnaud Martin, Antoine Pitrou, Philippe Rivière, Emmanuel Saint-James * * * * Ce programme est un logiciel libre distribué sous licence GNU/GPL. * \***************************************************************************/ /** * 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. */ if (!defined('_ECRIRE_INC_VERSION')) { return; } /** * Reinjecter dans _request() les valeurs postees * dans les etapes precedentes * * @param string $form * @return array|false */ function cvtmulti_recuperer_post_precedents($form) { include_spip('inc/filtres'); if ( $form and $c = _request('cvtm_prev_post') and $c = decoder_contexte_ajax($c, $form) ) { #var_dump($c); # reinjecter dans la bonne variable pour permettre de retrouver # toutes les saisies dans un seul tableau if ($_SERVER['REQUEST_METHOD'] == 'POST') { $store = &$_POST; } else { $store = &$_GET; } foreach ($c as $k => $v) { // on ecrase pas si saisi a nouveau ! if (!isset($store[$k])) { $_REQUEST[$k] = $store[$k] = $v; } // mais si tableau des deux cotes, on merge avec priorite a la derniere saisie elseif ( is_array($store[$k]) and is_array($v) and $z = array_keys($v) and !is_numeric(reset($z)) and $z = array_keys($store[$k]) and !is_numeric(reset($z)) ) { $_REQUEST[$k] = $store[$k] = array_merge($v, $store[$k]); } } // vider pour eviter un second appel a verifier_n // en cas de double implementation (unipotence) set_request('cvtm_prev_post'); return [$c['_etape'], $c['_etapes']]; } return false; } /** * Sauvegarder les valeurs postees dans une variable encodee * pour les recuperer a la prochaine etape * * @param string $form * @param bool $je_suis_poste * @param array $valeurs * @return array */ function cvtmulti_sauver_post($form, $je_suis_poste, &$valeurs) { if (!isset($valeurs['_cvtm_prev_post'])) { $post = ['_etape' => $valeurs['_etape'], '_etapes' => $valeurs['_etapes']]; foreach (array_keys($valeurs) as $champ) { if (substr($champ, 0, 1) !== '_') { if ($je_suis_poste || (isset($valeurs['_forcer_request']) && $valeurs['_forcer_request'])) { if (($v = _request($champ)) !== null) { $post[$champ] = $v; } } } } include_spip('inc/filtres'); $c = encoder_contexte_ajax($post, $form); if (!isset($valeurs['_hidden'])) { $valeurs['_hidden'] = ''; } $valeurs['_hidden'] .= "<input type='hidden' name='cvtm_prev_post' value='$c' />"; // marquer comme fait, pour eviter double encodage (unipotence) $valeurs['_cvtm_prev_post'] = true; } return $valeurs; } /** * Reperer une demande de formulaire CVT multi page * et la reformater * * @deprecated 3.2 * @see cvtmulti_formulaire_charger_etapes() * @param array $flux * @return array */ function cvtmulti_formulaire_charger($flux) { trigger_deprecation('spip', '3.2', 'Using "%s" is deprecated, use "%s" instead', __FUNCTION__, 'cvtmulti_formulaire_charger_etapes'); if ( is_array($flux['data']) and isset($flux['data']['_etapes']) ) { $flux['data'] = cvtmulti_formulaire_charger_etapes($flux['args'], $flux['data']); } return $flux; } /** * Charger une etape du cvt multi * @param $args * @param $valeurs * @return array */ function cvtmulti_formulaire_charger_etapes($args, $valeurs) { if (!isset($valeurs['_etape'])) { $form = $args['form']; $je_suis_poste = $args['je_suis_poste']; $nb_etapes = $valeurs['_etapes']; $etape = _request('_etape'); $etape = min(max($etape, 1), $nb_etapes); set_request('_etape', $etape); $valeurs['_etape'] = $etape; // sauver les posts de cette etape pour les avoir a la prochaine etape $valeurs = cvtmulti_sauver_post($form, $je_suis_poste, $valeurs); } return $valeurs; } /** * Verifier les etapes de saisie * * @deprecated 3.2 * @see cvtmulti_formulaire_verifier_etapes() * @param array $flux * @return array */ function cvtmulti_formulaire_verifier($flux) { trigger_deprecation('spip', '3.2', 'Using "%s" is deprecated, use "%s" instead', __FUNCTION__, 'cvtmulti_formulaire_verifier_etapes'); $flux['data'] = cvtmulti_formulaire_verifier_etapes($flux['args'], $flux['data']); return $flux; } /** * Verifier les etapes de saisie * * @param array $args * @param $erreurs * @return array */ function cvtmulti_formulaire_verifier_etapes($args, $erreurs) { #var_dump('Pipe verifier'); if ( $form = $args['form'] and ($e = cvtmulti_recuperer_post_precedents($form)) !== false ) { // recuperer l'etape saisie et le nombre d'etapes total [$etape, $etapes] = $e; $etape_demandee = intval(_request('aller_a_etape')); // possibilite de poster un entier dans aller_a_etape $args['etape_saisie'] = $etape; $args['etapes'] = $etapes; // lancer les verifs pour chaque etape deja saisie de 1 a $etape $erreurs_etapes = []; $derniere_etape_ok = 0; $e = 0; while ($e < max($etape, $etape_demandee - 1) and $e < $etapes) { $e++; $erreurs_etapes[$e] = []; if ($verifier = charger_fonction("verifier_$e", "formulaires/$form/", true)) { $erreurs_etapes[$e] = $verifier(...$args['args']); } elseif ($verifier = charger_fonction('verifier_etape', "formulaires/$form/", true)) { $a = $args['args']; array_unshift($a, $e); $erreurs_etapes[$e] = $verifier(...$a); } // et on appelle un pipeline dedie aux etapes, plus easy $args['etape'] = $e; $args['etape_demandee'] = $etape_demandee; $erreurs_etapes[$e] = pipeline( 'formulaire_verifier_etape', [ 'args' => $args, 'data' => $erreurs_etapes[$e] ] ); if ($derniere_etape_ok == $e - 1 and !(is_countable($erreurs_etapes[$e]) ? count($erreurs_etapes[$e]) : 0)) { $derniere_etape_ok = $e; } // possibilite de poster dans _retour_etape_x ou aller_a_etape if (!is_null(_request("_retour_etape_$e"))) { $etape_demandee = $e; } // Il se peut que les verifications ait décidé de faire sauter des étapes if ($aller_a_etape = intval(_request('aller_a_etape'))) { $etape_demandee = $aller_a_etape; // possibilite de poster un entier dans aller_a_etape } } // si la derniere etape OK etait la derniere // on renvoie le flux inchange et ca declenche traiter if ( $derniere_etape_ok == $etapes and (!$etape_demandee or $etape_demandee >= $etapes) ) { return $erreurs; } else { $etape = $derniere_etape_ok + 1; if ($etape_demandee > 0 and $etape_demandee < $etape) { $etape = $etape_demandee; } $etape = min($etape, $etapes); #var_dump("prochaine etape $etape"); // retourner les erreurs de l'etape ciblee $erreurs = $erreurs_etapes[$etape] ?? []; // Ne pas se tromper dans le texte du message d'erreur : la clé '_etapes' n'est pas une erreur ! if ($erreurs) { if (!isset($erreurs['message_erreur'])) { $erreurs['message_erreur'] = singulier_ou_pluriel(is_countable($erreurs) ? count($erreurs) : 0, 'avis_1_erreur_saisie', 'avis_nb_erreurs_saisie'); } } else { $erreurs['message_erreur'] = ''; } $erreurs['_etapes'] = "etape suivante $etape"; set_request('_etape', $etape); } } return $erreurs; } /** * Selectionner le bon fond en fonction de l'etape * L'etape 1 est sur le fond sans suffixe * Les autres etapes x sont sur le fond _x * * @param array $flux * @return array */ function cvtmulti_styliser($flux) { if ( strncmp($flux['args']['fond'], 'formulaires/', 12) == 0 and isset($flux['args']['contexte']['_etapes']) and isset($flux['args']['contexte']['_etape']) and ($e = $flux['args']['contexte']['_etape']) > 1 and $ext = $flux['args']['ext'] and $f = $flux['data'] and file_exists($f . "_$e.$ext") ) { $flux['data'] = $f . "_$e"; } return $flux; }