Changeset 112697 in spip-zone

Timestamp:

Dec 9, 2018, 8:36:18 PM (6 months ago)

Author:

eric@…

Message:

La suite

Location:

_plugins_/n-core/trunk

Files:

• compiler_noisettes.html (modified) (2 diffs)
• ncore/ncore.php (modified) (1 diff)
• ncore_fonctions.php (modified) (2 diffs)
• paquet.xml (modified) (1 diff)
• public/noisette_compiler.php (modified) (2 diffs)

_plugins_/n-core/trunk/compiler_noisettes.html

@@ -15 +15 @@
         @param array  noisettes
                Liste des descriptions de noisette à compiler dans l'ordre de leur rang.
-        @param string defaut_balise
-               Valeur à utiliser si la noisette est paramétrée avec la valeur `defaut`.
         @param string stockage
            Identifiant du service de stockage à utiliser si précisé. Dans ce cas, ni celui du plugin
@@ -32 +30 @@
                 #SET{conteneur, #ARRAY{type_noisette, #VALEUR{type_noisette}, id_noisette, #VALEUR{id_noisette}}}
                 <BOUCLE_noisettes_petits_enfants(BOUCLE_noisettes_enfants)></BOUCLE_noisettes_petits_enfants>
-                #SET{avec_div, #VALEUR{balise}|=={defaut}|?{#ENV{defaut_balise, oui}, #VALEUR{balise}}}
-                [[(#GET{avec_div}|oui)<div class="noisette[ noisette_(#VALEUR{type_noisette})][ (#VALEUR{css})]">]
-                        (#NOISETTE_COMPILER{#VALEUR{id_noisette}, #ENV{stockage, ''}})
-                [(#GET{avec_div}|oui)</div>]]
+                        [(#NOISETTE_COMPILER{#VALEUR{id_noisette}, #ENV{stockage, ''}})]
         </BOUCLE_noisettes_enfants>
                 [</(#GET{balise_conteneur})>]
         </B_noisettes_enfants>
-        #SET{avec_div, #VALEUR{balise}|=={defaut}|?{#ENV{defaut_balise, oui}, #VALEUR{balise}}}
-        [[(#GET{avec_div}|oui)<div class="noisette[ noisette_(#VALEUR{type_noisette})][ (#VALEUR{css})]">]
-                (#NOISETTE_COMPILER{#VALEUR{id_noisette}, #ENV{stockage, ''}})
-        [(#GET{avec_div}|oui)</div>]]
+                [(#NOISETTE_COMPILER{#VALEUR{id_noisette}, #ENV{stockage, ''}})]
 </BOUCLE_noisettes>

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

@@ -748 +748 @@
 }
 
+/**
+ * Renvoie la configuration par défaut de l'encapsulation d'une noisette en mode non auto.
+ * Cette information est utilisée si le mode d'encapsulation est manuel et si le champ `balise` de la noisette
+ * vaut `defaut`.
+ *
+ * Le service N-Core positionne cette valeur à `div`.
+ *
+ * @package SPIP\NCORE\NOISETTE\SERVICE
+ *
+ * @uses ncore_chercher_service()
+ *
+ * @param string $plugin
+ *        Identifiant qui permet de distinguer le module appelant qui peut-être un plugin comme le noiZetier ou
+ *        un script. Pour un plugin, le plus pertinent est d'utiliser le préfixe.
+ *
+ * @return string
+ *              VCapsule par defaut qui peut valoir `div` ou `aucune`.
+ */
+function ncore_noisette_initialiser_capsule($plugin) {
+
+        // On cherche le service de stockage à utiliser selon la logique suivante :
+        // - si le service de stockage est non vide on l'utilise en considérant que la fonction existe forcément;
+        // - sinon, on utilise la fonction du plugin appelant si elle existe;
+        // - et sinon, on utilise la fonction de N-Core.
+        include_spip('inc/ncore_utils');
+        if ($configurer = ncore_chercher_service($plugin, 'noisette_initialiser_capsule', '')) {
+                // On passe le plugin appelant à la fonction car cela permet ainsi de mutualiser les services de stockage.
+                // On autorise la fonction du plugin à retourner autre chose que true ou false si tant est que l'on puisse
+                // en déduire un booléen (par exemple, 'on' et '' comme le retourne une case à cocher du plugin Saisies).
+                $defaut_capsule = $configurer($plugin);
+        } else {
+                // Le service ne propose pas de fonction propre, on utilise celle de N-Core.
+                $defaut_capsule = 'div';
+        }
+
+        return $defaut_capsule;
+}
+
 
 // -----------------------------------------------------------------------

_plugins_/n-core/trunk/ncore_fonctions.php

@@ -7 +7 @@
         return;
 }
+
+
+if (!defined('_NCORE_ENCAPSULATION_AUTO')) {
+        /**
+         * Mode d'encapsulation des noisettes.
+         * Le mode auto applique à chaque noisette une capsule propre au type de noisette ou à défaut la capsule de base.
+         * Dans ce mode, il n'est plus possible de choisir manuellement l'encapsulation de chaque noisette.
+         */
+        define('_NCORE_ENCAPSULATION_AUTO', 'false');
+}
+
+if (!defined('_NCORE_ENCAPSULATION_DEFAUT')) {
+        /**
+         * Dans le cas où le mode d'encapsulation auto est inactif, il est possible de choisir noisette par noisette
+         * le type d'encapsulation. Les noisettes sont initialisés avec la valeur 'defaut' qui fait référence à cette
+         * constante. N-Core initialise cette valeur à 'div' ce qui provoque l'encapsulation dans une balise div.
+         */
+        define('_NCORE_ENCAPSULATION_DEFAUT', 'div');
+}
+
 
 // -----------------------------------------------------------------------
@@ -278 +298 @@
 
 
+/**
+ * Encapsule, si demandé, le contenu de la noisette issu de la compilation dans un HTML plus ou moins complexe.
+ *
+ * @package SPIP\NCORE\NOISETTE\API
+ *
+ * @api
+ * @filtre
+ *
+ * @uses ncore_noisette_initialiser_capsule()
+ *
+ * @param string $plugin
+ *        Identifiant qui permet de distinguer le module appelant qui peut-être un plugin comme le noiZetier ou
+ *        un script. Pour un plugin, le plus pertinent est d'utiliser le préfixe.
+ * @param string $contenu
+ *        Contenu compilé de la noisette en cours avant encapsulation.
+ * @param string $balise
+ *            Indicateur d'encapsulation du contenu par une balise div ou pas.
+ * @param string $css
+ *            Styles à intégrer au div d'encapsulation si appliqué.
+ * @param string $type_noisette
+ *            Identifiant du type de noisette.
+ * @param string $stockage
+ *        Identifiant du service de stockage à utiliser si précisé. Dans ce cas, ni celui du plugin
+ *        ni celui de N-Core ne seront utilisés. En général, cet identifiant est le préfixe d'un plugin
+ *        fournissant le service de stockage souhaité.
+ *
+ * @return array
+ *              Le tableau éventuellement vide des éléments de contexte de la noisette.
+ */
+function noisette_encapsuler($plugin, $contenu, $balise, $css, $type_noisette, $stockage = '') {
+
+        // Initialisation du tableau du HTML des capsules indexé par plugin et nom de capsule.
+        static $capsules = array();
+        static $defaut_encapsulation = '';
+
+
+        // Détermination du défaut d'encapsulation en mode non automatique uniquement (non utilisé en mode auto).
+        if (!_NCORE_ENCAPSULATION_AUTO and !$defaut_encapsulation) {
+                $defaut_encapsulation = ncore_noisette_initialiser_capsule($plugin);
+        }
+
+        // Si le mode d'encapsulation est positionné à auto ou si le mode d'encapsulation est manuel et que la noisette
+        // demande explicitement une encapsulation alors encapsule le contenu fourni.
+        // Sinon on renvoie le contenu compilé de la noisette tel que.
+        if (_NCORE_ENCAPSULATION_AUTO
+        or (!_NCORE_ENCAPSULATION_AUTO
+                and (($balise != 'aucune') or (($balise == 'defaut') and ($defaut_encapsulation != 'aucune'))))) {
+                // Détermination de la capsule à appliquer
+                // -- on cherche d'abord une capsule simple non liée au type de noisette.
+                $fond_capsule = '';
+                if (!_NCORE_ENCAPSULATION_AUTO
+                and (($balise != 'auto') or (($balise == 'defaut') and ($defaut_encapsulation != 'auto')))) {
+                        $fond_capsule = ($balise == 'defaut') ? $defaut_encapsulation : $balise;
+                        $contexte_capsule = array('type_noisette' => $type_noisette, 'css' => $css);
+                }
+
+                // -- Si la capsule simple n'a pas été trouvée c'est qu'on veut appliquer une capsule liée au type de noisette.
+                if (!$fond_capsule) {
+                        // On utilise soit la capsule propre à un type de noisette si elle existe, soit on utilise la capsule
+                        // par défaut qui porte le nom 'dist'.
+                        if (find_in_path("capsules/${type_noisette}.html")) {
+                                $fond_capsule = "capsules/${type_noisette}";
+                        } else {
+                                $fond_capsule = 'capsules/dist';
+                        }
+                        $contexte_capsule = array('type_noisette' => $type_noisette);
+                }
+
+                // On recherche si la capsule est déjà disponible sinon on la calcule et on la met en cache.
+                if (!isset($capsules[$plugin][$fond_capsule])) {
+                        $capsule = recuperer_fond($fond_capsule, $contexte_capsule);
+                        $capsules[$plugin][$fond_capsule] = $capsule;
+                }
+
+                // On insère le contenu de la noisette dans la capsule qui contient toujours une indication d'insertion explicite.
+                if ($capsules[$plugin][$fond_capsule]) {
+                        $contenu = str_replace('<!--noisettes-->', $contenu, $capsules[$plugin][$fond_capsule]);
+                }
+        }
+
+        return $contenu;
+}
+
+
 // -----------------------------------------------------------------------
 // ------------------------- BALISES CONTENEURS --------------------------

_plugins_/n-core/trunk/paquet.xml

@@ -2 +2 @@
         prefix="ncore"
         categorie="outil"
-        version="0.4.11"
+        version="0.5.0"
         etat="dev"
         compatibilite="[3.2.0;3.2.*]"

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

@@ -39 +39 @@
         $type_noisette = champ_sql('type_noisette', $p);
         $parametres = champ_sql('parametres', $p);
+        $balise = champ_sql('balise', $p);
+        $css = champ_sql('css', $p);
         $plugin = champ_sql('plugin', $p);
 
@@ -54 +56 @@
                 \".var_export(array('ajax'=>(type_noisette_ajaxifier($plugin, $type_noisette, $stockage))),true).\"
         );?>\"";
-        $inclusion_statique = "recuperer_fond(
-                type_noisette_localiser($plugin, $type_noisette),
-                array_merge(unserialize($parametres), noisette_contextualiser($plugin, $noisette, $type_noisette, $environnement, $stockage)),
-                array('ajax'=>(type_noisette_ajaxifier($plugin, $type_noisette, $stockage)))
+        $inclusion_statique = "noisette_encapsuler(
+                $plugin,
+                recuperer_fond(
+                        type_noisette_localiser($plugin, $type_noisette),
+                        array_merge(unserialize($parametres), noisette_contextualiser($plugin, $noisette, $type_noisette, $environnement, $stockage)),
+                        array('ajax'=>(type_noisette_ajaxifier($plugin, $type_noisette, $stockage)))
+                ),
+                $balise,
+                $css,
+                $type_noisette,
+                $stockage
         )";
         $code = "((type_noisette_dynamiser($plugin, $type_noisette, $stockage)) ? $inclusion_dynamique : $inclusion_statique)";