xref: /plugin/catmenu/README (revision 6983cdfd4483215ff5a1e573925c9c612964e790)
1*6983cdfdSLORTET# CatMenu
2*6983cdfdSLORTET
3*6983cdfdSLORTET`catmenu` affiche un menu arborescent (pages + sous-dossiers) pour un namespace DokuWiki.
4*6983cdfdSLORTET
5*6983cdfdSLORTET## Syntaxe
6*6983cdfdSLORTET
7*6983cdfdSLORTET```text
8*6983cdfdSLORTET{{catmenu>namespace}}
9*6983cdfdSLORTET```
10*6983cdfdSLORTET
11*6983cdfdSLORTETExemples :
12*6983cdfdSLORTET
13*6983cdfdSLORTET```text
14*6983cdfdSLORTET{{catmenu>.}}
15*6983cdfdSLORTET{{catmenu>wiki}}
16*6983cdfdSLORTET{{catmenu>docs:projet}}
17*6983cdfdSLORTET```
18*6983cdfdSLORTET
19*6983cdfdSLORTET- `.` : utilise le namespace courant.
20*6983cdfdSLORTET- `namespace` : utilise le namespace indiqué.
21*6983cdfdSLORTET
22*6983cdfdSLORTET## Comportement
23*6983cdfdSLORTET
24*6983cdfdSLORTET- liste les pages et sous-dossiers accessibles en lecture.
25*6983cdfdSLORTET- ouvre automatiquement la branche correspondant à la page courante.
26*6983cdfdSLORTET- gère les pages d'accueil de namespace (`$conf['start']`).
27*6983cdfdSLORTET- masque les pages sans titre H1 si `skip_page_without_title` est activé.
28*6983cdfdSLORTET
29*6983cdfdSLORTET## Configuration
30*6983cdfdSLORTET
31*6983cdfdSLORTETDans le gestionnaire de configuration :
32*6983cdfdSLORTET
33*6983cdfdSLORTET- `skip_file` : regex pour ignorer certains IDs de page.
34*6983cdfdSLORTET- `skip_page_without_title` : ignorer les pages sans H1.
35*6983cdfdSLORTET- `show_in_editor_menu` : afficher le bouton d'insertion dans l'éditeur.
36*6983cdfdSLORTET
37*6983cdfdSLORTET## Compatibilité
38*6983cdfdSLORTET
39*6983cdfdSLORTET- Compatible avec le plugin [ProseMirror](https://www.dokuwiki.org/plugin:prosemirror)
40*6983cdfdSLORTET- `catmenu` utilise le plugin [pagesicon](https://www.dokuwiki.org/plugin:pagesicon) pour afficher les icônes, si `pagesicon` est disponible.
41*6983cdfdSLORTET
42*6983cdfdSLORTET## Menu contextuel
43*6983cdfdSLORTET
44*6983cdfdSLORTETClic droit sur un item :
45*6983cdfdSLORTET
46*6983cdfdSLORTET- créer une nouvelle page (selon droits),
47*6983cdfdSLORTET- recharger le cache (`purge=true`),
48*6983cdfdSLORTET- ouvrir le gestionnaire de médias,
49*6983cdfdSLORTET- ouvrir la gestion d'icône (`pagesicon`) si disponible,
50*6983cdfdSLORTET- copier l'URL.
51*6983cdfdSLORTET
52*6983cdfdSLORTET## Permissions
53*6983cdfdSLORTET
54*6983cdfdSLORTETLe rendu respecte les ACL DokuWiki :
55*6983cdfdSLORTET
56*6983cdfdSLORTET- lecture minimale pour afficher un item,
57*6983cdfdSLORTET- actions contextuelles limitées selon les droits (create/edit/upload).
58