xref: /plugin/prioritylist/syntax.php (revision 6fe0a679084f1130d38e48fbd32c561839ce660f)

<?php

if(!defined('DOKU_INC')) die();

class syntax_plugin_prioritylist extends DokuWiki_Syntax_Plugin {

    function getType() { return 'substition'; }
    function getPType() { return 'block'; }
    function getSort() { return 150; }

    function connectTo($mode) {
        $this->Lexer->addSpecialPattern('<prioritylist.*?>', $mode, 'plugin_prioritylist');
    }

    function handle($match, $state, $pos, Doku_Handler $handler) {
        $match = substr($match, 13, -2);
        $args = explode(' ', $match);
        $data = array(
            'ns' => 'billets',
            'limit' => 0
        );

        foreach($args as $arg) {
            $arg = trim($arg);
            if(empty($arg)) continue;
            if(strpos($arg, '=') !== false) {
                list($key, $val) = explode('=', $arg, 2);
                $key = trim($key);
                $val = trim($val);
                if($key == 'ns') $data['ns'] = $val;
                if($key == 'limit') $data['limit'] = (int)$val;
            }
        }
        return $data;
    }

    function render($format, Doku_Renderer $renderer, $data) {
        if ($format != 'xhtml') return false;

        // 1. Récupération DYNAMIQUE du répertoire de données
        global $conf;
        $savedir = $conf['savedir'];
        $savedir = rtrim(ltrim($savedir, './'), '/');
        $dataDir = DOKU_INC . $savedir . '/pages';

        $ns = rtrim($data['ns'], ':');
        $limit = $data['limit'];

        $pages = array();
        $scanPath = $dataDir . '/' . str_replace(':', '/', $ns);

        if (!is_dir($scanPath)) {
            $renderer->doc .= '<div style="border:1px solid red; padding:10px; background:#ffe0e0;">';
            $renderer->doc .= '<strong>Erreur :</strong> Le dossier <code>' . hsc($scanPath) . '</code> n\'existe pas.<br>';
            $renderer->doc .= 'Chemin détecté : ' . hsc($savedir) . '/pages/' . hsc($ns);
            $renderer->doc .= '</div>';
            return true;
        }

        // 2. Récupération des pages (Native + Fallback)
        search($pages, $dataDir, 'search_allpages', array('ns' => $ns), $ns);
        if (empty($pages)) {
            $this->scanDirectoryRecursive($scanPath, $ns, $pages);
        }

        $filteredPages = array();
        $totalCount = count($pages);

        foreach ($pages as $page) {
            $id = $page['id'];
            $file = wikiFN($id);

            if (!file_exists($file)) continue;

            // Lecture élargie (8ko) pour capturer le titre ET les tags potentiellement plus bas
            $content = file_get_contents($file, false, null, 0, 8192);
            if ($content === false) continue;

            // A. Vérification du titre (+, ++, +++)
            if (!preg_match('/^======\s*(\+{1,3}.*?)\s*======/m', $content, $titleMatches)) {
                continue;
            }
            $title = trim($titleMatches[1]);

            // B. Extraction des Tags
            $tags = $this->extractTags($id, $content);

            $filteredPages[] = array(
                'id' => $id,
                'title' => $title,
                'tags' => $tags,
                'mtime' => $page['mtime']
            );
        }

        // Tri antéchronologique
        usort($filteredPages, function($a, $b) {
            return $b['mtime'] - $a['mtime'];
        });

        if ($limit > 0) {
            $filteredPages = array_slice($filteredPages, 0, $limit);
        }

        // Affichage
        if (empty($filteredPages)) {
            $renderer->doc .= '<p>Aucun billet prioritaire trouvé dans <code>' . hsc($ns) . '</code>.</p>';
            $renderer->doc .= '<p><small>Pages scannées : ' . $totalCount . '</small></p>';
            return true;
        }

        $renderer->doc .= '<div class="plugin_prioritylist">';
        $renderer->doc .= '<h3>' . count($filteredPages) . ' billet(s) prioritaire(s)</h3>';
        $renderer->doc .= '<ul>';

        foreach ($filteredPages as $p) {
            $date = date('d.m.Y', $p['mtime']);
            $link = wl($p['id']);
            $titleHtml = hsc($p['title']);

            // Formatage des tags
            $tagsHtml = '';
            if (!empty($p['tags'])) {
                $tagsList = array_map('hsc', $p['tags']);
                $tagsHtml = ' <span style="color:#555; font-size:0.85em;">(' . implode('; ', $tagsList) . ')</span>';
            }

            $renderer->doc .= '<li class="priority-item" style="margin-bottom: 0.5em; list-style-type: none;">';
            #$renderer->doc .= '<span class="priority-date" style="color: #666; font-size: 0.9em;">[' . $date . ']</span> ';
            $renderer->doc .= '<a href="' . $link . '" class="wikilink" style="font-weight:bold;">' . $titleHtml . '</a>';
            $renderer->doc .= $tagsHtml;
            $renderer->doc .= '</li>';
        }

        $renderer->doc .= '</ul>';
        $renderer->doc .= '</div>';

        return true;
    }

