Changeset 65731 in spip-zone
- Timestamp:
- Sep 10, 2012, 7:15:17 PM (8 years ago)
- Location:
- _plugins_/saisies
- Files:
-
- 4 edited
Legend:
- Unmodified
- Added
- Removed
-
_plugins_/saisies/balise/generer_saisies.php
r33169 r65731 1 1 <?php 2 3 /** 4 * Gestion de la balise GENERER_SAISIES 5 * 6 * @package SPIP\Saisies\Balises 7 */ 2 8 3 9 // Sécurité 4 10 if (!defined("_ECRIRE_INC_VERSION")) return; 5 11 12 /** 13 * Compile la balise GENERER_SAISIES 14 * 15 * La balise accepte 1 paramètre qui est une liste de descriptions de saisies 16 * dont on veut générer le HTML affichant les champs du formulaires 17 * 18 * Cette balise est un raccourcis : 19 * - #GENERER_SAISIES{#TABLEAU_DE_SAISIES} est équivalent à 20 * - #INCLURE{fond=generer_saisies,env,saisies=#TABLEAU_DE_SAISIES} 21 * 22 * @param Champ $p 23 * Pile au niveau de la balise 24 * @return Champ 25 * Pile complété du code à générer 26 **/ 6 27 function balise_GENERER_SAISIES_dist($p){ 7 28 -
_plugins_/saisies/inc/saisies.php
r63487 r65731 1 1 <?php 2 3 /** 4 * Gestion de l'affichage des saisies 5 * 6 * @return SPIP\Saisies\Saisies 7 **/ 2 8 3 9 // Sécurité … … 109 115 } 110 116 111 /* 117 /** 112 118 * Génère un nom unique pour un champ d'un formulaire donné 113 119 * 114 * @param array $formulaire Le formulaire à analyser 115 * @param string $type_saisie Le type de champ dont on veut un identifiant 116 * @return string Un nom unique par rapport aux autres champs du formulaire 120 * @param array $formulaire 121 * Le formulaire à analyser 122 * @param string $type_saisie 123 * Le type de champ dont on veut un identifiant 124 * @return string 125 * Un nom unique par rapport aux autres champs du formulaire 117 126 */ 118 127 function saisies_generer_nom($formulaire, $type_saisie){ -
_plugins_/saisies/inc/saisies_afficher.php
r65542 r65731 1 1 <?php 2 3 /** 4 * Gestion de l'affichage des saisies 5 * 6 * @return SPIP\Saisies\Afficher 7 **/ 2 8 3 9 // Sécurité 4 10 if (!defined('_ECRIRE_INC_VERSION')) return; 5 11 6 /* 12 /** 7 13 * Indique si une saisie peut être affichée. 14 * 8 15 * On s'appuie sur l'éventuelle clé "editable" du $champ. 9 16 * Si editable vaut : 10 * absent : le champ est éditable 11 * 1, le champ est éditable 12 * 0, le champ n'est pas éditable 13 * -1, le champ est éditable s'il y a du contenu dans le champ (l'environnement) 14 * ou dans un de ses enfants (fieldsets) 15 * 16 * @param $champ tableau de description de la saisie 17 * @param $env environnement transmis à la saisie, certainement l'environnement du formulaire 18 * @param $utiliser_editable false pour juste tester le cas -1 17 * - absent : le champ est éditable 18 * - 1, le champ est éditable 19 * - 0, le champ n'est pas éditable 20 * - -1, le champ est éditable s'il y a du contenu dans le champ (l'environnement) 21 * ou dans un de ses enfants (fieldsets) 22 * 23 * @param array $champ 24 * Tableau de description de la saisie 25 * @param array $env 26 * Environnement transmis à la saisie, certainement l'environnement du formulaire 27 * @param bool $utiliser_editable 28 * - false pour juste tester le cas -1 19 29 * 20 * @return bool Retourne un booléen indiquant l'état éditable ou pas 30 * @return bool 31 * Retourne un booléen indiquant l'état éditable ou pas : 32 * - true si la saisie est éditable (peut être affichée) 33 * - false sinon 21 34 */ 22 35 function saisie_editable($champ, $env, $utiliser_editable=true) { … … 58 71 } 59 72 60 /* 73 /** 61 74 * Génère une saisie à partir d'un tableau la décrivant et de l'environnement 62 * Le tableau doit être de la forme suivante : 63 * array( 64 * 'saisie' => 'input', 65 * 'options' => array( 66 * 'nom' => 'le_name', 67 * 'label' => 'Un titre plus joli', 68 * 'obligatoire' => 'oui', 69 * 'explication' => 'Remplissez ce champ en utilisant votre clavier.' 70 * ) 71 * ) 75 * 76 * @param array $champ 77 * Description de la saisie. 78 * Le tableau doit être de la forme suivante : 79 * array( 80 * 'saisie' => 'input', 81 * 'options' => array( 82 * 'nom' => 'le_name', 83 * 'label' => 'Un titre plus joli', 84 * 'obligatoire' => 'oui', 85 * 'explication' => 'Remplissez ce champ en utilisant votre clavier.' 86 * ) 87 * ) 88 * @param array $env 89 * Environnement du formulaire 90 * Permet de savoir les valeurs actuelles des contenus des saisies, 91 * les erreurs eventuelles présentes... 92 * @return string 93 * Code HTML des saisies de formulaire 72 94 */ 73 95 function saisies_generer_html($champ, $env=array()){ … … 157 179 } 158 180 159 /* 181 /** 160 182 * Génère une vue d'une saisie à partir d'un tableau la décrivant 161 183 * 162 184 * @see saisies_generer_html() 163 * @param array $saisie Un tableau décrivant une saisie 164 * @param array $env L'environnement, contenant normalement la réponse à la saisie 185 * @param array $saisie 186 * Tableau de description d'une saisie 187 * @param array $env 188 * L'environnement, contenant normalement la réponse à la saisie 165 189 * @param array $env_obligatoire 166 * @return string Retour le HTML des vues 190 * ??? 191 * @return string 192 * Code HTML de la vue de la saisie 167 193 */ 168 194 function saisies_generer_vue($saisie, $env=array(), $env_obligatoire=array()){ … … 193 219 // par les modification sur l'environnement servant à generer la saisie mère 194 220 $contexte['_env'] = $env; 195 221 196 222 // À partir du moment où on passe tout l'environnement, il faut enlever 197 223 // certains éléments qui ne doivent absolument provenir que des options … … 242 268 } 243 269 244 /* 270 /** 245 271 * Génère, à partir d'un tableau de saisie le code javascript ajouté à la fin de #GENERER_SAISIES 246 * pour produire un affichage conditionnel des saisies avec une option afficher_si. 247 * 248 * @param array $saisies Un tableau de saisies 249 * @param string $id_form Un identifiant unique pour le formulaire 272 * pour produire un affichage conditionnel des saisies ayant une option afficher_si. 273 * 274 * @param array $saisies 275 * Tableau de descriptions des saisies 276 * @param string $id_form 277 * Identifiant unique pour le formulaire 250 278 * @return text 279 * Code javascript 251 280 */ 252 281 function saisies_generer_js_afficher_si($saisies,$id_form){ … … 323 352 } 324 353 325 /* 354 /** 326 355 * Lorsque l'on affiche les saisies (#VOIR_SAISIES), les saisies ayant une option afficher_si 327 356 * et dont les conditions ne sont pas remplies doivent être retirées du tableau de saisies. 357 * 328 358 * Cette fonction sert aussi lors de la vérification des saisies avec saisies_verifier(). 329 * A ce moment la, les saisies non affichees sont retirees de _request (on passe leur valeur a NULL). 330 * 331 * @param array $saisies Un tableau de saisies 332 * @param array $env le tableau d'environnement transmis dans inclure/voi_saisies.html, NULL si on doit rechercher dans _request (pour saisies_verifier()). 333 * @return array Un tableau de saisies 359 * À ce moment là, les saisies non affichées sont retirées de _request 360 * (on passe leur valeur à NULL). 361 * 362 * @param array $saisies 363 * Tableau de descriptions de saisies 364 * @param array|null $env 365 * Tableau d'environnement transmis dans inclure/voi_saisies.html, 366 * NULL si on doit rechercher dans _request (pour saisies_verifier()). 367 * @return array 368 * Tableau de descriptions de saisies 334 369 */ 335 336 370 function saisies_verifier_afficher_si($saisies, $env=NULL) { 337 371 // eviter une erreur par maladresse d'appel :) -
_plugins_/saisies/inc/saisies_manipuler.php
r65542 r65731 1 1 <?php 2 3 /** 4 * Gestion de l'affichage des saisies 5 * 6 * @return SPIP\Saisies\Manipuler 7 **/ 2 8 3 9 // Sécurité 4 10 if (!defined('_ECRIRE_INC_VERSION')) return; 5 11 6 /* 12 /** 7 13 * Supprimer une saisie dont on donne l'identifiant, le nom ou le chemin 8 14 * 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 15 * @param array $saisies 16 * Tableau des descriptions de saisies 17 * @param string|array $id_ou_nom_ou_chemin 18 * L'identifiant unique 19 * ou le nom de la saisie à supprimer 20 * ou son chemin sous forme d'une liste de clés 21 * @return array 22 * Tableau modifié décrivant les saisies 12 23 */ 13 24 function saisies_supprimer($saisies, $id_ou_nom_ou_chemin){ … … 31 42 } 32 43 33 /* 44 /** 34 45 * 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 46 * 47 * @param array $saisies 48 * Tableau des descriptions de saisies 49 * @param array $saisie 50 * Description de la saisie à insérer 51 * @param array $chemin 52 * Position complète où insérer la saisie. 53 * En absence, insère la saisie à la fin. 54 * @return array 55 * Tableau des saisies complété de la saisie insérée 40 56 */ 41 57 function saisies_inserer($saisies, $saisie, $chemin=array()){ … … 206 222 } 207 223 208 /* 224 /** 209 225 * Transforme tous les noms du formulaire avec un preg_replace 210 226 * 211 * @param array $saisies Un tableau décrivant les saisies 212 * @param string $masque Ce que l'on doit chercher dans le nom 213 * @param string $remplacement Ce par quoi on doit remplacer 214 * @return array Retourne le tableau modifié des saisies 227 * @param array $saisies 228 * Un tableau décrivant les saisies 229 * @param string $masque 230 * Ce que l'on doit chercher dans le nom 231 * @param string $remplacement 232 * Ce par quoi on doit remplacer 233 * @return array 234 * Retourne le tableau modifié des saisies 215 235 */ 216 236 function saisies_transformer_noms($saisies, $masque, $remplacement){ … … 227 247 } 228 248 229 /* 249 /** 230 250 * Transforme les noms d'une liste de saisies pour qu'ils soient 231 251 * uniques dans le formulaire donné. 232 252 * 233 * @param array $formulaire Le formulaire à analyser 234 * @param array $saisies Un tableau décrivant les saisies. 235 * @return array Retourne le tableau modifié des saisies 253 * @param array $formulaire 254 * Le formulaire à analyser 255 * @param array $saisies 256 * Un tableau décrivant les saisies. 257 * @return array 258 * Retourne le tableau modifié des saisies 236 259 */ 237 260 function saisies_transformer_noms_auto($formulaire, $saisies){
Note: See TracChangeset
for help on using the changeset viewer.