action.php

<?php
/**
 * @license    GPL 2 (http://www.gnu.org/licenses/gpl.html)
 * @author     Votrenom
 * 
 * Plugin DokuWiki pour afficher un logo par namespace
 * Fonctionnalités :
 * - Support de multiples formats (png, jpg, jpeg, gif, svg)
 * - Fallback hiérarchique (cherche dans les namespaces parents)
 * - Fallback vers le logo global si aucun logo trouvé
 */
 
class action_plugin_namespacelogo extends DokuWiki_Action_Plugin {
 
    /**
     * Formats d'images supportés (ordre de priorité)
     */
    protected $supportedFormats = ['logo.png', 'logo.jpg', 'logo.jpeg', 'logo.gif', 'logo.svg'];
 
    /**
     * Enregistrer les hooks
     */
    public function register(Doku_Event_Handler $controller) {
        // Intercepter le rendu de l'en-tête du template
        $controller->register_hook('TPL_HEADER_OUTPUT', 'BEFORE', $this, '_injectNamespaceLogo');
    }
 
    /**
     * Injecter le logo du namespace dans l'en-tête
     */
    public function _injectNamespaceLogo(Doku_Event $event, $param) {
        global $ID;
 
        // Récupérer le namespace actuel
        $ns = getNS($ID);
 
        // Trouver le chemin du logo (avec fallback hiérarchique)
        $logoPath = $this->_findLogoPath($ns);
 
        if ($logoPath) {
            // Générer l'URL de l'image
            $imgUrl = ml($logoPath);
 
            // Créer le HTML du logo
            $logoHtml = '<div class="ns-logo-container">' .
                        '<img src="' . $imgUrl . '" ' .
                        'alt="Logo ' . hsc($this->_extractNamespaceFromPath($logoPath)) . '" ' .
                        'class="ns-logo" ' .
                        'id="namespace-logo" />' .
                        '</div>';
 
            // Ajouter à la variable globale que le template pourra utiliser
            $GLOBALS['NS_LOGO_HTML'] = $logoHtml;
        }
    }
 
    /**
     * Trouver le chemin du logo avec fallback hiérarchique
     * @param string $ns Namespace de départ
     * @return string|null Chemin du logo ou null si aucun trouvé
     */
    protected function _findLogoPath($ns) {
        // Liste des namespaces à vérifier (du plus spécifique au plus général)
        $namespacesToCheck = $this->_buildNamespaceHierarchy($ns);
 
        // Vérifier chaque namespace dans l'ordre
        foreach ($namespacesToCheck as $checkNs) {
            foreach ($this->supportedFormats as $format) {
                $path = ':' . $checkNs . ':' . $format;
 
                if (@media_exists($path)) {
                    return $path;
                }
            }
        }
 
        return null;
    }
 
    /**
     * Construire la hiérarchie des namespaces pour le fallback
     * Ex: 'a:b:c' -> ['a:b:c', 'a:b', 'a', '']
     * @param string $ns Namespace de départ
     * @return array Liste des namespaces à vérifier
     */
    protected function _buildNamespaceHierarchy($ns) {
        $hierarchy = [];
 
        // Ajouter le namespace actuel
        if (!empty($ns)) {
            $hierarchy[] = $ns;
        }
 
        // Remonter dans la hiérarchie
        $parts = explode(':', $ns);
        while (count($parts) > 1) {
            array_pop($parts);
            $parentNs = implode(':', $parts);
            if (!empty($parentNs)) {
                $hierarchy[] = $parentNs;
            }
        }
 
        // Ajouter la racine (vide) pour le fallback global
        $hierarchy[] = '';
 
        return $hierarchy;
    }
 
    /**
     * Extraire le namespace du chemin du logo pour l'attribut alt
     * @param string $path Chemin du logo (ex: ':a:b:logo.png')
     * @return string Nom du namespace
     */
    protected function _extractNamespaceFromPath($path) {
        // Supprimer les deux-points initiaux et le nom du fichier
        $cleanPath = trim($path, ':');
        $parts = explode(':', $cleanPath);
 
        // Retirer le dernier élément (logo.png, etc.)
        array_pop($parts);
 
        return implode(' : ', $parts);
    }
}
?>