    /**
     * Extrait les tags du contenu ou via l'API metadata de DokuWiki
     */
    function extractTags($id, $content) {
        // Méthode 1 : Essayer d'utiliser l'API metadata de DokuWiki (si le plugin Tag est installé et actif)
        // On utilise ft_getMetaTags qui est la fonction standard pour récupérer les tags parsed.
        if (function_exists('ft_getMetaTags')) {
            $metaTags = ft_getMetaTags($id);
            if (!empty($metaTags)) {
                // ft_getMetaTags retourne souvent un tableau associatif [tag => count] ou similaire selon la version
                // On veut juste les noms des tags
                $tags = array();
                foreach ($metaTags as $tag => $count) {
                    // Si le tableau est [tag => count], la clé est le nom.
                    // Si c'est [0 => ['tag' => name, 'count' => 1]], on adapte.
                    if (is_int($tag)) {
                         // Cas tableau indexé
                         if (isset($count['tag'])) $tags[] = $count['tag'];
                    } else {
                        // Cas tableau associatif direct
                        $tags[] = $tag;
                    }
                }
                if (!empty($tags)) return $tags;
            }
        }

        // Méthode 2 : Fallback par Regex sur le contenu brut si l'API ne donne rien
        // Cherche {{tag>tag1 tag2}} ou {{tag>tag1}}
        $tags = array();
        if (preg_match_all('/\{\{tag>([^}]+)\}\}/i', $content, $matches)) {
            foreach ($matches[1] as $tagBlock) {
                // Les tags peuvent être séparés par des espaces dans le bloc {{tag>...}}
                $parts = preg_split('/\s+/', trim($tagBlock));
                foreach ($parts as $part) {
                    $part = trim($part);
                    if (!empty($part) && !in_array($part, $tags)) {
                        $tags[] = $part;
                    }
                }
            }
        }
        return $tags;
    }

    // Scanner manuel récursif
    function scanDirectoryRecursive($path, $nsPrefix, &$result) {
        if (!is_dir($path)) return;
        $files = array_diff(scandir($path), array('.', '..', '_media', '_cache'));

        foreach ($files as $file) {
            $fullPath = $path . '/' . $file;
            if (is_dir($fullPath)) {
                $newNs = $nsPrefix ? $nsPrefix . ':' . $file : $file;
                $this->scanDirectoryRecursive($fullPath, $newNs, $result);
            } elseif (substr($file, -4) == '.txt') {
                $pageId = $nsPrefix ? $nsPrefix . ':' . substr($file, 0, -4) : substr($file, 0, -4);
                $result[] = array(
                    'id' => $pageId,
                    'mtime' => filemtime($fullPath)
                );
            }
        }
    }
}