www/plugins/auto/saisies/inc/saisies_manipuler.php

   1 <?php
   2
   3 // Sécurité
   4 if (!defined('_ECRIRE_INC_VERSION')) return;
   5
   6 /*
   7  * Supprimer une saisie dont on donne l'identifiant, le nom ou le chemin
   8  *
   9  * @param array $saisies Un tableau décriant les saisies
  10  * @param unknown_type $id_ou_nom_ou_chemin L'identifiant unique ou le nom de la saisie à supprimer ou son chemin sous forme d'une liste de clés
  11  * @return array Retourne le tableau modifié décrivant les saisies
  12  */
  13 function saisies_supprimer($saisies, $id_ou_nom_ou_chemin){
  14         // Si la saisie n'existe pas, on ne fait rien
  15         if ($chemin = saisies_chercher($saisies, $id_ou_nom_ou_chemin, true)){
  16                 // La position finale de la saisie
  17                 $position = array_pop($chemin);
  18
  19                 // On va chercher le parent par référence pour pouvoir le modifier
  20                 $parent =& $saisies;
  21                 foreach($chemin as $cle){
  22                         $parent =& $parent[$cle];
  23                 }
  24
  25                 // On supprime et réordonne
  26                 unset($parent[$position]);
  27                 $parent = array_values($parent);
  28         }
  29
  30         return $saisies;
  31 }
  32
  33 /*
  34  * Insère une saisie à une position donnée
  35  *
  36  * @param array $saisies Un tableau décrivant les saisies
  37  * @param array $saisie La saisie à insérer
  38  * @param array $chemin La position complète où insérer la saisie
  39  * @return array Retourne le tableau modifié des saisies
  40  */
  41 function saisies_inserer($saisies, $saisie, $chemin=array()){
  42         // On vérifie quand même que ce qu'on veut insérer est correct
  43         if ($saisie['saisie'] and $saisie['options']['nom']){
  44                 // ajouter un identifiant
  45                 $saisie = saisie_identifier($saisie);
  46
  47                 // Par défaut le parent c'est la racine
  48                 $parent =& $saisies;
  49                 // S'il n'y a pas de position, on va insérer à la fin du formulaire
  50                 if (!$chemin){
  51                         $position = count($parent);
  52                 }
  53                 elseif (is_array($chemin)){
  54                         $position = array_pop($chemin);
  55                         foreach ($chemin as $cle){
  56                                 // Si la clé est un conteneur de saisies "saisies" et qu'elle n'existe pas encore, on la crée
  57                                 if ($cle == 'saisies' and !isset($parent[$cle]))
  58                                         $parent[$cle] = array();
  59                                 $parent =& $parent[$cle];
  60                         }
  61                         // On vérifie maintenant que la position est cohérente avec le parent
  62                         if ($position < 0) $position = 0;
  63                         elseif ($position > count($parent)) $position = count($parent);
  64                 }
  65                 // Et enfin on insère
  66                 array_splice($parent, $position, 0, array($saisie));
  67         }
  68
  69         return $saisies;
  70 }
  71
  72 /*
  73  * Duplique une saisie (ou groupe de saisies)
  74  * en placant la copie à la suite de la saisie d'origine.
  75  * Modifie automatiquement les identifiants des saisies
  76  *
  77  * @param array $saisies Un tableau décrivant les saisies
  78  * @param unknown_type $id_ou_nom_ou_chemin L'identifiant unique ou le nom ou le chemin de la saisie a dupliquer
  79  * @return array Retourne le tableau modifié des saisies
  80  */
  81 function saisies_dupliquer($saisies, $id_ou_nom_ou_chemin){
  82         // On récupère le contenu de la saisie à déplacer
  83         $saisie = saisies_chercher($saisies, $id_ou_nom_ou_chemin);
  84         if ($saisie) {
  85                 list($clone) = saisies_transformer_noms_auto($saisies, array($saisie));
  86                 // insertion apres quoi ?
  87                 $chemin_validation = saisies_chercher($saisies, $id_ou_nom_ou_chemin, true);
  88                 // 1 de plus pour mettre APRES le champ trouve
  89                 $chemin_validation[count($chemin_validation)-1]++;
  90                 // On ajoute "copie" après le label du champs
  91                 $clone['options']['label'] .= ' '._T('saisies:construire_action_dupliquer_copie');
  92
  93                 // Création de nouveau identifiants pour le clone
  94                 $clone = saisie_identifier($clone, true);
  95
  96                 $saisies = saisies_inserer($saisies, $clone, $chemin_validation);
  97         }
  98
  99         return $saisies;
 100 }
 101
 102 /*
 103  * Déplace une saisie existante autre part
 104  *
 105  * @param array $saisies Un tableau décrivant les saisies
 106  * @param unknown_type $id_ou_nom_ou_chemin L'identifiant unique ou le nom ou le chemin de la saisie à déplacer
 107  * @param string $ou Le nom de la saisie devant laquelle on déplacera OU le nom d'un conteneur entre crochets [conteneur]
 108  * @return array Retourne le tableau modifié des saisies
 109  */
 110 function saisies_deplacer($saisies, $id_ou_nom_ou_chemin, $ou){
 111         // On récupère le contenu de la saisie à déplacer
 112         $saisie = saisies_chercher($saisies, $id_ou_nom_ou_chemin);
 113
 114         // Si on l'a bien trouvé
 115         if ($saisie){
 116                 // On cherche l'endroit où la déplacer
 117                 // Si $ou est vide, c'est à la fin de la racine
 118                 if (!$ou){
 119                         $saisies = saisies_supprimer($saisies, $id_ou_nom_ou_chemin);
 120                         $chemin = array(count($saisies));
 121                 }
 122                 // Si l'endroit est entre crochet, c'est un conteneur
 123                 elseif (preg_match('/^\[(@?[\w]*)\]$/', $ou, $match)){
 124                         $parent = $match[1];
 125                         // Si dans les crochets il n'y a rien, on met à la fin du formulaire
 126                         if (!$parent){
 127                                 $saisies = saisies_supprimer($saisies, $id_ou_nom_ou_chemin);
 128                                 $chemin = array(count($saisies));
 129                         }
 130                         // Sinon on vérifie que ce conteneur existe
 131                         elseif (saisies_chercher($saisies, $parent, true)){
 132                                 // S'il existe on supprime la saisie et on recherche la nouvelle position
 133                                 $saisies = saisies_supprimer($saisies, $id_ou_nom_ou_chemin);
 134                                 $parent = saisies_chercher($saisies, $parent, true);
 135                                 $chemin = array_merge($parent, array('saisies', 1000000));
 136                         }
 137                         else
 138                                 $chemin = false;
 139                 }
 140                 // Sinon ça sera devant un champ
 141                 else{
 142                         // On vérifie que le champ existe
 143                         if (saisies_chercher($saisies, $ou, true)){
 144                                 // S'il existe on supprime la saisie
 145                                 $saisies = saisies_supprimer($saisies, $id_ou_nom_ou_chemin);
 146                                 // Et on recherche la nouvelle position qui n'est plus forcément la même maintenant qu'on a supprimé une saisie
 147                                 $chemin = saisies_chercher($saisies, $ou, true);
 148                         }
 149                         else
 150                                 $chemin = false;
 151                 }
 152
 153                 // Si seulement on a bien trouvé un nouvel endroit où la placer, alors on déplace
 154                 if ($chemin)
 155                         $saisies = saisies_inserer($saisies, $saisie, $chemin);
 156         }
 157
 158         return $saisies;
 159 }
 160
 161 /*
 162  * Modifie une saisie
 163  *
 164  * @param array $saisies Un tableau décrivant les saisies
 165  * @param unknown_type $id_ou_nom_ou_chemin L'identifiant unique ou le nom ou le chemin de la saisie à modifier
 166  * @param array $modifs Le tableau des modifications à apporter à la saisie
 167  * @return Retourne le tableau décrivant les saisies, mais modifié
 168  */
 169 function saisies_modifier($saisies, $id_ou_nom_ou_chemin, $modifs){
 170         $chemin = saisies_chercher($saisies, $id_ou_nom_ou_chemin, true);
 171         $position = array_pop($chemin);
 172         $parent =& $saisies;
 173         foreach ($chemin as $cle){
 174                 $parent =& $parent[$cle];
 175         }
 176
 177         // On récupère le type, le nom s'il n'y est pas, et les enfants tels quels
 178         $modifs['saisie'] = $parent[$position]['saisie'];
 179         if (!isset($modifs['options']['nom'])) $modifs['options']['nom'] = $parent[$position]['options']['nom'];
 180         if (is_array($parent[$position]['saisies'])) $modifs['saisies'] = $parent[$position]['saisies'];
 181
 182         // Si une option 'nouveau_type_saisie' est donnee, c'est que l'on souhaite
 183         // peut être changer le type de saisie !
 184         if (isset($modifs['options']['nouveau_type_saisie']) and $type = $modifs['options']['nouveau_type_saisie']) {
 185                 $modifs['saisie'] = $type;
 186                 unset($modifs['options']['nouveau_type_saisie']);
 187         }
 188
 189         // On remplace tout
 190         $parent[$position] = $modifs;
 191
 192         // Cette méthode ne marche pas trop
 193         //$parent[$position] = array_replace_recursive($parent[$position], $modifs);
 194
 195         return $saisies;
 196 }
 197
 198 /*
 199  * Transforme tous les noms du formulaire avec un preg_replace
 200  *
 201  * @param array $saisies Un tableau décrivant les saisies
 202  * @param string $masque Ce que l'on doit chercher dans le nom
 203  * @param string $remplacement Ce par quoi on doit remplacer
 204  * @return array Retourne le tableau modifié des saisies
 205  */
 206 function saisies_transformer_noms($saisies, $masque, $remplacement){
 207         if (is_array($saisies)){
 208                 foreach ($saisies as $cle => $saisie){
 209                         $saisies[$cle]['options']['nom'] = preg_replace($masque, $remplacement, $saisie['options']['nom']);
 210                         if (is_array($saisie['saisies']))
 211                                 $saisies[$cle]['saisies'] = saisies_transformer_noms($saisie['saisies'], $masque, $remplacement);
 212                 }
 213         }
 214
 215         return $saisies;
 216 }
 217
 218 /*
 219  * Transforme les noms d'une liste de saisies pour qu'ils soient
 220  * uniques dans le formulaire donné.
 221  *
 222  * @param array $formulaire Le formulaire à analyser
 223  * @param array $saisies Un tableau décrivant les saisies.
 224  * @return array Retourne le tableau modifié des saisies
 225  */
 226 function saisies_transformer_noms_auto($formulaire, $saisies){
 227
 228         if (is_array($saisies)){
 229                 foreach ($saisies as $cle => $saisie){
 230                         $saisies[$cle]['options']['nom'] = saisies_generer_nom($formulaire, $saisie['saisie']);
 231                         // il faut prendre en compte dans $formulaire les saisies modifiees
 232                         // sinon on aurait potentiellement 2 champs successifs avec le meme nom.
 233                         // on n'ajoute pas les saisies dont les noms ne sont pas encore calculees.
 234                         $new = $saisies[$cle];
 235                         unset($new['saisies']);
 236                         $formulaire[] = $new;
 237
 238                         if (is_array($saisie['saisies']))
 239                                 $saisies[$cle]['saisies'] = saisies_transformer_noms_auto($formulaire, $saisie['saisies']);
 240                 }
 241         }
 242
 243         return $saisies;
 244 }
 245
 246 /*
 247  * Insère du HTML au début ou à la fin d'une saisie
 248  *
 249  * @param array $saisie La description d'une seule saisie
 250  * @param string $insertion Du code HTML à insérer dans la saisie
 251  * @param string $ou L'endroit où insérer le HTML : "debut" ou "fin"
 252  * @return array Retourne la description de la saisie modifiée
 253  */
 254 function saisies_inserer_html($saisie, $insertion, $ou='fin'){
 255         if (!in_array($ou, array('debut', 'fin')))
 256                 $ou = 'fin';
 257
 258         if ($ou == 'debut')
 259                 $saisie['options']['inserer_debut'] = $insertion.$saisie['options']['inserer_debut'];
 260         elseif ($ou == 'fin')
 261                 $saisie['options']['inserer_fin'] = $saisie['options']['inserer_fin'].$insertion;
 262
 263         return $saisie;
 264 }
 265
 266 ?>