Changeset 87651 in spip-zone


Ignore:
Timestamp:
Feb 26, 2015, 8:48:58 PM (6 years ago)
Author:
marcimat@…
Message:
  • PHPDoc en plus à certains endroits
  • Pas de fermeture de php sur les fichiers php
  • Le phpdoc nécessite 2 étoiles
  • Les pipelines simplement déclarés (et non utilisés dans saisis) le sont dans paquet.xml directement
Location:
_plugins_/saisies/trunk
Files:
17 edited

Legend:

Unmodified
Added
Removed
  • _plugins_/saisies/trunk/action/deplacer_saisie.php

    r57987 r87651  
    11<?php
    22
     3/**
     4 * Gestion de l'action déplacer saisie.
     5 *
     6 * @package SPIP\Saisies\Action
     7 */
     8 
    39if (!defined("_ECRIRE_INC_VERSION")) return;
    410
     11/**
     12 * Action de déplacement de saisies dans le constructeur de formulaires
     13 *
     14 * @return void
     15**/
    516function action_deplacer_saisie_dist() {
    617        include_spip('inc/session');
    7        
     18
    819        $session         = _request('session');
    920        $identifiant = _request('saisie');
     
    3647}
    3748
    38 ?>
  • _plugins_/saisies/trunk/balise/configurer_saisie.php

    r33169 r87651  
    1 <?php
     1<?php
     2/**
     3 * Déclaration de la balise `#CONFIGURER_SAISIE`
     4 *
     5 * @package SPIP\Saisies\Balises
     6 */
    27
    38// Sécurité
    49if (!defined("_ECRIRE_INC_VERSION")) return;
    510
     11/**
     12 * Compile la balise `#CONFIGURER_SAISIE`
     13 *
     14 * @uses Pile\recuperer_et_supprimer_argument_balise()
     15 * @uses Pile\creer_et_ajouter_argument_balise()
     16 * @see balise_INCLURE_dist()
     17 * 
     18 * @param Champ $p
     19 * @return Champ
     20**/
    621function balise_CONFIGURER_SAISIE_dist($p){
    722
     
    1934       
    2035        // On redirige vers la balise INCLURE
    21         if(function_exists('balise_INCLURE'))
     36        if (function_exists('balise_INCLURE'))
    2237                return balise_INCLURE($p);
    2338        else
     
    2641}
    2742
    28 ?>
     43
  • _plugins_/saisies/trunk/balise/generer_saisies.php

    r65731 r87651  
    22
    33/**
    4  * Gestion de la balise GENERER_SAISIES
     4 * Gestion de la balise `#GENERER_SAISIES`
    55 *
    66 * @package SPIP\Saisies\Balises
     
    1111
    1212/**
    13  * Compile la balise GENERER_SAISIES
     13 * Compile la balise `#GENERER_SAISIES` qui retourne le code HTML des saisies de formulaire,
     14 * à partir du tableau des saisies transmises
    1415 *
    1516 * La balise accepte 1 paramètre qui est une liste de descriptions de saisies
     
    1718 *
    1819 * Cette balise est un raccourcis :
    19  * - #GENERER_SAISIES{#TABLEAU_DE_SAISIES} est équivalent à
    20  * - #INCLURE{fond=generer_saisies,env,saisies=#TABLEAU_DE_SAISIES}
     20 * - `#GENERER_SAISIES{#TABLEAU_DE_SAISIES}` est équivalent à
     21 * - `#INCLURE{fond=inclure/generer_saisies,env,saisies=#TABLEAU_DE_SAISIES}`
    2122 *
     23 * @syntaxe `#GENERER_SAISIE{#TABLEAU_DE_SAISIES}`
     24 *
    2225 * @param Champ $p
    2326 *     Pile au niveau de la balise
     
    4043       
    4144        // On redirige vers la balise INCLURE
    42         if(function_exists('balise_INCLURE'))
     45        if (function_exists('balise_INCLURE'))
    4346                return balise_INCLURE($p);
    4447        else
     
    4750}
    4851
    49 ?>
  • _plugins_/saisies/trunk/balise/saisie.php

    r60115 r87651  
    11<?php
    22
     3/**
     4 * Déclaration de la classe `Pile` et de la balise `#SAISIE`
     5 *
     6 * @package SPIP\Saisies\Balises
     7**/
     8
    39if (!defined("_ECRIRE_INC_VERSION")) return;
    410
    511// pour ne pas interferer avec d'eventuelles futures fonctions du core
    6 // on met le tout dans un namespace ; les fonctions sont autonomes.
    7 
     12// on met le tout dans une classe ; les fonctions sont autonomes.
     13
     14/**
     15 * Conteneur pour modifier les arguments d'une balise SPIP (de classe Champ) à compiler
     16 *
     17 * @note
     18 *     Ces fonctions visent à modifier l'AST (Arbre de Syntaxe Abstraite) issues
     19 *     de l'analyse du squelette. Très utile pour créer des balises qui
     20 *     transmettent des arguments supplémentaires automatiquement, à des balises
     21 *     déjà existantes.
     22 *     Voir un exemple d'utilisation dans `balise_SAISIE_dist()`.
     23 *
     24 * @note
     25 *     Les arguments sont stockés sont dans l'entree 0 de la propriété `param`
     26 *     dans l'objet Champ (représenté par `$p`), donc dans `$p->param[0]`.
     27 *
     28 *     `param[0][0]` vaut toujours '' (ou presque ?)
     29 *
     30 * @see balise_SAISIE_dist() Pour un exemple d'utilisation
     31**/
    832class Pile {
    933
    1034
    11         // les arguments sont dans l'entree 0 du tableau param.
    12         // param[0][0] vaut toujours '' (ou presque ?)
     35        /**
     36         * Récupère un argument de balise
     37         *
     38         * @param int $pos
     39         * @param Champ $p
     40         * @return mixed|null Élément de l'AST représentant l'argument s'il existe
     41        **/
    1342        static function recuperer_argument_balise($pos, $p) {
    1443                if (!isset($p->param[0])) {
     
    1746                if (!isset($p->param[0][$pos])) {
    1847                        return null;
    19                 }       
     48                }
    2049                return $p->param[0][$pos];
    2150        }
    22        
    23        
    24        
    25         // les arguments sont dans l'entree 0 du tableau param.
    26         // param[0][0] vaut toujours '' (ou presque ?)
     51
     52        /**
     53         * Supprime un argument de balise
     54         *
     55         * @param int $pos
     56         * @param Champ $p
     57         * @return Champ
     58        **/
    2759        static function supprimer_argument_balise($pos, $p) {
    2860                if (!isset($p->param[0])) {
     
    3870                        $fin   = array_slice($p->param[0], $pos+1);
    3971                        $p->param[0] = array_merge($debut, $fin);
    40                 }               
     72                }
    4173                return $p;
    42         }       
    43        
    44        
    45        
     74        }
     75
     76
     77        /**
     78         * Retourne un argument de balise, et le supprime de la liste des arguments
     79         *
     80         * @uses Pile\recuperer_argument_balise()
     81         * @uses Pile\supprimer_argument_balise()
     82         *
     83         * @param int $pos
     84         * @param Champ $p
     85         * @return mixed|null Élément de l'AST représentant l'argument s'il existe
     86        **/
    4687        static function recuperer_et_supprimer_argument_balise($pos, &$p) {
    4788                $arg = Pile::recuperer_argument_balise($pos, $p);
     
    4990                return $arg;
    5091        }
    51        
    52        
    53        
    54        
    55         // les arguments sont dans l'entree 0 du tableau param.
    56         // param[0][0] vaut toujours '' (ou presque ?)
     92
     93
     94        /**
     95         * Ajoute un argument de balise
     96         *
     97         * Empile l'argument à la suite des arguments déjà existants pour la balise
     98         *
     99         * @param mixed $element Élément de l'AST représentant l'argument à ajouter
     100         * @param Champ $p
     101         * @return Champ
     102        **/
    57103        static function ajouter_argument_balise($element, $p) {
    58104                if (isset($p->param[0][0])) {
     
    68114                return $p;
    69115        }
    70        
    71        
    72        
    73         // creer_argument_balise(nom) = {nom}
    74         // creer_argument_balise(nom, 'coucou') = {nom=coucou}
    75         // creer_argument_balise(nom, $balise) = {nom=#BALISE}
     116
     117
     118        /**
     119         * Crée l'élément de l'AST représentant un argument de balise.
     120         *
     121         * @example
     122         *     ```
     123         *     $nom = Pile::creer_argument_balise(nom);           // {nom}
     124         *     $nom = Pile::creer_argument_balise(nom, 'coucou'); // {nom=coucou}
     125         *     
     126         *     $balise = Pile::creer_balise('BALISE');
     127         *     $nom = Pile::creer_argument_balise(nom, $balise);  // {nom=#BALISE}
     128         *     ```
     129         *
     130         * @param string $nom
     131         *     Nom de l'argument
     132         * @param string|object $valeur
     133         *     Valeur de l'argument. Peut être une chaîne de caractère ou un autre élément d'AST
     134         * @return array
     135        **/
    76136        static function creer_argument_balise($nom, $valeur = null) {
    77137                include_spip('public/interfaces');
     
    92152                }
    93153                // {nom=coucou}
    94                 elseif (is_string($valeur)) {                   
     154                elseif (is_string($valeur)) {
    95155                        $s->texte .= "=$valeur";
    96156                        $res = array($s);
     
    104164                return $res;
    105165        }
    106        
    107        
    108        
     166
     167
     168        /**
     169         * Crée et ajoute un argument à une balise
     170         *
     171         * @uses Pile\creer_argument_balise()
     172         * @uses Pile\ajouter_argument_balise()
     173         *
     174         * @param Champ $p
     175         * @param string $nom
     176         *     Nom de l'argument
     177         * @param string|object $valeur
     178         *     Valeur de l'argument. Peut être une chaîne de caractère ou un autre élément d'AST
     179         * @return Champ
     180        **/
    109181        static function creer_et_ajouter_argument_balise($p, $nom, $valeur = null) {
    110182                $new = Pile::creer_argument_balise($nom, $valeur);
     
    114186
    115187
    116         // creer une balise
    117         static function creer_balise($nom, $opt) {
     188        /**
     189         * Crée l'AST d'une balise
     190         *
     191         * @example
     192         *     ```
     193         *     // Crée : #ENV*{titre}
     194         *     $titre = Pile::recuperer_argument_balise(1, $p); // $titre, 1er argument de la balise actuelle
     195         *     $env = Pile::creer_balise('ENV', array('param' => array($titre), 'etoile' => '*'));
     196         *     ```
     197         *
     198         * @param string $nom
     199         *     Nom de la balise
     200         * @param array $opt
     201         *     Options (remplira les propriétés correspondantes de l'objet Champ)
     202         * @return Champ
     203        **/
     204        static function creer_balise($nom, $opt = array()) {
    118205                include_spip('public/interfaces');
    119206                $b = new Champ;
     
    137224
    138225
    139 /*
    140  * #saisie{type,nom} : champs obligatoires
     226/**
     227 * Compile la balise `#SAISIE` qui retourne le code HTML de la saisie de formulaire indiquée.
     228 *
     229 * Cette balise incluera le squelette `saisies/_base.html` et lui-même `saisies/{type}.html`
     230 *
     231 * La balise `#SAISIE` est un raccourci pour une écriture plus compliquée de la balise `#INCLURE`.
     232 * La balise calcule une série de paramètre récupérer et à transmettre à `#INCLURE`,
     233 * en fonction des valeurs des 2 premiers paramètres transmis.
    141234 *
    142  * collecte des arguments en fonctions du parametre "nom"
    143  * ajoute des arguments
    144  * appelle #INCLURE avec les arguments collectes en plus
    145  *
    146  * il faudrait en faire une balise dynamique (?)
    147  * pour avoir un code plus propre
    148  * mais je n'ai pas reussi a trouver comment recuperer "valeur=#ENV{$nom}"
    149  *
     235 * Les autres arguments sont transmis tels quels à la balise `#INCLURE`.
     236 *
     237 * Ainsi `#SAISIE{input,nom,label=Nom,...}` exécutera l'équivalent de
     238 * `#INCLURE{nom=nom,valeur=#ENV{nom},type_saisie=input,erreurs,fond=saisies/_base,label=Nom,...}`
     239 *
     240 * @syntaxe `#SAISIE{type,nom[,option=xx,...]}`
     241 *
     242 * @param Champ $p
     243 * @return Champ
    150244 */
    151245function balise_SAISIE_dist ($p) {
     
    168262        // on appelle la balise #INCLURE
    169263        // avec les arguments ajoutes
    170         if(function_exists('balise_INCLURE'))
     264        if (function_exists('balise_INCLURE'))
    171265                return balise_INCLURE($p);
    172266        else
    173267                return balise_INCLURE_dist($p);
    174                
    175268}
    176269
    177270
    178 
    179 
    180 ?>
  • _plugins_/saisies/trunk/balise/voir_saisie.php

    r36587 r87651  
    11<?php
     2
     3/**
     4 * Déclaration de la balise `#VOIR_SAISIE`
     5 *
     6 * @package SPIP\Saisies\Balises
     7**/
     8
    29
    310// Sécurité
    411if (!defined("_ECRIRE_INC_VERSION")) return;
    512
    6 /*
    7  * #VOIR_SAISIE{type,nom} : champs obligatoires
     13/**
     14 * Compile la balise `#VOIR_SAISIE` qui retourne le code HTML de la vue d'une saisie indiquée
     15 *
     16 * Cette balise incluera le squelette `saisies-vues/_base.html` et lui-même `saisies-vues/{type}.html`
    817 *
    9  * collecte des arguments en fonctions du parametre "nom"
    10  * ajoute des arguments
    11  * appelle #INCLURE avec les arguments collectes en plus
     18 * @syntaxe `#VOIR_SAISIE{type,nom[,option=valeur,...]}`
    1219 *
     20 * @param Champ $p
     21 * @return Champ
    1322 */
    1423function balise_VOIR_SAISIE_dist ($p) {
     
    3443        else
    3544                return balise_INCLURE_dist($p);
    36                
     45
    3746}
    38 
    39 ?>
  • _plugins_/saisies/trunk/balise/voir_saisies.php

    r36587 r87651  
    11<?php
     2/**
     3 * Déclaration de la balise `#VOIR_SAISIES`
     4 *
     5 * @package SPIP\Saisies\Balises
     6**/
    27
    38// Sécurité
    49if (!defined("_ECRIRE_INC_VERSION")) return;
    510
     11/**
     12 * Compile la balise `#VOIR_SAISIES` qui retourne le code HTML des vues de formulaire,
     13 * à partir du tableau des saisies transmises
     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 vues du formulaires
     17 *
     18 * Cette balise est un raccourcis :
     19 * - `#VOIR_SAISIES{#TABLEAU_DE_SAISIES}` est équivalent à
     20 * - `#INCLURE{fond=inclure/voir_saisies,env,saisies=#TABLEAU_DE_SAISIES}`
     21 *
     22 * @syntaxe `#VOIR_SAISIE{#TABLEAU_DE_SAISIES}`
     23 *
     24 * @param Champ $p
     25 *     Pile au niveau de la balise
     26 * @return Champ
     27 *     Pile complété du code à générer
     28**/
    629function balise_VOIR_SAISIES_dist($p){
    730
     
    2750
    2851}
    29 
    30 ?>
  • _plugins_/saisies/trunk/formulaires/construire_formulaire.php

    r86589 r87651  
    533533        return true;
    534534}
    535 ?>
  • _plugins_/saisies/trunk/formulaires/saisies_cvt.php

    r45189 r87651  
    3939}
    4040
    41 ?>
  • _plugins_/saisies/trunk/inc/saisies.php

    r85150 r87651  
    44 * Gestion de l'affichage des saisies
    55 *
    6  * @return SPIP\Saisies\Saisies
     6 * @package SPIP\Saisies\Saisies
    77**/
    88
     
    4141include_spip('inc/saisies_afficher');
    4242
    43 /*
     43/**
    4444 * Cherche la description des saisies d'un formulaire CVT dont on donne le nom
    4545 *
     
    6969}
    7070
    71 /*
     71/**
    7272 * Cherche une saisie par son id, son nom ou son chemin et renvoie soit la saisie, soit son chemin
    7373 *
     
    137137}
    138138
    139 /*
     139/**
    140140 * Crée un identifiant Unique
    141141 * pour toutes les saisies donnees qui n'en ont pas
     
    176176}
    177177
    178 /*
     178/**
    179179 * Vérifier tout un formulaire tel que décrit avec les Saisies
    180180 *
     
    459459}
    460460
    461 /*
     461/**
    462462 * Le tableau de saisies a-t-il une option afficher_si ?
    463463 *
     
    477477
    478478
    479 /*
     479/**
    480480 * Le tableau de saisies a-t-il une option afficher_si_remplissage ?
    481481 *
     
    492492        return false;
    493493}
    494 ?>
     494
  • _plugins_/saisies/trunk/inc/saisies_afficher.php

    r86264 r87651  
    426426        return $saisies;
    427427}
    428 
    429 ?>
  • _plugins_/saisies/trunk/inc/saisies_lister.php

    r86274 r87651  
    11<?php
     2
     3/**
     4 * Gestion de listes des saisies
     5 *
     6 * @return SPIP\Saisies\Listes
     7**/
    28
    39// Sécurité
    410if (!defined('_ECRIRE_INC_VERSION')) return;
    511
    6 /*
     12/**
    713 * Prend la description complète du contenu d'un formulaire et retourne
    814 * les saisies "à plat" classées par identifiant unique.
     
    3238}
    3339
    34 /*
     40/**
    3541 * Prend la description complète du contenu d'un formulaire et retourne
    3642 * les saisies "à plat" classées par nom.
     
    5965}
    6066
    61 /*
     67/**
    6268 * Liste les saisies ayant une option X
    6369 * # saisies_lister_avec_option('sql', $saisies);
     
    8692}
    8793
    88 /*
     94/**
    8995 * Liste les saisies ayant une definition SQL
    9096 *
     
    97103}
    98104
    99 /*
     105/**
    100106 * Prend la description complète du contenu d'un formulaire et retourne
    101107 * les saisies "à plat" classées par type de saisie.
     
    124130}
    125131
    126 /*
     132/**
    127133 * Prend la description complète du contenu d'un formulaire et retourne
    128134 * une liste des noms des champs du formulaire.
     
    136142}
    137143
    138 /*
     144/**
    139145 * A utiliser dans une fonction charger d'un formulaire CVT,
    140146 * cette fonction renvoie le tableau de contexte correspondant
     
    153159}
    154160
    155 /*
     161/**
    156162 * Prend la description complète du contenu d'un formulaire et retourne
    157163 * une liste des valeurs par défaut des champs du formulaire.
     
    177183}
    178184
    179 /*
     185/**
    180186 * Compare deux tableaux de saisies pour connaitre les différences
    181187 * @param array $saisies_anciennes Un tableau décrivant des saisies
     
    210216}
    211217
    212 /*
     218/**
    213219 * Compare deux saisies et indique si elles sont égales ou pas
    214220 */
     
    218224}
    219225
    220 /*
     226/**
    221227 * Compare deux tableaux de saisies pour connaitre les différences
    222228 * en s'appuyant sur les identifiants de saisies
     
    232238}
    233239
    234 /*
     240/**
    235241 * Liste toutes les saisies configurables (ayant une description)
    236242 *
     
    263269}
    264270
    265 /*
     271/**
    266272 * Lister les saisies existantes ayant une définition SQL
    267273 *
     
    279285}
    280286
    281 /*
     287/**
    282288 * Charger les informations contenues dans le YAML d'une saisie
    283289 *
     
    303309}
    304310
    305 /*
     311/**
    306312 * Quelles sont les saisies qui se débrouillent toutes seules, sans le _base commun
    307313 *
     
    322328}
    323329
    324 ?>
  • _plugins_/saisies/trunk/inc/saisies_manipuler.php

    r65731 r87651  
    8686}
    8787
    88 /*
     88/**
    8989 * Duplique une saisie (ou groupe de saisies)
    9090 * en placant la copie à la suite de la saisie d'origine.
     
    116116}
    117117
    118 /*
     118/**
    119119 * Déplace une saisie existante autre part
    120120 *
     
    175175}
    176176
    177 /*
     177/**
    178178 * Modifie une saisie
    179179 *
     
    278278}
    279279
    280 /*
     280/**
    281281 * Insère du HTML au début ou à la fin d'une saisie
    282282 *
     
    300300        return $saisie;
    301301}
    302 
    303 ?>
  • _plugins_/saisies/trunk/inclure/configurer_saisie_fonctions.php

    r35161 r87651  
    3636}
    3737
    38 ?>
  • _plugins_/saisies/trunk/paquet.xml

    r87641 r87651  
    22        prefix="saisies"
    33        categorie="outil"
    4         version="2.0.5"
     4        version="2.1.0"
    55        etat="stable"
    66        compatibilite="[3.0.0;3.1.*]"
     
    1919        <pipeline nom="header_prive" inclure="saisies_pipelines.php" />
    2020        <pipeline nom="affichage_final" inclure="saisies_pipelines.php" />
    21         <pipeline nom="saisies_autonomes" inclure="saisies_pipelines.php" />
    22         <pipeline nom="formulaire_saisies" inclure="saisies_pipelines.php" />
     21        <pipeline nom="saisies_autonomes" action="" />
     22        <pipeline nom="formulaire_saisies" action="" />
    2323        <pipeline nom="formulaire_charger" inclure="saisies_pipelines.php" />
    2424        <pipeline nom="formulaire_verifier" inclure="saisies_pipelines.php" />
  • _plugins_/saisies/trunk/saisies_fonctions.php

    r86599 r87651  
    11<?php
     2
     3/**
     4 * Déclaration de fonctions pour les squelettes
     5 *
     6 * @package SPIP\Saisies\Fonctions
     7**/
    28
    39if (!defined('_ECRIRE_INC_VERSION')) return;
     
    4248/**
    4349 * Passer un nom en une valeur compatible avec une classe css
    44  * toto => toto,
    45  * toto/truc => toto_truc,
    46  * toto[truc] => toto_truc,
     50 *
     51 * - toto => toto,
     52 * - toto/truc => toto_truc,
     53 * - toto[truc] => toto_truc
     54 *
     55 * @param string $nom
     56 * return string
    4757**/
    4858function saisie_nom2classe($nom) {
     
    5161
    5262/**
    53  * Passer un nom en une valeur compatible avec un name de formulaire
    54  * toto => toto,
    55  * toto/truc => toto[truc],
    56  * toto[truc] => toto[truc],
     63 * Passer un nom en une valeur compatible avec un `name` de formulaire
     64 *
     65 * - toto => toto,
     66 * - toto/truc => toto[truc],
     67 * - toto[truc] => toto[truc]
     68 *
     69 * @param string $nom
     70 * return string
    5771**/
    5872function saisie_nom2name($nom) {
     
    6781
    6882/**
    69  * Balise beurk #GLOBALS{debut_intertitre}
    70  * qui retourne la globale PHP du même nom si elle existe
     83 * Compile la balise `#GLOBALS{xxx}` qui retourne la valeur d'une vilaine variable globale de même nom si elle existe
    7184 *
    72  * @param array $p
    73  *              Pile au niveau de la balise
    74  * @return array
    75  *              Pile complétée du code php de la balise.
     85 * @example
     86 *     ```
     87 *     #GLOBALS{debut_intertitre}
     88 *     ```
     89 *
     90 * @param Champ $p
     91 *     Pile au niveau de la balise
     92 * @return Champ
     93 *     Pile complétée du code php de la balise.
    7694**/
    7795function balise_GLOBALS_dist($p) {
     
    132150        return $liste;
    133151}
    134 ?>
  • _plugins_/saisies/trunk/saisies_options.php

    r69899 r87651  
    11<?php
     2
     3/**
     4 * Déclaration systématiquement chargées
     5 *
     6 * @package SPIP\Saisies
     7**/
    28
    39// Sécurité
    410if (!defined('_ECRIRE_INC_VERSION')) return;
    511
    6 /*
    7  * une fonction qui regarde si $texte est une chaine de langue
    8  * de la forme <:qqch:>
    9  * si oui applique _T()
    10  * si non applique typo() suivant le mode choisi
    11  *
    12  * @param mixed $valeur
    13  *     Une valeur à tester. Si c'est un tableau, la fonction s'appliquera récursivement dessus.
    14  * @param string $mode_typo
    15  *     Le mode d'application de la fonction typo(), avec trois valeurs possibles "toujours", "jamais" ou "multi".
    16  * @return mixed
    17  *     Retourne la valeur éventuellement modifiée.
    18  */
     12
    1913if (!function_exists('_T_ou_typo')){
     14        /**
     15         * une fonction qui regarde si $texte est une chaine de langue
     16         * de la forme <:qqch:>
     17         * si oui applique _T()
     18         * si non applique typo() suivant le mode choisi
     19         *
     20         * @param mixed $valeur
     21         *     Une valeur à tester. Si c'est un tableau, la fonction s'appliquera récursivement dessus.
     22         * @param string $mode_typo
     23         *     Le mode d'application de la fonction typo(), avec trois valeurs possibles "toujours", "jamais" ou "multi".
     24         * @return mixed
     25         *     Retourne la valeur éventuellement modifiée.
     26         */
    2027        function _T_ou_typo($valeur, $mode_typo='toujours') {
    2128                // Si la valeur est bien une chaine (et pas non plus un entier déguisé)
     
    4653}
    4754
    48 ?>
  • _plugins_/saisies/trunk/saisies_pipelines.php

    r84403 r87651  
    11<?php
     2
     3/**
     4 * Utilisation des pipelines
     5 *
     6 * @package SPIP\Saisies\Pipelines
     7**/
    28
    39// Sécurité
    410if (!defined("_ECRIRE_INC_VERSION")) return;
    511
     12/**
     13 * Ajoute les scripts JS et CSS de saisies dans l'espace privé
     14 *
     15 * @param string $flux
     16 * @return string
     17**/
    618function saisies_header_prive($flux){
    719        $js = find_in_path('javascript/saisies.js');
     
    1426}
    1527
     28/**
     29 * Ajoute les scripts JS et CSS de saisies dans l'espace public
     30 *
     31 * Ajoute également de quoi gérer le datepicker de la saisie date si
     32 * celle-ci est utilisée dans la page.
     33 *
     34 * @param string $flux
     35 * @return string
     36**/
    1637function saisies_affichage_final($flux){
    1738        if (($p = strpos($flux,"<!--!inserer_saisie_editer-->"))!==false){
     
    4768}
    4869
    49 // Déclaration des pipelines
    50 function saisies_saisies_autonomes($flux) { return $flux; }
    51 function saisies_formulaire_saisies($flux) { return $flux; }
    5270
    53 // Déclarer automatiquement les champs d'un CVT si on les trouve dans un tableau de saisies et s'ils ne sont pas déjà déclarés
     71/**
     72 * Déclarer automatiquement les champs d'un formulaire CVT qui déclare des saisies
     73 *
     74 * Recherche une fonction `formulaires_XX_saisies_dist` et l'utilise si elle
     75 * est présente. Cette fonction doit retourner une liste de saisies dont on se
     76 * sert alors pour calculer les champs utilisés dans le formulaire.
     77 *
     78 * @param array $flux
     79 * @return array
     80**/
    5481function saisies_formulaire_charger($flux){
    5582        // Si le flux data est inexistant, on quitte : Le CVT d'origine a décidé de ne pas continuer
     
    5986
    6087        // Il faut que la fonction existe et qu'elle retourne bien un tableau
    61         if (include_spip('inc/saisies')
    62                 and $saisies = saisies_chercher_formulaire($flux['args']['form'], $flux['args']['args'])
    63         ){
     88        include_spip('inc/saisies')
     89        $saisies = saisies_chercher_formulaire($flux['args']['form'], $flux['args']['args']);
     90
     91        if ($saisies) {
    6492                // On ajoute au contexte les champs à déclarer
    6593                $contexte = saisies_lister_valeurs_defaut($saisies);
     
    72100}
    73101
    74 // Aiguiller CVT vers un squelette propre à Saisies lorsqu'on a déclaré des saisies et qu'il n'y a pas déjà un HTML
     102/**
     103 * Aiguiller CVT vers un squelette propre à Saisies lorsqu'on a déclaré des saisies et qu'il n'y a pas déjà un HTML
     104 *
     105 * Dans le cadre d'un formulaire CVT demandé, si ce formulaire a déclaré des saisies, et
     106 * qu'il n'y a pas de squelette spécifique pour afficher le HTML du formulaire,
     107 * alors on utilise le formulaire générique intégré au plugin saisie, qui calculera le HTML
     108 * à partir de la déclaration des saisies indiquées.
     109 *
     110 * @see saisies_formulaire_charger()
     111 *
     112 * @param array $flux
     113 * @return array
     114**/
    75115function saisies_styliser($flux){
    76116        // Si on cherche un squelette de formulaire
     
    90130}
    91131
    92 // Ajouter les vérifications déclarées dans la fonction "saisies" du CVT
     132/**
     133 * Ajouter les vérifications déclarées dans la fonction "saisies" du CVT
     134 *
     135 * Si un formulaire CVT a déclaré des saisies, on utilise sa déclaration
     136 * pour effectuer les vérifications du formulaire.
     137 *
     138 * @see saisies_formulaire_charger()
     139 * @uses saisies_verifier()
     140 *
     141 * @param array $flux
     142 *     Liste des erreurs du formulaire
     143 * @return array
     144 *     iste des erreurs
     145 */
    93146function saisies_formulaire_verifier($flux){
    94147        // Il faut que la fonction existe et qu'elle retourne bien un tableau
    95         if (include_spip('inc/saisies') and $saisies = saisies_chercher_formulaire($flux['args']['form'], $flux['args']['args'])){
     148        include_spip('inc/saisies');
     149        $saisies = saisies_chercher_formulaire($flux['args']['form'], $flux['args']['args']);
     150        if ($saisies) {
    96151                // On ajoute au contexte les champs à déclarer
    97152                $erreurs = saisies_verifier($saisies);
     
    101156        }
    102157
    103 
    104158        return $flux;
    105159}
    106160
    107 ?>
     161
Note: See TracChangeset for help on using the changeset viewer.