Changeset 74904 in spip-zone

Timestamp:

Aug 23, 2013, 11:04:18 AM (6 years ago)

Author:

marcimat@…

Message:

La liste des éléments SPIP des plugins (ie. balises > onglet plugins) est triée par répertoire de plugin.

Location:

_galaxie_/code.spip.net/autodoc/trunk

Files:

• src/autodoc/Plugin/Core/TwigZora.php (modified) (5 diffs)
• templates/zora/content/sommaire.twig (modified) (2 diffs)
• templates/zora/inclure/liste/spiperies_with_tabs.twig (modified) (1 diff)

_galaxie_/code.spip.net/autodoc/trunk/src/autodoc/Plugin/Core/TwigZora.php

@@ -131 +131 @@
              *
              * @param array $context
-             *     Contexte du template
+             *     Contexte du template (transmis automatiquement par twig)
              * @return bool
              *     true si c'est un SPIP.
@@ -162 +162 @@
              *     )
              * 
-             * @param Collection $collection|null
+             * @param Collection|null $collection
              *     Liste d'éléments de phpDocumentor
              * @param string $tri
@@ -241 +241 @@
             ),
             /**
+             * Liste les différents plugins contenus dans une collection
+             *
+             * @param array $context
+             *     Contexte du template (transmis automatiquement par twig)
+             * @param Collection|null $collection
+             * @return Collection nom du répertoire => description du répertoire
+            **/
+            'lister_plugins' => new \Twig_SimpleFilter('lister_plugins',
+                function ($context, $collection) {
+                    if (!is_object($collection)) {
+                        return new Collection();
+                    }
+                    $selection = new Collection();
+                    foreach ($collection as $element) {
+                        $path = $element->getPath();
+                        $path = explode('/', $path, 3);
+                        $start = array_shift($path);
+                        if (in_array($start , array('plugins-dist', 'plugins'))) {
+                            $plugin = array_shift($path);
+                            if (!$selection->get($plugin)) {
+                                $fqsens = $context['project']->getIndexes()->get('elements');
+                                // identifiant unique de répertoire, pour retrouver sa description
+                                $fqsen = './' . $start . '/' . $plugin . '/';
+                                $selection->set($plugin, $fqsens->get($fqsen));
+                            }
+                        }
+
+                    }
+                    return $selection;
+                }, array('needs_context' => true)
+            ),
+            /**
+             * Retrouve le nom du répertoire contenant un plugin
+             *
+             * Si un path est inclu dans plugins-dist ou plugins,
+             * on considère que le répertoire suivant est un nom
+             * de répertoire de plugin.
+             *
+             * @example
+             *     file|repertoire_de_plugin
+             * 
+             * @param Object $element
+             *     Élément de phpDocumentor
+             * @return string
+             *     Nom du répertoire, sinon vide.
+             */
+            'repertoire_de_plugin' => new \Twig_SimpleFilter('selectionner_fichiers_dans',
+                function ($element) {
+                    if ($path = $element->getPath()) {
+                        $path = explode('/', $path, 3);
+                        $start = array_shift($chemin);
+                        if (in_array($start , array('plugins-dist', 'plugins'))) {
+                            return array_shift($path);
+                        }
+                    }
+                    return '';
+                }
+            ),
+            /**
              * Sélectionne les fonctions d'une collection de fonctions
              * dont les fichiers ont un chemin commençant par l'argument transmis
@@ -247 +306 @@
              *     elements|selectionner_fichiers_dans('plugins-dist')
              * 
-             * @param Collection $collection|null
+             * @param Collection|null $collection
              *     Liste d'éléments de phpDocumentor
              * @param string $debut
@@ -279 +338 @@
              *     elements|selectionner_fichiers_hors('plugins-dist')
              * 
-             * @param Collection $collection|null
+             * @param Collection|null $collection
              *     Liste d'éléments de phpDocumentor
              * @param string $debut

_galaxie_/code.spip.net/autodoc/trunk/templates/zora/content/sommaire.twig

@@ -20 +20 @@
 
 {% set elements = [ 
-        {'type': 'balise',   'nom': 'Balises',   'elements': project.indexes.spip.balises},
-        {'type': 'filtre',   'nom': 'Filtres',   'elements': project.indexes.spip.filtres},
-        {'type': 'critere',  'nom': 'Critères',  'elements': project.indexes.spip.criteres},
-        {'type': 'boucle',   'nom': 'Boucles',   'elements': project.indexes.spip.boucles},
-        {'type': 'pipeline', 'nom': 'Pipelines', 'elements': project.indexes.spip.pipelines},
+        {'type': 'balise',   'nom': 'Balises',   'elements': project.indexes.spip.balises|trier('name')},
+        {'type': 'filtre',   'nom': 'Filtres',   'elements': project.indexes.spip.filtres|trier('name')},
+        {'type': 'critere',  'nom': 'Critères',  'elements': project.indexes.spip.criteres|trier('name')},
+        {'type': 'boucle',   'nom': 'Boucles',   'elements': project.indexes.spip.boucles|trier('name')},
+        {'type': 'pipeline', 'nom': 'Pipelines', 'elements': project.indexes.spip.pipelines|trier('tags.pipeline.0.description', 'getFullyQualifiedStructuralElementName')},
 ] %}
 
@@ -32 +32 @@
                         <h3>{{ e.nom }}</h3>
                         <ul class='colonnes'>
-                                {% for function in e.elements|trier('name') %}
+                                {% for function in e.elements %}
                                         {% if not function.tags['deprecated'].count %}
                                                 <li

_galaxie_/code.spip.net/autodoc/trunk/templates/zora/inclure/liste/spiperies_with_tabs.twig

@@ -24 +24 @@
                 </div>
                 <div class="tab-pane" id="{{ type }}_plug">
-                        {% include 'inclure/liste/spiperies.twig' with {'elements' : elements_plug, 'forcer_liste' : true} %}
+                        {% for plugin, directory in elements_plug|lister_plugins %}
+                                <h3>{{ plugin }}</h3>
+                                {% include 'inclure/liste/spiperies.twig' with {
+                                        'elements' : elements_plug|selectionner_fichiers_dans( directory.path ),
+                                        'forcer_liste' : true}
+                                %}
+                        {% endfor %}
                 </div>
         </div>