xref: /plugin/catmenu/README (revision aa591c9040aa9d58df44eaf65df693766613dc9f)
16983cdfdSLORTET# CatMenu
26983cdfdSLORTET
36983cdfdSLORTET`catmenu` affiche un menu arborescent (pages + sous-dossiers) pour un namespace DokuWiki.
46983cdfdSLORTET
56983cdfdSLORTET## Syntaxe
66983cdfdSLORTET
76983cdfdSLORTET```text
86983cdfdSLORTET{{catmenu>namespace}}
96983cdfdSLORTET```
106983cdfdSLORTET
116983cdfdSLORTETExemples :
126983cdfdSLORTET
136983cdfdSLORTET```text
146983cdfdSLORTET{{catmenu>.}}
156983cdfdSLORTET{{catmenu>wiki}}
166983cdfdSLORTET{{catmenu>docs:projet}}
176983cdfdSLORTET```
186983cdfdSLORTET
196983cdfdSLORTET- `.` : utilise le namespace courant.
206983cdfdSLORTET- `namespace` : utilise le namespace indiqué.
216983cdfdSLORTET
226983cdfdSLORTET## Comportement
236983cdfdSLORTET
246983cdfdSLORTET- liste les pages et sous-dossiers accessibles en lecture.
256983cdfdSLORTET- ouvre automatiquement la branche correspondant à la page courante.
266983cdfdSLORTET- gère les pages d'accueil de namespace (`$conf['start']`).
276983cdfdSLORTET- masque les pages sans titre H1 si `skip_page_without_title` est activé.
286983cdfdSLORTET
296983cdfdSLORTET## Configuration
306983cdfdSLORTET
316983cdfdSLORTETDans le gestionnaire de configuration :
326983cdfdSLORTET
33*aa591c90SLORTET- `skip_file` : regex pour ignorer certains IDs de page. Accepte aussi la valeur spéciale `@hidepages` pour réutiliser automatiquement le paramètre `hidepages` de DokuWiki.
346983cdfdSLORTET- `skip_page_without_title` : ignorer les pages sans H1.
356983cdfdSLORTET- `show_in_editor_menu` : afficher le bouton d'insertion dans l'éditeur.
36*aa591c90SLORTET- `context_menu_items` : cases à cocher pour choisir les actions disponibles dans le menu contextuel (clic droit). Toutes activées par défaut.
37*aa591c90SLORTET- `footer_content` : DokuCode multiligne injecté à la fin de chaque menu (liens, notes, etc.). Vide par défaut.
386983cdfdSLORTET
396983cdfdSLORTET## Compatibilité
406983cdfdSLORTET
416983cdfdSLORTET- Compatible avec le plugin [ProseMirror](https://www.dokuwiki.org/plugin:prosemirror)
42*aa591c90SLORTET- `catmenu` utilise le plugin [pagesicon](https://www.dokuwiki.org/plugin:pagesicon) pour afficher les icônes, si disponible. L'action "Gérer l'icône" dans le menu contextuel n'apparaît que si pagesicon est installé.
43*aa591c90SLORTET- Compatible avec le plugin `newpagefill` pour la création de pages. S'il est présent, `catmenu` utilise son assistant de création.
446983cdfdSLORTET
456983cdfdSLORTET## Menu contextuel
466983cdfdSLORTET
47*aa591c90SLORTETClic droit sur un item (actions configurables individuellement) :
486983cdfdSLORTET
496983cdfdSLORTET- créer une nouvelle page (selon droits),
506983cdfdSLORTET- recharger le cache (`purge=true`),
516983cdfdSLORTET- ouvrir le gestionnaire de médias,
526983cdfdSLORTET- ouvrir la gestion d'icône (`pagesicon`) si disponible,
536983cdfdSLORTET- copier l'URL.
546983cdfdSLORTET
556983cdfdSLORTET## Permissions
566983cdfdSLORTET
576983cdfdSLORTETLe rendu respecte les ACL DokuWiki :
586983cdfdSLORTET
596983cdfdSLORTET- lecture minimale pour afficher un item,
606983cdfdSLORTET- actions contextuelles limitées selon les droits (create/edit/upload).
61