Changeset 112825 in spip-zone


Ignore:
Timestamp:
Dec 15, 2018, 12:56:06 PM (2 years ago)
Author:
eric@…
Message:

Revue qualité du PHPDoc et quelques déplacements de fichiers et de fonctions.
On fait un up de z pour synchroniser le noiZetier avec cette version fonctionnelle.

Location:
_plugins_/n-core/trunk
Files:
4 deleted
14 edited
2 moved

Legend:

Unmodified
Added
Removed

  • _plugins_/n-core/trunk/avertir_preview.html

    r110835 r112825  
    1 [(#REM) <!--  PREVIEW_NOTICE
     1[(#REM) <!--  AVERTIR_PREVIEW
    22
    33        Affiche un avertissement sur le fait que la noisette prévisualisée est d'un type qui n'est plus actif
    … …  
    55
    66    @param string type_noisette
    7            Identifiant du type de noisette
     7           Identifiant du type de noisette.
     8    @param string plugins_inactifs
     9           Liste des plugins inactifs.
    810-->]
    911<div class="notice">

  • _plugins_/n-core/trunk/conteneur_compiler.html

    r112778 r112825  
    1313               Identifiant du conteneur.
    1414        @param string stockage
    15            Identifiant du service de stockage à utiliser si précisé. Dans ce cas, ni celui du plugin
    16            ni celui de N-Core ne seront utilisés. En général, cet identifiant est le préfixe d'un plugin
    17            fournissant le service de stockage souhaité.
     15           Identifiant du service de stockage à utiliser si précisé.
    1816-->]
    1917#SET{noisettes, #NOISETTE_REPERTORIER{#ENV{plugin}, #ENV{id_conteneur}, #ENV{stockage}}}

  • _plugins_/n-core/trunk/inc/ncore_conteneur.php

    r110214 r112825  
    2323 *        Tableau descriptif du conteneur ou identifiant du conteneur.
    2424 * @param string $stockage
    25  *        Identifiant du service de stockage à utiliser si précisé. Dans ce cas, ni celui du plugin
    26  *        ni celui de N-Core ne seront utilisés. En général, cet identifiant est le préfixe d'un plugin
    27  *        fournissant le service de stockage souhaité.
     25 *        Identifiant du service de stockage à utiliser si précisé.
    2826 *
    2927 * @return bool

  • _plugins_/n-core/trunk/inc/ncore_noisette.php

    r112725 r112825  
    459459        return $retour;
    460460}
    461 
    462 /**
    463  * Renvoie une liste de descriptions de noisettes appartenant à un conteneur donné ou pas et éventuellement filtrée
    464  * sur certains champs.
    465  * Le tableau retourné est indexé soit par identifiant de noisette soit par identifiant du conteneur et rang.
    466  *
    467  * @api
    468  * @uses ncore_noisette_lister()
    469  *
    470  * @param string $plugin
    471  *        Identifiant qui permet de distinguer le module appelant qui peut-être un plugin comme le noiZetier
    472  *        ou un script. Pour un plugin, le plus pertinent est d'utiliser le préfixe.
    473  * @param array|string $conteneur
    474  *        Tableau descriptif du conteneur ou identifiant du conteneur ou vide si on souhaite adresser tous les
    475  *        conteneurs.
    476  * @param string $cle
    477  *        Champ de la description d'une noisette servant d'index du tableau. On utilisera soit `id_noisette`
    478  *        soit `rang_noisette` (défaut).
    479  * @param array  $filtres
    480  *        Tableau associatif `[champ] = valeur` de critères de filtres sur les descriptions de types de noisette.
    481  *        Le seul opérateur possible est l'égalité.
    482  * @param string $stockage
    483  *        Identifiant du service de stockage à utiliser si précisé. Dans ce cas, ni celui du plugin
    484  *        ni celui de N-Core ne seront utilisés. En général, cet identifiant est le préfixe d'un plugin
    485  *        fournissant le service de stockage souhaité.
    486  *
    487  * @return array
    488  *        Tableau des descriptions des noisettes du conteneur indexé par le champ fourni en argument (par défaut le
    489  *        rang).
    490  */
    491 function noisette_repertorier($plugin, $conteneur = array(), $cle = 'rang_noisette', $filtres = array(), $stockage = '') {
    492 
    493         // On indexe le tableau des noisettes par le plugin appelant en cas d'appel sur le même hit
    494         // par deux plugins différents et aussi par la clé d'indexation.
    495         static $noisettes = array();
    496 
    497         if (!isset($noisettes[$plugin][$cle])) {
    498                 // On charge l'API de N-Core.
    499                 // Ce sont ces fonctions qui aiguillent ou pas vers une fonction spécifique du service.
    500                 include_spip("ncore/ncore");
    501 
    502                 // On récupère la description complète de tous les types de noisettes détectés par le plugin appelant
    503                 $noisettes[$plugin][$cle] = ncore_noisette_lister($plugin, $conteneur, '', $cle, $stockage);
    504         }
    505 
    506         // Application des filtres éventuellement demandés en argument de la fonction
    507         $noisettes_filtrees = $noisettes[$plugin][$cle];
    508         if ($filtres) {
    509                 foreach ($noisettes_filtrees as $_noisette => $_description) {
    510                         foreach ($filtres as $_critere => $_valeur) {
    511                                 if (isset($_description[$_critere]) and ($_description[$_critere] != $_valeur)) {
    512                                         unset($noisettes_filtrees[$_noisette]);
    513                                         break;
    514                                 }
    515                         }
    516                 }
    517         }
    518 
    519         return $noisettes_filtrees;
    520 }

  • _plugins_/n-core/trunk/inc/ncore_type_noisette.php

    r112777 r112825  
    1313/**
    1414 * Charge ou recharge les descriptions des types de noisette à partir des fichiers YAML.
    15  * Les types de noisettes sont recherchés dans un répertoire relatif fourni en argument.
    1615 * La fonction optimise le chargement en effectuant uniquement les traitements nécessaires
    17  * en fonction des modifications, ajouts et suppressions des types de noisettes identifiés en comparant
    18  * les md5 des fichiers YAML.
     16 * en fonction des modifications, ajouts et suppressions des types de noisette identifiés
     17 * en comparant les md5 des fichiers YAML.
    1918 *
    2019 * @api
    … …  
    2827 *        ou un script. Pour un plugin, le plus pertinent est d'utiliser le préfixe.
    2928 * @param bool   $recharger
    30  *        Si `true` force le rechargement de toutes les types de noisettes, sinon le chargement se base sur le
     29 *        Si `true` force le rechargement de tous les types de noisette, sinon le chargement se base sur le
    3130 *        md5 des fichiers YAML. Par défaut vaut `false`.
    3231 * @param string $stockage
    33  *        Identifiant du service de stockage à utiliser si précisé. Dans ce cas, ni celui du plugin
    34  *        ni celui de N-Core ne seront utilisés. En général, cet identifiant est le préfixe d'un plugin
    35  *        fournissant le service de stockage souhaité.
     32 *        Identifiant du service de stockage à utiliser si précisé.
    3633 *
    3734 * @return bool
    … …  
    242239 *        Le service permet de distinguer l'appelant qui peut-être un plugin comme le noiZetier ou
    243240 *        un script. Pour un plugin, le plus pertinent est d'utiliser le préfixe.
    244  *        La fonction utilisera la fonction de lecture de la description brute d'un type de noisette, spécifique
    245  *        au service, ou à défaut, celle fournie par N-Core.
    246241 * @param string  $type_noisette
    247242 *        Identifiant du type de noisette.
    … …  
    253248 *        Les champs sérialisés sont eux toujours désérialisés.
    254249 * @param string  $stockage
    255  *        Identifiant du service de stockage à utiliser si précisé. Dans ce cas, ni celui du plugin
    256  *        ni celui de N-Core ne seront utilisés. En général, cet identifiant est le préfixe d'un plugin
    257  *        fournissant le service de stockage souhaité.
     250 *        Identifiant du service de stockage à utiliser si précisé.
    258251 *
    259252 * @return array|string
    … …  
    317310
    318311/**
    319  * Renvoie une liste de descriptions de types de noisette éventuellement filtrée sur certains champs.
     312 * Renvoie une liste de descriptions de types de noisette éventuellement filtrée sur certains champs
     313 * fournis en argument.
    320314 *
    321315 * @api
    … …  
    329323 *        Le seul opérateur possible est l'égalité.
    330324 * @param string $stockage
    331  *        Identifiant du service de stockage à utiliser si précisé. Dans ce cas, ni celui du plugin
    332  *        ni celui de N-Core ne seront utilisés. En général, cet identifiant est le préfixe d'un plugin
    333  *        fournissant le service de stockage souhaité.
     325 *        Identifiant du service de stockage à utiliser si précisé.
    334326 *
    335327 * @return array

  • _plugins_/n-core/trunk/ncore/ncore.php

    r112725 r112825  
    4545 *        concerné d'optimiser le traitement sachant que seules les types de noisette nouveaux sont fournis.
    4646 * @param string $stockage
    47  *        Identifiant du service de stockage à utiliser si précisé. Dans ce cas, ni celui du plugin ni celui de N-Core
    48  *        ne seront utilisés. En général, cet identifiant est le préfixe du plugin fournissant le stockage.
     47 *        Identifiant du service de stockage à utiliser si précisé.
    4948 *
    5049 * @return bool
    … …  
    131130 *        nécessite d'être compléter avant son stockage.
    132131 * @param string $stockage
    133  *        Identifiant du service de stockage à utiliser si précisé. Dans ce cas, ni celui du plugin ni celui de N-Core
    134  *        ne seront utilisés. En général, cet identifiant est le préfixe du plugin fournissant le stockage.
     132 *        Identifiant du service de stockage à utiliser si précisé.
    135133 *
    136134 * @return array
    … …  
    171169 *        Identifiant du type de noisette.
    172170 * @param string $stockage
    173  *        Identifiant du service de stockage à utiliser si précisé. Dans ce cas, ni celui du plugin ni celui de N-Core
    174  *        ne seront utilisés. En général, cet identifiant est le préfixe du plugin fournissant le stockage.
     171 *        Identifiant du service de stockage à utiliser si précisé.
    175172 *
    176173 * @return array
    … …  
    207204
    208205/**
    209  * Renvoie l'information brute demandée pour l'ensemble des types de noisette utilisés par le plugin appelant
    210  * ou toute les descriptions si aucune information n'est explicitement demandée.
     206 * Renvoie, pour l'ensemble des types de noisette, l'information brute demandée
     207 * ou toute la description si aucune information n'est explicitement demandée.
    211208 *
    212209 * @package SPIP\NCORE\TYPE_NOISETTE\SERVICE
    … …  
    223220 *        un champ invalide la fonction renvoie un tableau vide.
    224221 * @param string $stockage
    225  *        Identifiant du service de stockage à utiliser si précisé. Dans ce cas, ni celui du plugin ni celui de N-Core
    226  *        ne seront utilisés. En général, cet identifiant est le préfixe du plugin fournissant le stockage.
     222 *        Identifiant du service de stockage à utiliser si précisé.
    227223 *
    228224 * @return array
    … …  
    356352 *        soit la description contient l'id et c'est une mise à jour.
    357353 * @param string $stockage
    358  *        Identifiant du service de stockage à utiliser si précisé. Dans ce cas, ni celui du plugin ni celui de N-Core
    359  *        ne seront utilisés. En général, cet identifiant est le préfixe du plugin fournissant le stockage.
     354 *        Identifiant du service de stockage à utiliser si précisé.
    360355 *
    361356 * @return int|string
    … …  
    437432 *        un script. Pour un plugin, le plus pertinent est d'utiliser le préfixe.
    438433 * @param array  $description
    439  *        Description de la noisette par défaut. Suivant le plugin utilisateur elle nécessite d'être compléter
     434 *        Description standard de la noisette. Suivant le plugin utilisateur elle nécessite d'être compléter
    440435 *        avant son stockage.
    441436 * @param string $stockage
    442  *        Identifiant du service de stockage à utiliser si précisé. Dans ce cas, ni celui du plugin ni celui de N-Core
    443  *        ne seront utilisés. En général, cet identifiant est le préfixe du plugin fournissant le stockage.
     437 *        Identifiant du service de stockage à utiliser si précisé.
    444438 *
    445439 * @return array
    … …  
    479473 *        Position à laquelle ranger la noisette au sein du conteneur.
    480474 * @param string $stockage
    481  *        Identifiant du service de stockage à utiliser si précisé. Dans ce cas, ni celui du plugin ni celui de N-Core
    482  *        ne seront utilisés. En général, cet identifiant est le préfixe du plugin fournissant le stockage.
     475 *        Identifiant du service de stockage à utiliser si précisé.
    483476 *
    484477 * @return bool
    … …  
    542535 *        Description complète de la noisette.
    543536 * @param string       $stockage
    544  *        Identifiant du service de stockage à utiliser si précisé. Dans ce cas, ni celui du plugin ni celui de N-Core
    545  *        ne seront utilisés. En général, cet identifiant est le préfixe du plugin fournissant le stockage.
     537 *        Identifiant du service de stockage à utiliser si précisé.
    546538 *
    547539 * @return bool
    … …  
    589581/**
    590582 * Renvoie un champ ou toute la description des noisettes d'un conteneur ou de tous les conteneurs.
    591  * Le tableau retourné est indexé soit par identifiant de noisette soit par identifiant du conteneur et rang.
     583 * Le tableau retourné est indexé soit par identifiant de noisette soit par identifiant du conteneur et rang
     584 * de noisette.
    592585 *
    593586 * @package SPIP\NCORE\NOISETTE\SERVICE
    … …  
    603596 *        conteneurs.
    604597 * @param string $information
    605  *        Identifiant d'un champ de la description d'une type de noisette.
     598 *        Identifiant d'un champ de la description d'une noisette.
    606599 *        Si l'argument est vide, la fonction renvoie les descriptions complètes et si l'argument est
    607600 *        un champ invalide la fonction renvoie un tableau vide.
    608601 * @param string $cle
    609602 *        Champ de la description d'une noisette servant d'index du tableau. En général on utilisera soit `id_noisette`
    610  *        soit `rang`.
    611  * @param string $stockage
    612  *        Identifiant du service de stockage à utiliser si précisé. Dans ce cas, ni celui du plugin ni celui de N-Core
    613  *        ne seront utilisés. En général, cet identifiant est le préfixe du plugin fournissant le stockage.
     603 *        soit `rang_noisette`.
     604 * @param string $stockage
     605 *        Identifiant du service de stockage à utiliser si précisé.
    614606 *
    615607 * @return array
    … …  
    681673 * @param mixed  $noisette
    682674 *        Identifiant de la noisette qui peut prendre soit la forme d'un entier ou d'une chaine unique, soit la forme
    683  *        d'un couple (conteneur, rang).
    684  * @param string $stockage
    685  *        Identifiant du service de stockage à utiliser si précisé. Dans ce cas, ni celui du plugin ni celui de N-Core
    686  *        ne seront utilisés. En général, cet identifiant est le préfixe du plugin fournissant le stockage.
     675 *        d'un couple (conteneur, rang de noisette).
     676 * @param string $stockage
     677 *        Identifiant du service de stockage à utiliser si précisé.
    687678 *
    688679 * @return array
    … …  
    750741/**
    751742 * Renvoie la configuration par défaut de l'encapsulation d'une noisette.
    752  * Cette information est utilisée si le champ `balise` de la noisette vaut `defaut`.
     743 * Cette information est utilisée si le champ `encapsulation` de la noisette vaut `defaut`.
    753744 *
    754745 * Le service N-Core positionne cette valeur à `true`.
    … …  
    808799 *        à l'utilisation qui en est faite par le plugin.
    809800 * @param string $stockage
    810  *        Identifiant du service de stockage à utiliser si précisé. Dans ce cas, ni celui du plugin ni celui de N-Core
    811  *        ne seront utilisés. En général, cet identifiant est le préfixe du plugin fournissant le stockage.
     801 *        Identifiant du service de stockage à utiliser si précisé.
    812802 *
    813803 * @return string
    … …  
    820810        // au plugin utilisateur.
    821811        // Il est donc indispensable que le plugin utilisateur propose toujours une fonction de calcul de l'identifiant.
     812        // TODO : ne faudrait-il pas calculer automatiquement l'id pour une noisette conteneur ?
    822813        $id_conteneur = '';
    823814        if ($conteneur) {
    … …  
    848839 *        Tableau descriptif du conteneur ou identifiant du conteneur.
    849840 * @param string       $stockage
    850  *        Identifiant du service de stockage à utiliser si précisé. Dans ce cas, ni celui du plugin ni celui de N-Core
    851  *        ne seront utilisés. En général, cet identifiant est le préfixe du plugin fournissant le stockage.
     841 *        Identifiant du service de stockage à utiliser si précisé.
    852842 *
    853843 * @return bool

  • _plugins_/n-core/trunk/ncore_fonctions.php

    r112819 r112825  
    3333 *            Identifiant du type de noisette.
    3434 * @param string $stockage
    35  *        Identifiant du service de stockage à utiliser si précisé. Dans ce cas, ni celui du plugin
    36  *        ni celui de N-Core ne seront utilisés. En général, cet identifiant est le préfixe d'un plugin
    37  *        fournissant le service de stockage souhaité.
     35 *        Identifiant du service de stockage à utiliser si précisé.
    3836 *
    3937 * @return bool
    … …  
    102100 *            Identifiant du type de noisette.
    103101 * @param string $stockage
    104  *        Identifiant du service de stockage à utiliser si précisé. Dans ce cas, ni celui du plugin
    105  *        ni celui de N-Core ne seront utilisés. En général, cet identifiant est le préfixe d'un plugin
    106  *        fournissant le service de stockage souhaité.
     102 *        Identifiant du service de stockage à utiliser si précisé.
    107103 *
    108104 * @return bool
    … …  
    151147 * du type de noisette demandé.
    152148 * Cette fonction gère le cas particulier de la noisette conteneur fournie par N-Core qui est elle
    153  * toujours dans le dossier par défaut de N-Core.
     149 * toujours dans le dossier par défaut de N-Core et n'est donc pas surchargeable.
    154150 *
    155151 * @package SPIP\NCORE\TYPE_NOISETTE\API
    … …  
    196192/**
    197193 * Renvoie le contexte de la noisette sous la forme d'un tableau éventuellement vide. Cette fonction gère un cache
    198  * des contextes génériques des types de noisette disponibles.
     194 * des contextes non valorisés des types de noisette disponibles.
    199195 *
    200196 * @package SPIP\NCORE\NOISETTE\API
    … …  
    212208 * @param mixed  $noisette
    213209 *        Tableau des identifiants de la noisette qui peut prendre la forme d'un tableau avec pour index
    214  *        id_noisette, id conteneur et rang_noisette, ce qui permet d'utiliser l'un ou l'autre des identifiants.
     210 *        id_noisette, id conteneur et rang_noisette, ce qui permet d'utiliser l'un ou l'autre des identifiants
     211 *        de la noisette.
    215212 * @param string $type_noisette
    216213 *            Identifiant du type de noisette.
    … …  
    218215 *            Tableau de l'environnement reçu par la noisette.
    219216 * @param string $stockage
    220  *        Identifiant du service de stockage à utiliser si précisé. Dans ce cas, ni celui du plugin
    221  *        ni celui de N-Core ne seront utilisés. En général, cet identifiant est le préfixe d'un plugin
    222  *        fournissant le service de stockage souhaité.
     217 *        Identifiant du service de stockage à utiliser si précisé.
    223218 *
    224219 * @return array
    … …  
    280275
    281276/**
    282  * Encapsule, si demandé, le contenu de la noisette issu de la compilation dans un HTML plus ou moins complexe.
     277 * Encapsule, si demandé, le contenu compile d'une ou d'un ensemble de noisettes dans un balisage HTML
     278 * plus ou moins complexe appelé une capsule.
     279 * Une noisette conteneur est considérée comme une capsule et donc traitée en tant que tel.
    283280 *
    284281 * @package SPIP\NCORE\NOISETTE\API
    … …  
    288285 *
    289286 * @uses ncore_noisette_initialiser_encapsulation()
     287 * @uses type_noisette_localiser()
    290288 *
    291289 * @param string $plugin
    … …  
    293291 *        un script. Pour un plugin, le plus pertinent est d'utiliser le préfixe.
    294292 * @param string $contenu
    295  *        Contenu compilé de la noisette en cours avant encapsulation.
     293 *        Contenu compilé à encapsuler.
    296294 * @param string $encapsulation
    297295 *            Indicateur d'encapsulation du contenu par un capsule ou par une noisette conteneur. Prend les valeurs
    298  *        oui, non, defaut pour une capsule et conteneur pour une noisette conteneur.
     296 *        `oui`, `non`, `defaut` pour une capsule et `conteneur` pour une noisette conteneur.
    299297 * @param string $parametres
    300  *            Liste des paramètres de l'encapsulation. Pour une capsule, les index sont limités à type_noisette, id_noisette et
    301  *        css. Pour une noisette conteneur cette liste correspond au champ paramètres de la noisette et à son type.
    302  * @param string $stockage
    303  *        Identifiant du service de stockage à utiliser si précisé. Dans ce cas, ni celui du plugin
    304  *        ni celui de N-Core ne seront utilisés. En général, cet identifiant est le préfixe d'un plugin
    305  *        fournissant le service de stockage souhaité.
     298 *        Liste des paramètres de l'encapsulation. Pour une capsule, les index sont limités à `type_noisette`,
     299 *        `id_noisette` et `css`. Pour une noisette conteneur cette liste correspond au champ `parametres` de la
     300 *        noisette et à son type.
     301 * @param string $stockage
     302 *        Identifiant du service de stockage à utiliser si précisé.
    306303 *
    307304 * @return string
    308  *              Le contenu fourni encapsulé dans du HTML ou tel que fourni en entrée si pas d'encapsulation.
     305 *              Le contenu fourni encapsulé dans un balisage HTML ou tel que fourni en entrée si pas d'encapsulation.
    309306 */
    310307function noisette_encapsuler($plugin, $contenu, $encapsulation, $parametres, $stockage = '') {
    … …  
    362359}
    363360
     361
     362/**
     363 * Renvoie une liste de descriptions de noisettes appartenant à un conteneur donné ou pas et éventuellement filtrée
     364 * sur certains champs.
     365 * Le tableau retourné est indexé soit par identifiant de noisette soit par identifiant du conteneur et rang de la
     366 * noisette.
     367 *
     368 * @package SPIP\NCORE\NOISETTE\API
     369 *
     370 * @api
     371 *
     372 * @uses ncore_noisette_lister()
     373 *
     374 * @param string $plugin
     375 *        Identifiant qui permet de distinguer le module appelant qui peut-être un plugin comme le noiZetier
     376 *        ou un script. Pour un plugin, le plus pertinent est d'utiliser le préfixe.
     377 * @param array|string $conteneur
     378 *        Tableau descriptif du conteneur ou identifiant du conteneur ou vide si on souhaite adresser tous les
     379 *        conteneurs.
     380 * @param string $cle
     381 *        Champ de la description d'une noisette servant d'index du tableau. On utilisera soit `id_noisette`
     382 *        soit `rang_noisette` (défaut).
     383 * @param array  $filtres
     384 *        Tableau associatif `[champ] = valeur` de critères de filtres sur les descriptions de types de noisette.
     385 *        Le seul opérateur possible est l'égalité.
     386 * @param string $stockage
     387 *        Identifiant du service de stockage à utiliser si précisé.
     388 *
     389 * @return array
     390 *        Tableau des descriptions des noisettes du conteneur indexé par le champ fourni en argument (par défaut le
     391 *        rang).
     392 */
     393function noisette_repertorier($plugin, $conteneur = array(), $cle = 'rang_noisette', $filtres = array(), $stockage = '') {
     394
     395        // On indexe le tableau des noisettes par le plugin appelant en cas d'appel sur le même hit
     396        // par deux plugins différents et aussi par la clé d'indexation.
     397        static $noisettes = array();
     398
     399        if (!isset($noisettes[$plugin][$cle])) {
     400                // On charge l'API de N-Core.
     401                // Ce sont ces fonctions qui aiguillent ou pas vers une fonction spécifique du service.
     402                include_spip("ncore/ncore");
     403
     404                // On récupère la description complète de tous les types de noisettes détectés par le plugin appelant
     405                $noisettes[$plugin][$cle] = ncore_noisette_lister($plugin, $conteneur, '', $cle, $stockage);
     406        }
     407
     408        // Application des filtres éventuellement demandés en argument de la fonction
     409        $noisettes_filtrees = $noisettes[$plugin][$cle];
     410        if ($filtres) {
     411                foreach ($noisettes_filtrees as $_noisette => $_description) {
     412                        foreach ($filtres as $_critere => $_valeur) {
     413                                if (isset($_description[$_critere]) and ($_description[$_critere] != $_valeur)) {
     414                                        unset($noisettes_filtrees[$_noisette]);
     415                                        break;
     416                                }
     417                        }
     418                }
     419        }
     420
     421        return $noisettes_filtrees;
     422}
     423
    364424 
    365425// -----------------------------------------------------------------------
    … …  
    378438 * @filtre
    379439 *
     440 * @uses ncore_conteneur_identifier()
     441 *
    380442 * @param string $plugin
    381443 *        Identifiant qui permet de distinguer le module appelant qui peut-être un plugin comme le noiZetier ou

  • _plugins_/n-core/trunk/noisettes/conteneur-preview.html

    r110200 r112825  
     1[(#REM) <!--  CONTENEUR-PREVIEW
     2
     3        Fichier HTML de prévisualisation de la noisette associée : conteneur.html.
     4        La prévisualisation affiche uniquement la balise choisie.
     5
     6        @param string conteneur_balise
     7               Balise englobante. Peut prendre les valeurs div, section, article, aside, nav et p.
     8-->]
    19#SET{balise, #ENV{conteneur_balise, div}}
    210<:ncore:type_noisette_conteneur_preview{balise=#GET{balise}}:>

  • _plugins_/n-core/trunk/noisettes/conteneur.html

    r112819 r112825  
     1[(#REM) <!--  CONTENEUR
     2
     3        Noisette conteneur standard fourni par N-Core. Cette noisette n'est pas surchargeable.
     4        Il est possible de choisir la balise et des styles spécifiques.
     5
     6        @param string conteneur_balise
     7               Balise englobante. Peut prendre les valeurs div, section, article, aside, nav et p.
     8        @param string conteneur_css
     9           Classes supplémentaires associées à la balise.
     10-->]
    111[<(#ENV{conteneur_balise}) class="noisette[ noisette_(#ENV{type_noisette})][ (#ENV{conteneur_css})]">]
    212        <!--noisettes-->

  • _plugins_/n-core/trunk/paquet.xml

    r112819 r112825  
    22        prefix="ncore"
    33        categorie="outil"
    4         version="0.5.4"
     4        version="0.5.5"
    55        etat="dev"
    66        compatibilite="[3.2.0;3.2.*]"

  • _plugins_/n-core/trunk/public/conteneur_identifier.php

    r112786 r112825  
    1616 * @balise
    1717 *
     18 * @uses conteneur_identifier()
     19 *
    1820 * @param Champ $p
    1921 *        Pile au niveau de la balise.
    … …  
    2527
    2628        // Récupération des arguments.
    27         // -- la balise utilise toujours le rangement par rang au sein du conteneur
    28         // -- et ne permet de filtrer les noisettes autrement que sur le conteneur.
    2929        $plugin = interprete_argument_balise(1, $p);
    3030        $plugin = isset($plugin) ? str_replace('\'', '"', $plugin) : '""';
    … …  
    3434        $stockage = isset($stockage) ? str_replace('\'', '"', $stockage) : '""';
    3535
    36         // On appelle la fonction de calcul de la liste des noisette
     36        // On appelle la fonction de calcul de l'identifiant du conteneur.
    3737        $p->code = "conteneur_identifier($plugin, $conteneur, $stockage)";
    3838

  • _plugins_/n-core/trunk/public/noisette_compiler.php

    r112790 r112825  
    1414 *
    1515 * @balise
     16 *
     17 * @uses conteneur_identifier()
     18 * @uses noisette_encapsuler()
     19 * @uses noisette_contextualiser()
     20 * @uses type_noisette_localiser()
     21 * @uses type_noisette_ajaxifier()
     22 * @uses type_noisette_dynamiser()
    1623 *
    1724 * @param Champ $p

  • _plugins_/n-core/trunk/public/noisette_preview.php

    r110859 r112825  
    8383 *
    8484 * @return string
    85  *        Code HTML généré pour la noisette.
     85 *        Code HTML de prévisualisation de la noisette.
    8686 */
    8787function calculer_preview_noisette($plugin, $noisette, $type_noisette_actif, $type_noisette_necessite) {

  • _plugins_/n-core/trunk/public/noisette_repertorier.php

    r112777 r112825  
    1313 * La signature de la balise est : `#NOISETTE_REPERTORIER{plugin, conteneur[, stockage]}`.
    1414 *
    15  * @package SPIP\NCORE\NOISETTE\BALISE
    1615 * @balise
     16 *
     17 * @uses noisette_repertorier()
    1718 *
    1819 * @param Champ $p
    … …  
    3536
    3637        // On appelle la fonction de calcul de la liste des noisette
    37         $p->code = "calculer_liste_noisettes($plugin, $conteneur, $stockage)";
     38        $p->code = "noisette_repertorier($plugin, $conteneur, 'rang_noisette', array(), $stockage)";
    3839
    3940        return $p;
    4041}
    41 
    42 /**
    43  * Récupère la liste des noisettes d'un conteneur pour la balise #CONTENEUR_IDENTIFIER.
    44  * Cette fonction est juste un wrapper pour la fonction d'API noisette_repertorier().
    45  *
    46  * @param string $plugin
    47  *        Identifiant qui permet de distinguer le module appelant qui peut-être un plugin comme le noiZetier ou
    48  *        un script. Pour un plugin, le plus pertinent est d'utiliser le préfixe.
    49  * @param array  $conteneur
    50  *        Tableau associatif descriptif du conteneur accueillant la noisette.
    51  * @param string $stockage
    52  *        Identifiant du service de stockage à utiliser si précisé.
    53  *
    54  * @return array
    55  *        Tableau des descriptions des noisettes du conteneur indexé par le rang de chaque noisette.
    56  */
    57 function calculer_liste_noisettes($plugin, $conteneur, $stockage) {
    58 
    59         include_spip('inc/ncore_noisette');
    60         $noisettes = noisette_repertorier($plugin, $conteneur, 'rang_noisette', array(), $stockage);
    61 
    62         return $noisettes;
    63 }
Note: See TracChangeset for help on using the changeset viewer.