3449926e6558949b20b55a7527587334c7e3a0ef
4 * Gestion de l'affichage des saisies.
6 * @return SPIP\Saisies\Manipuler
10 if (!defined('_ECRIRE_INC_VERSION')) {
15 * Supprimer une saisie dont on donne l'identifiant, le nom ou le chemin.
17 * @param array $saisies Tableau des descriptions de saisies
18 * @param string|array $id_ou_nom_ou_chemin
19 * L'identifiant unique
20 * ou le nom de la saisie à supprimer
21 * ou son chemin sous forme d'une liste de clés
24 * Tableau modifié décrivant les saisies
26 function saisies_supprimer($saisies, $id_ou_nom_ou_chemin) {
27 // On enlève les options générales avant de manipuler
28 if (isset($saisies['options'])) {
29 $options_generales = $saisies['options'];
30 unset($saisies['options']);
33 // Si la saisie n'existe pas, on ne fait rien
34 if ($chemin = saisies_chercher($saisies, $id_ou_nom_ou_chemin, true)) {
35 // La position finale de la saisie
36 $position = array_pop($chemin);
38 // On va chercher le parent par référence pour pouvoir le modifier
40 foreach ($chemin as $cle) {
41 $parent = &$parent[$cle];
44 // On supprime et réordonne
45 unset($parent[$position]);
46 $parent = array_values($parent);
49 // On remet les options générales après avoir manipulé
50 if (isset($options_generales)) {
51 $saisies['options'] = $options_generales;
58 * Insère une saisie à une position donnée.
60 * @param array $saisies Tableau des descriptions de saisies
61 * @param array $saisie Description de la saisie à insérer
62 * @param array $chemin
63 * Position complète où insérer la saisie.
64 * En absence, insère la saisie à la fin.
67 * Tableau des saisies complété de la saisie insérée
69 function saisies_inserer($saisies, $saisie, $chemin = array()) {
70 // On enlève les options générales avant de manipuler
71 if (isset($saisies['options'])) {
72 $options_generales = $saisies['options'];
73 unset($saisies['options']);
76 // On vérifie quand même que ce qu'on veut insérer est correct
77 if ($saisie['saisie'] and $saisie['options']['nom']) {
78 // ajouter un identifiant
79 $saisie = saisie_identifier($saisie);
81 // Par défaut le parent c'est la racine
83 // S'il n'y a pas de position, on va insérer à la fin du formulaire
85 $position = count($parent);
86 } elseif (is_array($chemin)) {
87 $position = array_pop($chemin);
88 foreach ($chemin as $cle) {
89 // Si la clé est un conteneur de saisies "saisies" et qu'elle n'existe pas encore, on la crée
90 if ($cle == 'saisies' and !isset($parent[$cle])) {
91 $parent[$cle] = array();
93 $parent = &$parent[$cle];
95 // On vérifie maintenant que la position est cohérente avec le parent
98 } elseif ($position > count($parent)) {
99 $position = count($parent);
102 // Et enfin on insère
103 array_splice($parent, $position, 0, array($saisie));
106 // On remet les options générales après avoir manipulé
107 if (isset($options_generales)) {
108 $saisies['options'] = $options_generales;
115 * Duplique une saisie (ou groupe de saisies)
116 * en placant la copie à la suite de la saisie d'origine.
117 * Modifie automatiquement les identifiants des saisies.
119 * @param array $saisies Un tableau décrivant les saisies
120 * @param unknown_type $id_ou_nom_ou_chemin L'identifiant unique ou le nom ou le chemin de la saisie a dupliquer
122 * @return array Retourne le tableau modifié des saisies
124 function saisies_dupliquer($saisies, $id_ou_nom_ou_chemin) {
125 // On récupère le contenu de la saisie à déplacer
126 $saisie = saisies_chercher($saisies, $id_ou_nom_ou_chemin);
128 list($clone) = saisies_transformer_noms_auto($saisies, array($saisie));
129 // insertion apres quoi ?
130 $chemin_validation = saisies_chercher($saisies, $id_ou_nom_ou_chemin, true);
131 // 1 de plus pour mettre APRES le champ trouve
132 ++
$chemin_validation[count($chemin_validation) - 1];
133 // On ajoute "copie" après le label du champs
134 $clone['options']['label'] .= ' '._T('saisies:construire_action_dupliquer_copie');
136 // Création de nouveau identifiants pour le clone
137 $clone = saisie_identifier($clone, true);
139 $saisies = saisies_inserer($saisies, $clone, $chemin_validation);
146 * Déplace une saisie existante autre part.
148 * @param array $saisies Un tableau décrivant les saisies
149 * @param unknown_type $id_ou_nom_ou_chemin L'identifiant unique ou le nom ou le chemin de la saisie à déplacer
150 * @param string $ou Le nom de la saisie devant laquelle on déplacera OU le nom d'un conteneur entre crochets [conteneur]
152 * @return array Retourne le tableau modifié des saisies
154 function saisies_deplacer($saisies, $id_ou_nom_ou_chemin, $ou) {
155 // On récupère le contenu de la saisie à déplacer
156 $saisie = saisies_chercher($saisies, $id_ou_nom_ou_chemin);
158 // Si on l'a bien trouvé
160 // On cherche l'endroit où la déplacer
161 // Si $ou est vide, c'est à la fin de la racine
163 $saisies = saisies_supprimer($saisies, $id_ou_nom_ou_chemin);
164 $chemin = array(count($saisies));
165 } elseif (preg_match('/^\[(@?[\w]*)\]$/', $ou, $match)) {
166 // Si l'endroit est entre crochet, c'est un conteneur
168 // Si dans les crochets il n'y a rien, on met à la fin du formulaire
170 $saisies = saisies_supprimer($saisies, $id_ou_nom_ou_chemin);
171 $chemin = array(count($saisies));
172 } elseif (saisies_chercher($saisies, $parent, true)) {
173 // Sinon on vérifie que ce conteneur existe
174 // S'il existe on supprime la saisie et on recherche la nouvelle position
175 $saisies = saisies_supprimer($saisies, $id_ou_nom_ou_chemin);
176 $parent = saisies_chercher($saisies, $parent, true);
177 $chemin = array_merge($parent, array('saisies', 1000000));
182 // Sinon ça sera devant un champ
183 // On vérifie que le champ existe
184 if (saisies_chercher($saisies, $ou, true)) {
185 // S'il existe on supprime la saisie
186 $saisies = saisies_supprimer($saisies, $id_ou_nom_ou_chemin);
187 // Et on recherche la nouvelle position qui n'est plus forcément la même maintenant qu'on a supprimé une saisie
188 $chemin = saisies_chercher($saisies, $ou, true);
194 // Si seulement on a bien trouvé un nouvel endroit où la placer, alors on déplace
196 $saisies = saisies_inserer($saisies, $saisie, $chemin);
204 * Modifie une saisie.
206 * @param array $saisies Un tableau décrivant les saisies
207 * @param unknown_type $id_ou_nom_ou_chemin L'identifiant unique ou le nom ou le chemin de la saisie à modifier
208 * @param array $modifs Le tableau des modifications à apporter à la saisie
210 * @return Retourne le tableau décrivant les saisies, mais modifié
212 function saisies_modifier($saisies, $id_ou_nom_ou_chemin, $modifs) {
213 $chemin = saisies_chercher($saisies, $id_ou_nom_ou_chemin, true);
214 $position = array_pop($chemin);
216 foreach ($chemin as $cle) {
217 $parent = &$parent[$cle];
220 // On récupère le type tel quel
221 $modifs['saisie'] = $parent[$position]['saisie'];
222 // On récupère le nom s'il n'y est pas
223 if (!isset($modifs['options']['nom'])) {
224 $modifs['options']['nom'] = $parent[$position]['options']['nom'];
226 // On récupère les enfants tels quels s'il n'y a pas des enfants dans la modif
227 if (!isset($modifs['saisies'])
228 and isset($parent[$position]['saisies'])
229 and is_array($parent[$position]['saisies'])
231 $modifs['saisies'] = $parent[$position]['saisies'];
234 // Si une option 'nouveau_type_saisie' est donnee, c'est que l'on souhaite
235 // peut être changer le type de saisie !
236 if (isset($modifs['options']['nouveau_type_saisie']) and $type = $modifs['options']['nouveau_type_saisie']) {
237 $modifs['saisie'] = $type;
238 unset($modifs['options']['nouveau_type_saisie']);
242 $parent[$position] = $modifs;
244 // Cette méthode ne marche pas trop
245 //$parent[$position] = array_replace_recursive($parent[$position], $modifs);
251 * Transforme tous les noms du formulaire avec un preg_replace.
253 * @param array $saisies Un tableau décrivant les saisies
254 * @param string $masque Ce que l'on doit chercher dans le nom
255 * @param string $remplacement Ce par quoi on doit remplacer
257 * @return array Retourne le tableau modifié des saisies
259 function saisies_transformer_noms($saisies, $masque, $remplacement) {
260 if (is_array($saisies)) {
261 foreach ($saisies as $cle => $saisie) {
262 $saisies[$cle]['options']['nom'] = preg_replace($masque, $remplacement, $saisie['options']['nom']);
263 if (isset($saisie['saisies']) and is_array($saisie['saisies'])) {
264 $saisies[$cle]['saisies'] = saisies_transformer_noms($saisie['saisies'], $masque, $remplacement);
273 * Transforme les noms d'une liste de saisies pour qu'ils soient
274 * uniques dans le formulaire donné.
276 * @param array $formulaire Le formulaire à analyser
277 * @param array $saisies Un tableau décrivant les saisies.
280 * Retourne le tableau modifié des saisies
282 function saisies_transformer_noms_auto($formulaire, $saisies) {
283 if (is_array($saisies)) {
284 foreach ($saisies as $cle => $saisie) {
285 $saisies[$cle]['options']['nom'] = saisies_generer_nom($formulaire, $saisie['saisie']);
286 // il faut prendre en compte dans $formulaire les saisies modifiees
287 // sinon on aurait potentiellement 2 champs successifs avec le meme nom.
288 // on n'ajoute pas les saisies dont les noms ne sont pas encore calculees.
289 $new = $saisies[$cle];
290 unset($new['saisies']);
291 $formulaire[] = $new;
293 if (isset($saisie['saisies']) and is_array($saisie['saisies'])) {
294 $saisies[$cle]['saisies'] = saisies_transformer_noms_auto($formulaire, $saisie['saisies']);
303 * Insère du HTML au début ou à la fin d'une saisie.
305 * @param array $saisie La description d'une seule saisie
306 * @param string $insertion Du code HTML à insérer dans la saisie
307 * @param string $ou L'endroit où insérer le HTML : "debut" ou "fin"
309 * @return array Retourne la description de la saisie modifiée
311 function saisies_inserer_html($saisie, $insertion, $ou = 'fin') {
312 if (!in_array($ou, array('debut', 'fin'))) {
316 if ($ou == 'debut') {
317 $saisie['options']['inserer_debut'] =
318 $insertion.(isset($saisie['options']['inserer_debut']) ?
$saisie['options']['inserer_debut'] : '');
319 } elseif ($ou == 'fin') {
320 $saisie['options']['inserer_fin'] =
321 (isset($saisie['options']['inserer_fin']) ?
$saisie['options']['inserer_fin'] : '').$insertion;