1*6983cdfdSLORTET====== CatMenu Plugin ====== 2*6983cdfdSLORTET 3*6983cdfdSLORTET---- plugin ---- 4*6983cdfdSLORTETdescription: Affiche un menu arborescent de namespace 5*6983cdfdSLORTETauthor : Valentin LORTET 6*6983cdfdSLORTETemail : contact@lortet.fr 7*6983cdfdSLORTETtype : Syntax, Action 8*6983cdfdSLORTETlastupdate : 2026-03-09 9*6983cdfdSLORTETcompatible : Librarian 10*6983cdfdSLORTETdepends : 11*6983cdfdSLORTETconflicts : 12*6983cdfdSLORTETsimilar : 13*6983cdfdSLORTETtags : Navigation, Menu, Namespace, ProseMirror 14*6983cdfdSLORTET 15*6983cdfdSLORTETdownloadurl: 16*6983cdfdSLORTETbugtracker : 17*6983cdfdSLORTETsourcerepo : 18*6983cdfdSLORTETdonationurl: 19*6983cdfdSLORTETscreenshot_img : 20*6983cdfdSLORTET---- 21*6983cdfdSLORTET 22*6983cdfdSLORTET===== Installation ===== 23*6983cdfdSLORTET 24*6983cdfdSLORTETInstaller le plugin depuis le [[fr:plugin:extension|Gestionnaire d'extensions]]. 25*6983cdfdSLORTET 26*6983cdfdSLORTET===== Description ===== 27*6983cdfdSLORTET 28*6983cdfdSLORTETLe plugin **catmenu** permet : 29*6983cdfdSLORTET * d'afficher un menu arborescent (pages + sous-dossiers) pour un namespace ; 30*6983cdfdSLORTET * d'ouvrir automatiquement la branche correspondant à la page courante ; 31*6983cdfdSLORTET * de gérer les pages d'accueil de namespace (''$conf['start']'') ; 32*6983cdfdSLORTET * de proposer un menu contextuel d'actions (selon permissions). 33*6983cdfdSLORTET 34*6983cdfdSLORTET===== Syntaxe ===== 35*6983cdfdSLORTET 36*6983cdfdSLORTETUtilisation : 37*6983cdfdSLORTET * ''{{catmenu>namespace}}'' 38*6983cdfdSLORTET 39*6983cdfdSLORTETExemples : 40*6983cdfdSLORTET * ''{{catmenu>.}}'' (namespace courant) 41*6983cdfdSLORTET * ''{{catmenu>wiki}}'' 42*6983cdfdSLORTET * ''{{catmenu>docs:projet}}'' 43*6983cdfdSLORTET 44*6983cdfdSLORTET===== Paramètres ===== 45*6983cdfdSLORTET 46*6983cdfdSLORTET^ Nom ^ Description ^ Valeur par défaut ^ 47*6983cdfdSLORTET| skip_file | Regex pour ignorer des IDs de page. | '''' | 48*6983cdfdSLORTET| skip_page_without_title | Ignorer les pages sans titre H1. | ''true'' | 49*6983cdfdSLORTET| show_in_editor_menu | Afficher le bouton d'insertion dans l'éditeur. | ''true'' | 50*6983cdfdSLORTET 51*6983cdfdSLORTET===== Compatibilité ===== 52*6983cdfdSLORTET 53*6983cdfdSLORTET * Compatible avec [[https://www.dokuwiki.org/plugin:prosemirror|ProseMirror]] 54*6983cdfdSLORTET * Utilise [[https://www.dokuwiki.org/plugin:pagesicon|pagesicon]] pour afficher les icônes quand disponible. 55*6983cdfdSLORTET 56*6983cdfdSLORTET===== Icônes (pagesicon) ===== 57*6983cdfdSLORTET 58*6983cdfdSLORTETSi le helper ''pagesicon'' est installé : 59*6983cdfdSLORTET * récupération des icônes via l'API helper ; 60*6983cdfdSLORTET * fallback possible vers l'image par défaut ''pagesicon'' sur versions récentes ; 61*6983cdfdSLORTET * fallback legacy conservé pour anciennes signatures helper. 62*6983cdfdSLORTET 63*6983cdfdSLORTETSi aucune icône n'est trouvée, l'entrée est affichée sans image. 64*6983cdfdSLORTET 65*6983cdfdSLORTET===== Menu contextuel ===== 66*6983cdfdSLORTET 67*6983cdfdSLORTETClic droit sur un item du menu : 68*6983cdfdSLORTET * créer une nouvelle page (si autorisé) ; 69*6983cdfdSLORTET * recharger le cache (''purge=true'') ; 70*6983cdfdSLORTET * ouvrir le gestionnaire de médias ; 71*6983cdfdSLORTET * ouvrir la gestion d'icône (''pagesicon'') si disponible ; 72*6983cdfdSLORTET * copier l'URL. 73*6983cdfdSLORTET 74*6983cdfdSLORTET===== Permissions ===== 75*6983cdfdSLORTET 76*6983cdfdSLORTETLe rendu respecte les ACL DokuWiki : 77*6983cdfdSLORTET * lecture minimale pour afficher un item ; 78*6983cdfdSLORTET * actions contextuelles limitées selon les droits (create/edit/upload). 79