xref: /plugin/catmenu/DOKU (revision 339ba49c4f5b2a42161c07b899707ee1625d260f)
16983cdfdSLORTET====== CatMenu Plugin ======
26983cdfdSLORTET
36983cdfdSLORTET---- plugin ----
46983cdfdSLORTETdescription: Affiche un menu arborescent de namespace
56983cdfdSLORTETauthor     : Valentin LORTET
6aa591c90SLORTETemail      : contact@valentinlortet.fr
76983cdfdSLORTETtype       : Syntax, Action
8aa591c90SLORTETlastupdate : 2026-03-14
96983cdfdSLORTETcompatible : Librarian
106983cdfdSLORTETdepends    :
116983cdfdSLORTETconflicts  :
126983cdfdSLORTETsimilar    :
136983cdfdSLORTETtags       : Navigation, Menu, Namespace, ProseMirror
146983cdfdSLORTET
15aa591c90SLORTETdownloadurl: https://github.com/Lortet/dokuwiki-plugin-catmenu/zipball/master
16aa591c90SLORTETbugtracker : https://github.com/Lortet/dokuwiki-plugin-catmenu/issues
17aa591c90SLORTETsourcerepo : https://github.com/Lortet/dokuwiki-plugin-catmenu/
186983cdfdSLORTETdonationurl:
196983cdfdSLORTETscreenshot_img :
206983cdfdSLORTET----
216983cdfdSLORTET
22*339ba49cSLORTET���� **Français** | [[plugin:catmenu|���� English]] | [[de:plugin:catmenu|���� Deutsch]] | [[es:plugin:catmenu|���� Español]]
23*339ba49cSLORTET
246983cdfdSLORTET===== Installation =====
256983cdfdSLORTET
266983cdfdSLORTETInstaller le plugin depuis le [[fr:plugin:extension|Gestionnaire d'extensions]].
276983cdfdSLORTET
286983cdfdSLORTET===== Description =====
296983cdfdSLORTET
306983cdfdSLORTETLe plugin **catmenu** permet :
316983cdfdSLORTET  * d'afficher un menu arborescent (pages + sous-dossiers) pour un namespace ;
326983cdfdSLORTET  * d'ouvrir automatiquement la branche correspondant à la page courante ;
336983cdfdSLORTET  * de gérer les pages d'accueil de namespace (''$conf['start']'') ;
34aa591c90SLORTET  * de proposer un menu contextuel d'actions configurable (selon permissions) ;
35aa591c90SLORTET  * d'injecter du DokuCode personnalisé en pied de menu.
366983cdfdSLORTET
376983cdfdSLORTET===== Syntaxe =====
386983cdfdSLORTET
396983cdfdSLORTETUtilisation :
406983cdfdSLORTET  * ''{{catmenu>namespace}}''
416983cdfdSLORTET
426983cdfdSLORTETExemples :
436983cdfdSLORTET  * ''{{catmenu>.}}'' (namespace courant)
446983cdfdSLORTET  * ''{{catmenu>wiki}}''
456983cdfdSLORTET  * ''{{catmenu>docs:projet}}''
466983cdfdSLORTET
476983cdfdSLORTET===== Paramètres =====
486983cdfdSLORTET
496983cdfdSLORTET^ Nom ^ Description ^ Valeur par défaut ^
50aa591c90SLORTET| skip_file | Regex pour ignorer des IDs de page. Accepte aussi ''@hidepages'' pour réutiliser le paramètre ''hidepages'' de DokuWiki. | '''' |
516983cdfdSLORTET| skip_page_without_title | Ignorer les pages sans titre H1. | ''true'' |
526983cdfdSLORTET| show_in_editor_menu | Afficher le bouton d'insertion dans l'éditeur. | ''true'' |
53aa591c90SLORTET| context_menu_items | Actions disponibles dans le menu contextuel (cases à cocher). | toutes activées |
54aa591c90SLORTET| footer_content | DokuCode multiligne injecté à la fin de chaque menu. | '''' |
556983cdfdSLORTET
566983cdfdSLORTET===== Compatibilité =====
576983cdfdSLORTET
586983cdfdSLORTET  * Compatible avec [[https://www.dokuwiki.org/plugin:prosemirror|ProseMirror]]
59aa591c90SLORTET  * Utilise [[https://www.dokuwiki.org/plugin:pagesicon|pagesicon]] pour afficher les icônes quand disponible. L'action "Gérer l'icône" dans le menu contextuel n'apparaît que si ''pagesicon'' est installé.
60aa591c90SLORTET  * Compatible avec le plugin ''newpagefill'' pour la création de pages. S'il est présent, ''catmenu'' utilise son assistant de création.
616983cdfdSLORTET
626983cdfdSLORTET===== Menu contextuel =====
636983cdfdSLORTET
64aa591c90SLORTETClic droit sur un item du menu. Chaque action est activable/désactivable individuellement dans la configuration :
65aa591c90SLORTET  * **Créer une nouvelle page** (''newpage'') — si autorisé ;
66aa591c90SLORTET  * **Recharger le cache** (''reload'') — (''purge=true'') ;
67aa591c90SLORTET  * **Gérer les médias** (''medias'') — ouvre le gestionnaire de médias ;
68aa591c90SLORTET  * **Gérer l'icône** (''pagesicon'') — uniquement si ''pagesicon'' est installé ;
69aa591c90SLORTET  * **Copier l'URL** (''url'').
70aa591c90SLORTET
71aa591c90SLORTET===== Footer DokuCode =====
72aa591c90SLORTET
73aa591c90SLORTETLe paramètre ''footer_content'' accepte du markup DokuWiki multiligne. Il est rendu en HTML et injecté dans un bloc ''<div class="catmenu-footer">'' sous chaque menu. Utile pour ajouter des liens permanents, des notes ou des raccourcis.
746983cdfdSLORTET
756983cdfdSLORTET===== Permissions =====
766983cdfdSLORTET
776983cdfdSLORTETLe rendu respecte les ACL DokuWiki :
786983cdfdSLORTET  * lecture minimale pour afficher un item ;
796983cdfdSLORTET  * actions contextuelles limitées selon les droits (create/edit/upload).
80